@burdenoff/website-sdk 2026.1031.3 → 2026.1101.2

package/dist/comparison/index.mjs

@@ -1,109 +1,4 @@
-// src/comparison/index.ts
-var DEFAULT_COMPARISON_MAX_AGE_DAYS = 180;
-var DAY_MS = 24 * 60 * 60 * 1e3;
-var ISO_DATE = /^\d{4}-\d{2}-\d{2}$/;
-function parseVerifiedAt(value) {
-  if (typeof value !== "string" || !ISO_DATE.test(value)) return null;
-  const date = /* @__PURE__ */ new Date(`${value}T00:00:00.000Z`);
-  if (Number.isNaN(date.getTime())) return null;
-  return date.toISOString().slice(0, 10) === value ? date : null;
-}
-function isHttpUrl(value) {
-  try {
-    const url = new URL(value);
-    return url.protocol === "https:" || url.protocol === "http:";
-  } catch {
-    return false;
-  }
-}
-function checkComparisonFreshness(claims, options = {}) {
-  const maxAgeDays = options.maxAgeDays ?? DEFAULT_COMPARISON_MAX_AGE_DAYS;
-  const now = options.now ?? /* @__PURE__ */ new Date();
-  const issues = [];
-  for (const claim of claims) {
-    const sources = claim.sources ?? [];
-    if (sources.length === 0) {
-      issues.push({
-        path: claim.path,
-        problem: "missing-source",
-        detail: "no source: add { url, verifiedAt } for the vendor page this claim was checked against"
-      });
-      continue;
-    }
-    let newest = null;
-    for (const source of sources) {
-      if (!isHttpUrl(source.url)) {
-        issues.push({
-          path: claim.path,
-          problem: "invalid-url",
-          detail: `source URL is not an http(s) URL: ${JSON.stringify(source.url)}`
-        });
-      }
-      const verified = parseVerifiedAt(source.verifiedAt);
-      if (!verified) {
-        issues.push({
-          path: claim.path,
-          problem: "invalid-date",
-          detail: `verifiedAt must be YYYY-MM-DD, got ${JSON.stringify(source.verifiedAt)}`
-        });
-        continue;
-      }
-      if (verified.getTime() > now.getTime() + DAY_MS) {
-        issues.push({
-          path: claim.path,
-          problem: "future-date",
-          detail: `verifiedAt ${source.verifiedAt} is in the future`
-        });
-        continue;
-      }
-      if (!newest || verified.getTime() > newest.getTime()) newest = verified;
-    }
-    if (newest) {
-      const ageDays = Math.floor((now.getTime() - newest.getTime()) / DAY_MS);
-      if (ageDays > maxAgeDays) {
-        issues.push({
-          path: claim.path,
-          problem: "stale",
-          detail: `last verified ${newest.toISOString().slice(0, 10)} (${ageDays} days ago, limit ${maxAgeDays}): re-read the vendor page and update verifiedAt or the claim`
-        });
-      }
-    }
-  }
-  return issues;
-}
-function latestVerification(claims) {
-  let latest = null;
-  for (const claim of claims) {
-    for (const source of claim.sources ?? []) {
-      if (parseVerifiedAt(source.verifiedAt) && (!latest || source.verifiedAt > latest)) {
-        latest = source.verifiedAt;
-      }
-    }
-  }
-  return latest;
-}
-function oldestVerification(claims) {
-  let oldest = null;
-  for (const claim of claims) {
-    for (const source of claim.sources ?? []) {
-      if (parseVerifiedAt(source.verifiedAt) && (!oldest || source.verifiedAt < oldest)) {
-        oldest = source.verifiedAt;
-      }
-    }
-  }
-  return oldest;
-}
-function formatFreshnessReport(issues) {
-  if (issues.length === 0)
-    return "Comparison sources: all claims sourced and fresh.";
-  const lines = issues.map((i) => `  - [${i.problem}] ${i.path}: ${i.detail}`);
-  return [
-    `Comparison sources: ${issues.length} problem(s) found.`,
-    ...lines,
-    "Re-check each claim against the vendor's current page, then update the claim and its verifiedAt."
-  ].join("\n");
-}
-
-export { DEFAULT_COMPARISON_MAX_AGE_DAYS, checkComparisonFreshness, formatFreshnessReport, latestVerification, oldestVerification, parseVerifiedAt };
+export { DEFAULT_COMPARISON_MAX_AGE_DAYS, checkComparisonFreshness, formatFreshnessReport, latestVerification, oldestVerification, parseVerifiedAt } from '../chunk-B63XLDZH.mjs';
+import '../chunk-VNS5WDWO.mjs';
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/comparison/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/comparison/index.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * @burdenoff/website-sdk - Comparison page sources and freshness (BOFF-9971)\n *\n * Every product website with a /vs (competitor comparison) page makes claims\n * about other vendors. Those claims age fast: a vendor ships the feature we\n * said it lacked, or changes its prices. This module gives every site the same\n * contract and the same check:\n *\n * - each claim carries at least one source `{ url, verifiedAt }` (enforced by\n *   the `Sourced` type at compile time), and\n * - `checkComparisonFreshness` fails when a claim has no source, a source is\n *   not an http(s) URL, a date is malformed or in the future, or the newest\n *   verification is older than `maxAgeDays` (180 by default).\n *\n * Sites run the check in their PR Check workflow, so a stale or unsourced\n * comparison blocks the next change until someone re-reads the vendor's page.\n *\n * @example\n * ```ts\n * import { checkComparisonFreshness, formatFreshnessReport } from '@burdenoff/website-sdk/comparison'\n *\n * const issues = checkComparisonFreshness(collectClaims(COMPETITORS))\n * if (issues.length) {\n *   console.error(formatFreshnessReport(issues))\n *   process.exit(1)\n * }\n * ```\n */\n\n/** Where a comparison claim was checked, and when (ISO date, YYYY-MM-DD). */\nexport interface ComparisonSource {\n  /** The vendor page (or docs page) the claim was checked against. */\n  url: string;\n  /** The day a person last read that page and confirmed the claim. */\n  verifiedAt: string;\n  /** Optional short label shown with the link, e.g. \"Pricing\". */\n  label?: string;\n}\n\n/** A non-empty list: a sourced claim always has at least one source. */\nexport type NonEmptySources = readonly [\n  ComparisonSource,\n  ...ComparisonSource[],\n];\n\n/** Mix-in for any comparison claim (table row, profile, pricing row). */\nexport interface Sourced {\n  sources: NonEmptySources;\n}\n\n/** One claim to check, located by a human-readable path for the report. */\nexport interface ComparisonClaim {\n  /** Where the claim lives, e.g. \"zapier.featureRows[Workflow versioning]\". */\n  path: string;\n  /** Its sources; missing or empty fails the check. */\n  sources?: readonly ComparisonSource[] | null;\n}\n\nexport type FreshnessProblem =\n  \"missing-source\" | \"invalid-url\" | \"invalid-date\" | \"future-date\" | \"stale\";\n\nexport interface FreshnessIssue {\n  path: string;\n  problem: FreshnessProblem;\n  detail: string;\n}\n\nexport interface FreshnessOptions {\n  /** Oldest acceptable verification, in days. Default 180. */\n  maxAgeDays?: number;\n  /** The clock to check against. Default: now. */\n  now?: Date;\n}\n\n/** Default staleness threshold for comparison claims. */\nexport const DEFAULT_COMPARISON_MAX_AGE_DAYS = 180;\n\nconst DAY_MS = 24 * 60 * 60 * 1000;\nconst ISO_DATE = /^\\d{4}-\\d{2}-\\d{2}$/;\n\n/** Parse a strict YYYY-MM-DD date as UTC midnight, or null when invalid. */\nexport function parseVerifiedAt(value: string): Date | null {\n  if (typeof value !== \"string\" || !ISO_DATE.test(value)) return null;\n  const date = new Date(`${value}T00:00:00.000Z`);\n  if (Number.isNaN(date.getTime())) return null;\n  // Reject rollovers such as 2026-02-31 → 2026-03-03.\n  return date.toISOString().slice(0, 10) === value ? date : null;\n}\n\nfunction isHttpUrl(value: string): boolean {\n  try {\n    const url = new URL(value);\n    return url.protocol === \"https:\" || url.protocol === \"http:\";\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Check every claim and return the problems found (empty when all is well).\n * A claim passes on its newest valid source, so adding a fresh source to an\n * old claim is enough to clear a \"stale\" issue.\n */\nexport function checkComparisonFreshness(\n  claims: readonly ComparisonClaim[],\n  options: FreshnessOptions = {},\n): FreshnessIssue[] {\n  const maxAgeDays = options.maxAgeDays ?? DEFAULT_COMPARISON_MAX_AGE_DAYS;\n  const now = options.now ?? new Date();\n  const issues: FreshnessIssue[] = [];\n\n  for (const claim of claims) {\n    const sources = claim.sources ?? [];\n    if (sources.length === 0) {\n      issues.push({\n        path: claim.path,\n        problem: \"missing-source\",\n        detail:\n          \"no source: add { url, verifiedAt } for the vendor page this claim was checked against\",\n      });\n      continue;\n    }\n\n    let newest: Date | null = null;\n    for (const source of sources) {\n      if (!isHttpUrl(source.url)) {\n        issues.push({\n          path: claim.path,\n          problem: \"invalid-url\",\n          detail: `source URL is not an http(s) URL: ${JSON.stringify(source.url)}`,\n        });\n      }\n      const verified = parseVerifiedAt(source.verifiedAt);\n      if (!verified) {\n        issues.push({\n          path: claim.path,\n          problem: \"invalid-date\",\n          detail: `verifiedAt must be YYYY-MM-DD, got ${JSON.stringify(source.verifiedAt)}`,\n        });\n        continue;\n      }\n      if (verified.getTime() > now.getTime() + DAY_MS) {\n        issues.push({\n          path: claim.path,\n          problem: \"future-date\",\n          detail: `verifiedAt ${source.verifiedAt} is in the future`,\n        });\n        continue;\n      }\n      if (!newest || verified.getTime() > newest.getTime()) newest = verified;\n    }\n\n    if (newest) {\n      const ageDays = Math.floor((now.getTime() - newest.getTime()) / DAY_MS);\n      if (ageDays > maxAgeDays) {\n        issues.push({\n          path: claim.path,\n          problem: \"stale\",\n          detail: `last verified ${newest.toISOString().slice(0, 10)} (${ageDays} days ago, limit ${maxAgeDays}): re-read the vendor page and update verifiedAt or the claim`,\n        });\n      }\n    }\n  }\n\n  return issues;\n}\n\n/** Newest valid verification date across all claims, or null. */\nexport function latestVerification(\n  claims: readonly ComparisonClaim[],\n): string | null {\n  let latest: string | null = null;\n  for (const claim of claims) {\n    for (const source of claim.sources ?? []) {\n      if (\n        parseVerifiedAt(source.verifiedAt) &&\n        (!latest || source.verifiedAt > latest)\n      ) {\n        latest = source.verifiedAt;\n      }\n    }\n  }\n  return latest;\n}\n\n/** Oldest valid verification date across all claims, or null. */\nexport function oldestVerification(\n  claims: readonly ComparisonClaim[],\n): string | null {\n  let oldest: string | null = null;\n  for (const claim of claims) {\n    for (const source of claim.sources ?? []) {\n      if (\n        parseVerifiedAt(source.verifiedAt) &&\n        (!oldest || source.verifiedAt < oldest)\n      ) {\n        oldest = source.verifiedAt;\n      }\n    }\n  }\n  return oldest;\n}\n\n/** A plain-text report for CI logs, one line per issue. */\nexport function formatFreshnessReport(\n  issues: readonly FreshnessIssue[],\n): string {\n  if (issues.length === 0)\n    return \"Comparison sources: all claims sourced and fresh.\";\n  const lines = issues.map((i) => `  - [${i.problem}] ${i.path}: ${i.detail}`);\n  return [\n    `Comparison sources: ${issues.length} problem(s) found.`,\n    ...lines,\n    \"Re-check each claim against the vendor's current page, then update the claim and its verifiedAt.\",\n  ].join(\"\\n\");\n}\n"]}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.mjs"}