radiant-docs 0.1.64 → 0.1.66

package/template/scripts/remove-assistant-for-non-pro.mjs

@@ -1,28 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-const FRAMEWORK_DIR = path.resolve(__dirname, "..");
-const ASSISTANT_DIST_DIR = path.join(FRAMEWORK_DIR, "dist", "-", "assistant");
-
-function getOrgTier() {
-  const parsedTier = Number.parseInt((process.env.ORG_TIER ?? "1").trim(), 10);
-  return Number.isFinite(parsedTier) && parsedTier > 0 ? parsedTier : 1;
-}
-
-const orgTier = getOrgTier();
-
-if (orgTier >= 3) {
-  console.log("Assistant embed retained for Pro tier build.");
-  process.exit(0);
-}
-
-if (!fs.existsSync(ASSISTANT_DIST_DIR)) {
-  console.log("Assistant embed cleanup skipped: assistant output not found.");
-  process.exit(0);
-}
-
-fs.rmSync(ASSISTANT_DIST_DIR, { recursive: true, force: true });
-console.log("Assistant embed removed for non-Pro tier build.");

package/template/scripts/stamp-image-versions.mjs

@@ -1,355 +0,0 @@
-import crypto from "node:crypto";
-import fs from "node:fs";
-import path from "node:path";
-
-const CWD = process.cwd();
-const DIST_DIR = path.join(CWD, "dist");
-const VERSION_LENGTH = 12;
-const DIST_ROOT = path.resolve(DIST_DIR);
-const CONFIGURED_STATIC_HOST = (() => {
-  const raw =
-    typeof process.env.STATIC_ASSET_HOST === "string"
-      ? process.env.STATIC_ASSET_HOST.trim()
-      : "";
-  if (!raw) return null;
-  const withScheme = /^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(raw)
-    ? raw
-    : `https://${raw}`;
-
-  try {
-    const parsed = new URL(withScheme);
-    return parsed.hostname.toLowerCase();
-  } catch {
-    return null;
-  }
-})();
-const CONFIGURED_PREFIX =
-  typeof process.env.R2_BUCKET_PREFIX === "string" &&
-  process.env.R2_BUCKET_PREFIX.trim().length > 0
-    ? process.env.R2_BUCKET_PREFIX.trim().replace(/^\/+|\/+$/g, "")
-    : null;
-const CONFIGURED_BASE_PATH = (() => {
-  const raw =
-    typeof process.env.DOCS_SITE_URL === "string"
-      ? process.env.DOCS_SITE_URL.trim()
-      : "";
-  if (!raw) return null;
-
-  try {
-    const parsed = new URL(raw);
-    const normalized = parsed.pathname
-      .replace(/\/{2,}/g, "/")
-      .replace(/\/+$/, "");
-    return normalized && normalized !== "/" ? normalized : null;
-  } catch {
-    return null;
-  }
-})();
-const VERSIONED_EXTENSIONS = new Set([
-  ".avif",
-  ".gif",
-  ".ico",
-  ".jpg",
-  ".jpeg",
-  ".m4a",
-  ".mp3",
-  ".mp4",
-  ".oga",
-  ".ogg",
-  ".ogv",
-  ".opus",
-  ".png",
-  ".svg",
-  ".wav",
-  ".webm",
-  ".webp",
-]);
-
-const hashCache = new Map();
-
-function findHtmlFiles(dir, files = []) {
-  if (!fs.existsSync(dir)) return files;
-
-  const entries = fs.readdirSync(dir, { withFileTypes: true });
-  for (const entry of entries) {
-    const fullPath = path.join(dir, entry.name);
-
-    if (entry.isDirectory()) {
-      findHtmlFiles(fullPath, files);
-      continue;
-    }
-
-    if (entry.isFile() && entry.name.endsWith(".html")) {
-      files.push(fullPath);
-    }
-  }
-
-  return files;
-}
-
-function htmlBasePathname(filePath) {
-  const relative = path.relative(DIST_DIR, filePath).replace(/\\/g, "/");
-  if (relative === "index.html") return "/";
-
-  if (relative.endsWith("/index.html")) {
-    return `/${relative.slice(0, -"index.html".length)}`;
-  }
-
-  const slashIndex = relative.lastIndexOf("/");
-  if (slashIndex === -1) return "/";
-  return `/${relative.slice(0, slashIndex + 1)}`;
-}
-
-function getHash(filePath) {
-  const cached = hashCache.get(filePath);
-  if (cached) return cached;
-
-  const buffer = fs.readFileSync(filePath);
-  const hash = crypto
-    .createHash("sha256")
-    .update(buffer)
-    .digest("hex")
-    .slice(0, VERSION_LENGTH);
-
-  hashCache.set(filePath, hash);
-  return hash;
-}
-
-function normalizePathForDistLookup(pathname) {
-  const normalizedPathname = path.posix.normalize(pathname);
-
-  const withoutStaticPrefix = stripPathPrefix(
-    normalizedPathname,
-    CONFIGURED_PREFIX ? `/${CONFIGURED_PREFIX}` : null,
-  );
-  return stripPathPrefix(withoutStaticPrefix, CONFIGURED_BASE_PATH);
-}
-
-function stripPathPrefix(pathname, prefix) {
-  if (!prefix) {
-    return pathname;
-  }
-
-  if (pathname === prefix || pathname.startsWith(`${prefix}/`)) {
-    const stripped = pathname.slice(prefix.length);
-    return stripped.startsWith("/") ? stripped : `/${stripped}`;
-  }
-
-  return pathname;
-}
-
-function resolveLocalImagePath(urlValue, filePath) {
-  const trimmed = urlValue.trim();
-  if (!trimmed) return null;
-
-  const decoded = trimmed.replace(/&/g, "&");
-  if (
-    decoded.startsWith("data:") ||
-    decoded.startsWith("blob:") ||
-    decoded.startsWith("mailto:") ||
-    decoded.startsWith("tel:") ||
-    decoded.startsWith("//")
-  ) {
-    return null;
-  }
-
-  let parsed;
-  try {
-    parsed = new URL(
-      decoded,
-      `https://radiant.invalid${htmlBasePathname(filePath)}`,
-    );
-  } catch {
-    return null;
-  }
-
-  const isAbsoluteUrl = /^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(decoded);
-  if (isAbsoluteUrl) {
-    if (!CONFIGURED_STATIC_HOST) {
-      return null;
-    }
-
-    if (parsed.protocol !== "https:") {
-      return null;
-    }
-
-    if (parsed.hostname.toLowerCase() !== CONFIGURED_STATIC_HOST) {
-      return null;
-    }
-  }
-
-  const extension = path.extname(parsed.pathname).toLowerCase();
-  if (!VERSIONED_EXTENSIONS.has(extension)) {
-    return null;
-  }
-
-  const normalizedPathname = normalizePathForDistLookup(
-    parsed.pathname,
-  ).replace(/^\/+/, "");
-  const absolutePath = path.resolve(DIST_DIR, normalizedPathname);
-
-  if (
-    absolutePath !== DIST_ROOT &&
-    !absolutePath.startsWith(`${DIST_ROOT}${path.sep}`)
-  ) {
-    return null;
-  }
-
-  if (!fs.existsSync(absolutePath) || !fs.statSync(absolutePath).isFile()) {
-    return null;
-  }
-
-  return { parsed, absolutePath, isAbsoluteUrl };
-}
-
-function formatUpdatedUrl(parsed, isAbsoluteUrl) {
-  const pathnameWithParams = `${parsed.pathname}${parsed.search}${parsed.hash}`;
-  const fullValue = isAbsoluteUrl
-    ? `${parsed.origin}${pathnameWithParams}`
-    : pathnameWithParams;
-  return fullValue.replace(/&/g, "&");
-}
-
-function stampSingleUrl(urlValue, filePath) {
-  const resolved = resolveLocalImagePath(urlValue, filePath);
-  if (!resolved) {
-    return { value: urlValue, changed: false };
-  }
-
-  const version = getHash(resolved.absolutePath);
-  resolved.parsed.searchParams.set("v", version);
-
-  const updated = formatUpdatedUrl(resolved.parsed, resolved.isAbsoluteUrl);
-  return { value: updated, changed: updated !== urlValue };
-}
-
-function stampSrcset(srcsetValue, filePath) {
-  const candidates = srcsetValue.split(",");
-  let changed = false;
-
-  const updated = candidates.map((candidate) => {
-    const trimmed = candidate.trim();
-    if (!trimmed) return candidate;
-
-    const whitespaceIndex = trimmed.search(/\s/);
-    const urlPart =
-      whitespaceIndex === -1 ? trimmed : trimmed.slice(0, whitespaceIndex);
-    const descriptor =
-      whitespaceIndex === -1 ? "" : trimmed.slice(whitespaceIndex);
-
-    const stamped = stampSingleUrl(urlPart, filePath);
-    if (stamped.changed) changed = true;
-
-    return `${stamped.value}${descriptor}`;
-  });
-
-  return {
-    value: changed ? updated.join(", ") : srcsetValue,
-    changed,
-  };
-}
-
-function replaceAttribute(html, filePath, attribute) {
-  let tagAlternation = "img|source";
-  if (attribute === "src") {
-    tagAlternation = "img|source|video|audio|track";
-  } else if (attribute === "poster") {
-    tagAlternation = "video";
-  }
-
-  const pattern = new RegExp(
-    `(<(?:${tagAlternation})\\b[^>]*\\b${attribute}\\s*=\\s*["'])([^"']*)(["'][^>]*>)`,
-    "gi",
-  );
-
-  let changed = false;
-
-  const nextHtml = html.replace(pattern, (fullMatch, prefix, value, suffix) => {
-    const stamped =
-      attribute === "srcset"
-        ? stampSrcset(value, filePath)
-        : stampSingleUrl(value, filePath);
-
-    if (!stamped.changed) return fullMatch;
-
-    changed = true;
-    return `${prefix}${stamped.value}${suffix}`;
-  });
-
-  return { html: nextHtml, changed };
-}
-
-function hasIconRel(tagSource) {
-  const relMatch = tagSource.match(/\brel\s*=\s*["']([^"']+)["']/i);
-  if (!relMatch) return false;
-
-  const relTokens = relMatch[1].toLowerCase().split(/\s+/).filter(Boolean);
-
-  return relTokens.includes("icon") || relTokens.includes("apple-touch-icon");
-}
-
-function replaceIconLinkHref(html, filePath) {
-  const pattern = /(<link\b[^>]*\bhref\s*=\s*["'])([^"']*)(["'][^>]*>)/gi;
-  let changed = false;
-
-  const nextHtml = html.replace(pattern, (fullMatch, prefix, value, suffix) => {
-    if (!hasIconRel(fullMatch)) {
-      return fullMatch;
-    }
-
-    const stamped = stampSingleUrl(value, filePath);
-    if (!stamped.changed) {
-      return fullMatch;
-    }
-
-    changed = true;
-    return `${prefix}${stamped.value}${suffix}`;
-  });
-
-  return { html: nextHtml, changed };
-}
-
-function main() {
-  if (!fs.existsSync(DIST_DIR)) {
-    console.warn("Skipping image version stamping: dist directory not found.");
-    return;
-  }
-
-  const htmlFiles = findHtmlFiles(DIST_DIR).sort();
-  if (htmlFiles.length === 0) {
-    console.warn(
-      "Skipping image version stamping: no HTML files found in dist.",
-    );
-    return;
-  }
-
-  let updatedCount = 0;
-
-  for (const htmlFile of htmlFiles) {
-    const sourceHtml = fs.readFileSync(htmlFile, "utf8");
-    const srcResult = replaceAttribute(sourceHtml, htmlFile, "src");
-    const srcSetResult = replaceAttribute(srcResult.html, htmlFile, "srcset");
-    const posterResult = replaceAttribute(
-      srcSetResult.html,
-      htmlFile,
-      "poster",
-    );
-    const iconHrefResult = replaceIconLinkHref(posterResult.html, htmlFile);
-    const fileChanged =
-      srcResult.changed ||
-      srcSetResult.changed ||
-      posterResult.changed ||
-      iconHrefResult.changed;
-
-    if (fileChanged) {
-      fs.writeFileSync(htmlFile, iconHrefResult.html, "utf8");
-      updatedCount += 1;
-    }
-  }
-
-  console.log(
-    `✅ Image version stamping complete. Updated ${updatedCount}/${htmlFiles.length} HTML files.`,
-  );
-}
-
-main();

