ssrwire 0.2.0 → 0.4.0

package/dist/types.d.ts

@@ -12,6 +12,10 @@ export type RobotsAudience = "robots" | "googlebot" | "bingbot";
 export interface RobotsSignal extends ElementSignal {
     readonly audience: RobotsAudience;
 }
+export type SocialMetadataProperty = "og:title" | "og:type" | "og:url" | "og:image" | "og:description" | "twitter:card" | "twitter:title" | "twitter:description" | "twitter:image";
+export interface SocialMetadataSignal extends ElementSignal {
+    readonly property: SocialMetadataProperty;
+}
 export interface JsonLdSignal extends TimingMark {
     readonly location: ElementLocation;
     readonly valid?: boolean;
@@ -26,6 +30,8 @@ export interface DocumentSignals {
     readonly descriptions: readonly ElementSignal[];
     readonly canonicals: readonly ElementSignal[];
     readonly robots: readonly RobotsSignal[];
+    /** Present on current probes; optional for low-level callers and older in-memory results. */
+    readonly socialMetadata?: readonly SocialMetadataSignal[];
     readonly h1s: readonly ElementSignal[];
     readonly firstMainText?: ElementSignal;
     readonly jsonLd: readonly JsonLdSignal[];
@@ -89,10 +95,16 @@ export interface TargetExpectations {
     readonly requireCanonical: boolean;
     readonly requireH1: boolean;
     readonly requireMainText: boolean;
+    /** Require the four Open Graph protocol basic metadata properties. Defaults to false. */
+    readonly requireOpenGraph?: boolean;
+    /** Require SSRWire's Twitter Card readiness contract. Defaults to false. */
+    readonly requireTwitterCard?: boolean;
     readonly maxFirstByteMs?: number;
     readonly maxCriticalMs?: number;
 }
 export interface AuditTarget {
+    /** Stable identity used to match the same target across reports with different origins. */
+    readonly id?: string;
     readonly url: string;
     readonly expectations: TargetExpectations;
 }
@@ -160,6 +172,8 @@ export interface AuditSummary {
     readonly incomplete: number;
 }
 export interface AuditResult {
+    /** Version of the persisted audit-report contract, independent of the package version. */
+    readonly schemaVersion: 1;
     readonly version: string;
     readonly generatedAt: string;
     readonly durationMs: number;
@@ -168,4 +182,82 @@ export interface AuditResult {
     readonly summary: AuditSummary;
 }
 export type ReportFormat = "terminal" | "json" | "sarif";
+export type ComparisonKind = "regression" | "fixed" | "changed";
+export type ComparisonScope = "target" | "agent" | "finding" | "response" | "metadata" | "timing";
+export interface ComparisonChange {
+    readonly kind: ComparisonKind;
+    readonly scope: ComparisonScope;
+    readonly code: string;
+    readonly message: string;
+    readonly agent?: string;
+    readonly field?: string;
+    readonly baseline?: string | number | boolean;
+    readonly candidate?: string | number | boolean;
+}
+export interface ComparisonTimelineEvent {
+    readonly key: string;
+    readonly label: string;
+    readonly medianMs: number;
+    readonly location?: ElementLocation | "mixed";
+    readonly observedByByte?: number;
+}
+export interface ComparisonTimelineSnapshot {
+    readonly samples: number;
+    readonly events: readonly ComparisonTimelineEvent[];
+}
+export interface ComparisonTimelineLane {
+    readonly agent: string;
+    readonly label: string;
+    readonly baseline?: ComparisonTimelineSnapshot;
+    readonly candidate?: ComparisonTimelineSnapshot;
+}
+export type TargetComparisonStatus = "matched" | "added" | "removed";
+export interface TargetComparison {
+    readonly key: string;
+    readonly id?: string;
+    readonly status: TargetComparisonStatus;
+    readonly baselineUrl?: string;
+    readonly candidateUrl?: string;
+    readonly changes: readonly ComparisonChange[];
+    readonly timelines: readonly ComparisonTimelineLane[];
+}
+export interface AuditReportDescriptor {
+    readonly label: string;
+    readonly version: string;
+    readonly schemaVersion: 1;
+    readonly generatedAt: string;
+    readonly repeat: number;
+}
+export interface ComparisonThresholds {
+    readonly timingRegressionMs: number;
+    readonly timingRegressionPercent: number;
+}
+export interface ComparisonSummary {
+    readonly targets: number;
+    readonly matchedTargets: number;
+    readonly addedTargets: number;
+    readonly removedTargets: number;
+    readonly unchangedTargets: number;
+    readonly regressions: number;
+    readonly fixed: number;
+    readonly changed: number;
+}
+export interface AuditComparison {
+    readonly schemaVersion: 1;
+    readonly kind: "comparison";
+    readonly version: string;
+    readonly generatedAt: string;
+    readonly baseline: AuditReportDescriptor;
+    readonly candidate: AuditReportDescriptor;
+    readonly thresholds: ComparisonThresholds;
+    readonly results: readonly TargetComparison[];
+    readonly summary: ComparisonSummary;
+}
+export interface CompareAuditOptions {
+    readonly baselineLabel?: string;
+    readonly candidateLabel?: string;
+    readonly timingRegressionMs?: number;
+    readonly timingRegressionPercent?: number;
+}
+export type ComparisonReportFormat = "terminal" | "json" | "html";
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/examples/github-actions.yml

@@ -27,7 +27,7 @@ jobs:
         if: github.event_name == 'pull_request'
         continue-on-error: true
         run: >-
-          npx --yes ssrwire@0.2.0 check
+          npx --yes ssrwire@0.4.0 check
           --config ssrwire.config.yml
           --format sarif
           --output reports/ssrwire.sarif
@@ -38,7 +38,7 @@ jobs:
         if: github.event_name != 'pull_request'
         continue-on-error: true
         run: >-
-          npx --yes ssrwire@0.2.0 check
+          npx --yes ssrwire@0.4.0 check
           --config ssrwire.config.yml
           --format sarif
           --output reports/ssrwire.sarif

package/examples/ssrwire.config.yml

@@ -1,6 +1,7 @@
 # Replace these URLs with a small set of high-value SSR routes.
 targets:
-  - url: https://example.com/
+  - id: home
+    url: https://example.com/
     expectedStatus: 200
     expectedFinalUrl: https://example.com/
     require:
@@ -9,8 +10,11 @@ targets:
       canonical: true
       h1: true
       mainText: true
+      openGraph: true
+      twitterCard: true
 
-  - url: https://example.com/pricing/
+  - id: pricing
+    url: https://example.com/pricing/
     expectedStatus: 200
     require:
       title: true
@@ -18,6 +22,8 @@ targets:
       canonical: true
       h1: true
       mainText: true
+      openGraph: false
+      twitterCard: false
 
 # Add maxFirstByteMs or maxCriticalMs per target only when the runner location
 # and cache state are stable enough for a meaningful threshold.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ssrwire",
-  "version": "0.2.0",
-  "description": "Inspect streamed SSR HTML, metadata timing, and crawler-specific delivery from the command line.",
+  "version": "0.4.0",
+  "description": "Inspect streamed SSR HTML, SEO and social metadata timing, and crawler-specific delivery from the command line.",
   "type": "module",
   "bin": {
     "ssrwire": "./dist/bin.js"
@@ -52,6 +52,9 @@
     "cli",
     "typescript",
     "seo-tools",
+    "open-graph",
+    "social-preview",
+    "twitter-cards",
     "github-actions",
     "sarif"
   ],

package/src/analyze.ts

@@ -1,3 +1,14 @@
+import {
+  effectiveTwitterCardSignal,
+  firstSocialSignal,
+  isAbsoluteHttpSocialUrl,
+  normalizeSocialValue,
+  OPEN_GRAPH_PROPERTIES,
+  OPEN_GRAPH_REQUIRED_PROPERTIES,
+  socialSignals,
+  TWITTER_CARD_REQUIRED_FIELDS,
+  TWITTER_PROPERTIES,
+} from "./social.js";
 import type {
   AuditSummary,
   AuditTarget,
@@ -7,6 +18,8 @@ import type {
   RobotsAudience,
   RobotsSignal,
   Severity,
+  SocialMetadataProperty,
+  SocialMetadataSignal,
   TargetAuditResult,
 } from "./types.js";
 
@@ -264,6 +277,146 @@ function checkRepeatedRobots(findings: Finding[], targetUrl: string, probe: Prob
   }
 }
 
+function auditedSocialProperties(
+  target: AuditTarget,
+  probe: ProbeResult,
+): readonly SocialMetadataProperty[] {
+  const properties = new Set<SocialMetadataProperty>();
+  if (target.expectations.requireOpenGraph === true) {
+    for (const property of OPEN_GRAPH_PROPERTIES) properties.add(property);
+  }
+  if (target.expectations.requireTwitterCard === true) {
+    for (const property of TWITTER_PROPERTIES) properties.add(property);
+    if (firstSocialSignal(probe.signals, "twitter:title") === undefined) {
+      properties.add("og:title");
+    }
+    if (firstSocialSignal(probe.signals, "twitter:description") === undefined) {
+      properties.add("og:description");
+    }
+    if (firstSocialSignal(probe.signals, "twitter:image") === undefined) {
+      properties.add("og:image");
+    }
+  }
+  return [...properties];
+}
+
+function normalizedSocialValues(
+  property: SocialMetadataProperty,
+  signals: readonly SocialMetadataSignal[],
+  baseUrl: string,
+): readonly string[] {
+  return signals
+    .map((signal) => normalizeSocialValue(property, signal.value, baseUrl))
+    .filter((value) => value.length > 0);
+}
+
+function checkRepeatedSocialMetadata(
+  findings: Finding[],
+  target: AuditTarget,
+  probe: ProbeResult,
+): void {
+  for (const property of auditedSocialProperties(target, probe)) {
+    // Open Graph explicitly permits multiple images and gives the first one precedence.
+    if (property === "og:image") continue;
+    const values = normalizedSocialValues(
+      property,
+      socialSignals(probe.signals, property),
+      probe.finalUrl,
+    );
+    if (values.length < 2) continue;
+
+    const distinct = new Set(values);
+    const conflicting = distinct.size > 1;
+    addFinding(findings, target.url, {
+      code: conflicting ? "conflicting-social-metadata" : "duplicate-social-metadata",
+      severity: "warning",
+      message: conflicting
+        ? `${probe.agent.label} received conflicting ${property} values.`
+        : `${probe.agent.label} received duplicate ${property} values.`,
+      agent: probe.agent.key,
+      evidence: {
+        property,
+        count: values.length,
+        distinctValues: distinct.size,
+        values: [...distinct].join(" | "),
+      },
+    });
+  }
+}
+
+function checkSocialUrls(findings: Finding[], target: AuditTarget, probe: ProbeResult): void {
+  const candidates = new Set<SocialMetadataSignal>();
+  if (target.expectations.requireOpenGraph === true) {
+    for (const signal of socialSignals(probe.signals, "og:url")) candidates.add(signal);
+    for (const signal of socialSignals(probe.signals, "og:image")) candidates.add(signal);
+  }
+  if (target.expectations.requireTwitterCard === true) {
+    const image = effectiveTwitterCardSignal(probe.signals, "image");
+    if (image !== undefined) candidates.add(image);
+  }
+
+  for (const signal of candidates) {
+    if (signal.value.trim().length === 0 || isAbsoluteHttpSocialUrl(signal.value)) continue;
+    addFinding(findings, target.url, {
+      code: "invalid-social-metadata-url",
+      severity: "warning",
+      message: `${probe.agent.label} received a non-absolute HTTP(S) ${signal.property} URL.`,
+      agent: probe.agent.key,
+      evidence: { property: signal.property, value: signal.value },
+    });
+  }
+}
+
+function checkRequiredSocialMetadata(
+  findings: Finding[],
+  target: AuditTarget,
+  probe: ProbeResult,
+): void {
+  if (probe.completion !== "complete") return;
+
+  if (target.expectations.requireOpenGraph === true) {
+    const missing = OPEN_GRAPH_REQUIRED_PROPERTIES.filter(
+      (property) => firstSocialSignal(probe.signals, property) === undefined,
+    );
+    if (missing.length > 0) {
+      addFinding(findings, target.url, {
+        code: "missing-open-graph-metadata",
+        severity: "warning",
+        message: `${probe.agent.label} received an incomplete Open Graph metadata set.`,
+        agent: probe.agent.key,
+        evidence: { fields: missing.join(", ") },
+      });
+    }
+  }
+
+  if (target.expectations.requireTwitterCard === true) {
+    const missing = TWITTER_CARD_REQUIRED_FIELDS.filter(
+      (field) => effectiveTwitterCardSignal(probe.signals, field) === undefined,
+    );
+    if (missing.length > 0) {
+      addFinding(findings, target.url, {
+        code: "missing-twitter-card-metadata",
+        severity: "warning",
+        message: `${probe.agent.label} received an incomplete Twitter Card metadata set.`,
+        agent: probe.agent.key,
+        evidence: { fields: missing.join(", ") },
+      });
+    }
+  }
+}
+
+function checkSocialMetadata(findings: Finding[], target: AuditTarget, probe: ProbeResult): void {
+  if (
+    target.expectations.requireOpenGraph !== true &&
+    target.expectations.requireTwitterCard !== true
+  ) {
+    return;
+  }
+  checkRequiredSocialMetadata(findings, target, probe);
+  checkRepeatedSocialMetadata(findings, target, probe);
+  checkSocialUrls(findings, target, probe);
+}
+
 function criticalArrivalMs(target: AuditTarget, probe: ProbeResult): number | undefined {
   const marks: number[] = [];
   const { expectations } = target;
@@ -299,6 +452,20 @@ function criticalArrivalMs(target: AuditTarget, probe: ProbeResult): number | un
   ) {
     marks.push(probe.signals.firstMainText?.atMs ?? 0);
   }
+  if (expectations.requireOpenGraph === true) {
+    const signals = OPEN_GRAPH_REQUIRED_PROPERTIES.map((property) =>
+      firstSocialSignal(probe.signals, property),
+    );
+    if (!signals.every((signal) => signal !== undefined)) return undefined;
+    marks.push(...signals.map((signal) => signal.atMs));
+  }
+  if (expectations.requireTwitterCard === true) {
+    const signals = TWITTER_CARD_REQUIRED_FIELDS.map((field) =>
+      effectiveTwitterCardSignal(probe.signals, field),
+    );
+    if (!signals.every((signal) => signal !== undefined)) return undefined;
+    marks.push(...signals.map((signal) => signal.atMs));
+  }
 
   return marks.length === 0 ? undefined : Math.max(...marks);
 }
@@ -365,7 +532,7 @@ function checkRequiredSignals(findings: Finding[], target: AuditTarget, probe: P
   }
 }
 
-function checkHeadRequirements(findings: Finding[], targetUrl: string, probe: ProbeResult): void {
+function checkHeadRequirements(findings: Finding[], target: AuditTarget, probe: ProbeResult): void {
   if (!probe.agent.requiresHeadMetadata) {
     return;
   }
@@ -384,12 +551,17 @@ function checkHeadRequirements(findings: Finding[], targetUrl: string, probe: Pr
   if (effectiveRobotsSignals(probe).some((signal) => signal.location === "body")) {
     bodyFields.add("robots");
   }
+  for (const property of auditedSocialProperties(target, probe)) {
+    if (socialSignals(probe.signals, property).some((signal) => signal.location === "body")) {
+      bodyFields.add(property);
+    }
+  }
 
   if (bodyFields.size === 0) {
     return;
   }
 
-  addFinding(findings, targetUrl, {
+  addFinding(findings, target.url, {
     code: "head-metadata-in-body",
     severity: "error",
     message: `${probe.agent.label} requires head metadata but received ${[...bodyFields].join(
@@ -440,9 +612,31 @@ function agentValueSummary(
   return probes.map((probe) => `${probe.agent.key}=${valueFor(probe)}`).join("; ");
 }
 
+function openGraphValue(probe: ProbeResult): string {
+  return OPEN_GRAPH_PROPERTIES.map((property) => {
+    const values = [
+      ...new Set(
+        normalizedSocialValues(property, socialSignals(probe.signals, property), probe.finalUrl),
+      ),
+    ];
+    return `${property}=${values.join(" | ") || "<missing>"}`;
+  }).join(", ");
+}
+
+function twitterCardValue(probe: ProbeResult): string {
+  return TWITTER_CARD_REQUIRED_FIELDS.map((field) => {
+    const signal = effectiveTwitterCardSignal(probe.signals, field);
+    const value =
+      signal === undefined
+        ? "<missing>"
+        : normalizeSocialValue(signal.property, signal.value, probe.finalUrl);
+    return `${field}=${value || "<missing>"}`;
+  }).join(", ");
+}
+
 function checkAgentDrift(
   findings: Finding[],
-  targetUrl: string,
+  target: AuditTarget,
   probes: readonly ProbeResult[],
 ): void {
   const complete = probes.filter((probe) => probe.completion === "complete");
@@ -450,7 +644,7 @@ function checkAgentDrift(
     return;
   }
 
-  const comparisons: readonly {
+  const comparisons: {
     readonly field: string;
     readonly valueFor: (probe: ProbeResult) => string;
   }[] = [
@@ -472,6 +666,12 @@ function checkAgentDrift(
       valueFor: effectiveRobotsValue,
     },
   ];
+  if (target.expectations.requireOpenGraph === true) {
+    comparisons.push({ field: "open-graph", valueFor: openGraphValue });
+  }
+  if (target.expectations.requireTwitterCard === true) {
+    comparisons.push({ field: "twitter-card", valueFor: twitterCardValue });
+  }
 
   for (const comparison of comparisons) {
     const values = complete.map(comparison.valueFor);
@@ -479,7 +679,7 @@ function checkAgentDrift(
       continue;
     }
 
-    addFinding(findings, targetUrl, {
+    addFinding(findings, target.url, {
       code: `agent-${comparison.field}-drift`,
       severity: "warning",
       message: `Crawler profiles received different ${comparison.field.replace("-", " ")} values.`,
@@ -556,6 +756,7 @@ export function analyzeTarget(
     checkRepeatedMetadata(findings, target.url, probe, "description", probe.signals.descriptions);
     checkRepeatedMetadata(findings, target.url, probe, "canonical", probe.signals.canonicals);
     checkRepeatedRobots(findings, target.url, probe);
+    checkSocialMetadata(findings, target, probe);
 
     const invalidJsonLd = probe.signals.jsonLd.filter((signal) => signal.valid === false);
     if (probe.completion === "complete" && invalidJsonLd.length > 0) {
@@ -587,11 +788,11 @@ export function analyzeTarget(
       });
     }
 
-    checkHeadRequirements(findings, target.url, probe);
+    checkHeadRequirements(findings, target, probe);
     checkTimings(findings, target, probe);
   }
 
-  checkAgentDrift(findings, target.url, probes);
+  checkAgentDrift(findings, target, probes);
 
   return findings;
 }