package/template/scripts/stamp-og-image-versions.mjs

@@ -1,199 +0,0 @@
-import crypto from "node:crypto";
-import fs from "node:fs";
-import path from "node:path";
-
-const CWD = process.cwd();
-const DIST_DIR = path.join(CWD, "dist");
-const OG_IMAGES_DIR = path.join(DIST_DIR, "_og/images");
-const VERSION_LENGTH = 12;
-
-function findHtmlFiles(dir, files = []) {
-  if (!fs.existsSync(dir)) return files;
-
-  const entries = fs.readdirSync(dir, { withFileTypes: true });
-  for (const entry of entries) {
-    const fullPath = path.join(dir, entry.name);
-
-    if (entry.isDirectory()) {
-      findHtmlFiles(fullPath, files);
-      continue;
-    }
-
-    if (entry.isFile() && entry.name.endsWith(".html")) {
-      files.push(fullPath);
-    }
-  }
-
-  return files;
-}
-
-function normalizeRoutePath(routePath) {
-  if (!routePath || routePath === "/") return "/";
-  if (!routePath.startsWith("/")) routePath = `/${routePath}`;
-  return routePath.endsWith("/") ? routePath : `${routePath}/`;
-}
-
-function routePathFromHtmlPath(filePath) {
-  const relative = path.relative(DIST_DIR, filePath).replace(/\\/g, "/");
-
-  if (relative === "index.html") return "/";
-  if (relative.endsWith("/index.html")) {
-    const base = relative.slice(0, -"/index.html".length);
-    return normalizeRoutePath(base);
-  }
-
-  if (relative.endsWith(".html")) {
-    return normalizeRoutePath(relative.slice(0, -".html".length));
-  }
-
-  return "/";
-}
-
-function routePathToOgImageRelativePath(routePath) {
-  const normalizedRoutePath = normalizeRoutePath(routePath);
-  if (normalizedRoutePath === "/") return "index.png";
-  return `${normalizedRoutePath.slice(1, -1)}.png`;
-}
-
-function hashFile(filePath) {
-  const buffer = fs.readFileSync(filePath);
-  return crypto
-    .createHash("sha256")
-    .update(buffer)
-    .digest("hex")
-    .slice(0, VERSION_LENGTH);
-}
-
-function updateVersionInUrl(urlValue, version) {
-  if (typeof urlValue !== "string" || urlValue.trim().length === 0) {
-    return urlValue;
-  }
-
-  const decoded = urlValue.trim().replace(/&/g, "&");
-  const hasScheme = /^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(decoded);
-  const isProtocolRelative = decoded.startsWith("//");
-  const isAbsolutePath = decoded.startsWith("/");
-
-  let parsed;
-  try {
-    if (hasScheme) {
-      parsed = new URL(decoded);
-    } else if (isProtocolRelative) {
-      parsed = new URL(`https:${decoded}`);
-    } else {
-      parsed = new URL(decoded, "https://radiant.invalid/");
-    }
-  } catch {
-    return urlValue;
-  }
-
-  parsed.searchParams.set("v", version);
-
-  let encoded;
-  if (hasScheme) {
-    encoded = parsed.toString();
-  } else if (isProtocolRelative) {
-    encoded = `//${parsed.host}${parsed.pathname}${parsed.search}${parsed.hash}`;
-  } else if (isAbsolutePath) {
-    encoded = `${parsed.pathname}${parsed.search}${parsed.hash}`;
-  } else {
-    encoded = `${parsed.pathname.replace(/^\//, "")}${parsed.search}${parsed.hash}`;
-  }
-
-  return encoded.replace(/&/g, "&");
-}
-
-function replaceMetaImageUrl(html, attrName, attrValue, version) {
-  const patterns = [
-    new RegExp(
-      `(<meta\\s+[^>]*${attrName}\\s*=\\s*["']${attrValue}["'][^>]*\\bcontent\\s*=\\s*["'])([^"']*)(["'][^>]*>)`,
-      "gi",
-    ),
-    new RegExp(
-      `(<meta\\s+[^>]*\\bcontent\\s*=\\s*["'])([^"']*)(["'][^>]*${attrName}\\s*=\\s*["']${attrValue}["'][^>]*>)`,
-      "gi",
-    ),
-  ];
-
-  let found = false;
-  let changed = false;
-  let nextHtml = html;
-
-  for (const pattern of patterns) {
-    nextHtml = nextHtml.replace(pattern, (_, prefix, currentUrl, suffix) => {
-      found = true;
-      const updatedUrl = updateVersionInUrl(currentUrl, version);
-      if (updatedUrl !== currentUrl) {
-        changed = true;
-      }
-      return `${prefix}${updatedUrl}${suffix}`;
-    });
-  }
-
-  return { html: nextHtml, found, changed };
-}
-
-function main() {
-  if (!fs.existsSync(DIST_DIR)) {
-    console.warn("Skipping OG version stamping: dist directory not found.");
-    return;
-  }
-
-  if (!fs.existsSync(OG_IMAGES_DIR)) {
-    console.warn("Skipping OG version stamping: OG images directory not found.");
-    return;
-  }
-
-  const htmlFiles = findHtmlFiles(DIST_DIR).sort();
-  if (htmlFiles.length === 0) {
-    console.warn("Skipping OG version stamping: no HTML files found in dist.");
-    return;
-  }
-
-  let updatedCount = 0;
-  let missingOgCount = 0;
-  let missingMetaCount = 0;
-
-  for (const htmlPath of htmlFiles) {
-    const routePath = routePathFromHtmlPath(htmlPath);
-    const ogImageRelativePath = routePathToOgImageRelativePath(routePath);
-    const ogImagePath = path.join(OG_IMAGES_DIR, ...ogImageRelativePath.split("/"));
-
-    if (!fs.existsSync(ogImagePath)) {
-      missingOgCount += 1;
-      continue;
-    }
-
-    const version = hashFile(ogImagePath);
-    const sourceHtml = fs.readFileSync(htmlPath, "utf8");
-
-    const ogResult = replaceMetaImageUrl(
-      sourceHtml,
-      "property",
-      "og:image",
-      version,
-    );
-    const twitterResult = replaceMetaImageUrl(
-      ogResult.html,
-      "name",
-      "twitter:image",
-      version,
-    );
-
-    if (!ogResult.found && !twitterResult.found) {
-      missingMetaCount += 1;
-      continue;
-    }
-
-    if (twitterResult.html !== sourceHtml) {
-      fs.writeFileSync(htmlPath, twitterResult.html, "utf8");
-      updatedCount += 1;
-    }
-  }
-
-  console.log(
-    `✅ OG version stamping complete. Updated ${updatedCount}/${htmlFiles.length} HTML files (missing OG image: ${missingOgCount}, missing meta tags: ${missingMetaCount}).`,
-  );
-}
-
-main();