blodemd 0.1.0 → 0.2.0

package/packages/@repo/previewing/src/blob-source.ts

@@ -1,185 +0,0 @@
-import path from "node:path";
-
-import { normalizePath, shouldIgnoreRootDocsFile } from "@repo/common";
-
-import type { CompiledMdxResult, ContentSource } from "./content-source.js";
-
-interface BlobManifestFile {
-  path: string;
-  url: string;
-}
-
-interface BlobManifest {
-  files: BlobManifestFile[];
-}
-
-type FetchInitWithNext = RequestInit & {
-  next?: {
-    revalidate?: number;
-    tags?: string[];
-  };
-};
-
-const isRecord = (value: unknown): value is Record<string, unknown> =>
-  typeof value === "object" && value !== null;
-
-const isBlobManifest = (value: unknown): value is BlobManifest => {
-  if (!isRecord(value) || !Array.isArray(value.files)) {
-    return false;
-  }
-
-  return value.files.every((file) => {
-    if (!isRecord(file)) {
-      return false;
-    }
-
-    return typeof file.path === "string" && typeof file.url === "string";
-  });
-};
-
-const normalizeDirectory = (directory: string) => {
-  const normalized = normalizePath(path.posix.normalize(directory));
-  if (!normalized || normalized === ".") {
-    return "";
-  }
-  return normalized ? `${normalized}/` : "";
-};
-
-const normalizeRelativePath = (value: string) =>
-  normalizePath(path.posix.normalize(value));
-
-export class BlobContentSource implements ContentSource {
-  private readonly manifestUrl: string;
-  private readonly cacheTag?: string;
-  private manifestPromise?: Promise<Map<string, string>>;
-
-  constructor(manifestUrl: string, cacheTag?: string) {
-    this.manifestUrl = manifestUrl;
-    this.cacheTag = cacheTag;
-  }
-
-  private getFetchOptions(): FetchInitWithNext {
-    if (!this.cacheTag) {
-      return { cache: "no-store" };
-    }
-
-    return {
-      next: {
-        revalidate: 3600,
-        tags: [this.cacheTag],
-      },
-    };
-  }
-
-  private async loadManifest(): Promise<Map<string, string>> {
-    if (!this.manifestPromise) {
-      this.manifestPromise = (async () => {
-        const response = await fetch(this.manifestUrl, this.getFetchOptions());
-        if (!response.ok) {
-          throw new Error(
-            `Failed to load deployment manifest: ${response.status}`
-          );
-        }
-
-        const manifest = (await response.json()) as unknown;
-        if (!isBlobManifest(manifest)) {
-          throw new Error("Deployment manifest is invalid.");
-        }
-
-        return new Map(
-          manifest.files.map((file) => [
-            normalizeRelativePath(file.path),
-            file.url,
-          ])
-        );
-      })();
-    }
-
-    return await this.manifestPromise;
-  }
-
-  async readFile(relativePath: string): Promise<string> {
-    const url = await this.resolveUrl(relativePath);
-    if (!url) {
-      throw new Error(`Content file "${relativePath}" not found.`);
-    }
-
-    const response = await fetch(url, this.getFetchOptions());
-    if (!response.ok) {
-      throw new Error(`Failed to load content file: ${response.status}`);
-    }
-
-    return await response.text();
-  }
-
-  async listFiles(directory: string): Promise<string[]> {
-    const manifest = await this.loadManifest();
-    const prefix = normalizeDirectory(directory);
-
-    const files: string[] = [];
-    for (const file of manifest.keys()) {
-      if (prefix && !file.startsWith(prefix)) {
-        continue;
-      }
-      // Return paths relative to the listed directory, matching
-      // FsContentSource so callers can join them onto the collection root.
-      const relativePath = prefix ? file.slice(prefix.length) : file;
-      if (!relativePath) {
-        continue;
-      }
-      // Only top-level entries of the listed directory are subject to the
-      // root-docs-file ignore list, again matching FsContentSource.
-      if (
-        !relativePath.includes("/") &&
-        shouldIgnoreRootDocsFile(relativePath)
-      ) {
-        continue;
-      }
-      files.push(relativePath);
-    }
-    // oxlint-disable-next-line eslint-plugin-unicorn/no-array-sort
-    files.sort();
-    return files;
-  }
-
-  async exists(relativePath: string): Promise<boolean> {
-    const manifest = await this.loadManifest();
-    return manifest.has(normalizeRelativePath(relativePath));
-  }
-
-  async resolveUrl(relativePath: string): Promise<string | null> {
-    const manifest = await this.loadManifest();
-    return manifest.get(normalizeRelativePath(relativePath)) ?? null;
-  }
-
-  async readCompiledMdx(
-    relativePath: string
-  ): Promise<CompiledMdxResult | null> {
-    const compiledPath = `_compiled/${normalizeRelativePath(relativePath)}.json`;
-    const url = await this.resolveUrl(compiledPath);
-    if (!url) {
-      return null;
-    }
-
-    try {
-      const response = await fetch(url, this.getFetchOptions());
-      if (!response.ok) {
-        return null;
-      }
-
-      const data = (await response.json()) as CompiledMdxResult;
-      if (!data.compiledSource || data.version !== 1) {
-        return null;
-      }
-
-      return data;
-    } catch {
-      return null;
-    }
-  }
-}
-
-export const createBlobSource = (
-  manifestUrl: string,
-  cacheTag?: string
-): ContentSource => new BlobContentSource(manifestUrl, cacheTag);

package/packages/@repo/previewing/src/config-loader.ts

@@ -1,316 +0,0 @@
-import path from "node:path";
-
-import { normalizePath } from "@repo/common";
-import type { DocsConfig, SiteConfig } from "@repo/models";
-import { validateDocsConfig, validateSiteConfig } from "@repo/validation";
-
-import { LEGACY_PROJECT_NAME_FALLBACK_WARNING } from "./constants.js";
-import type { ContentSource } from "./content-source.js";
-import type { SiteConfigResult } from "./types.js";
-
-const DOCS_CONFIG_FILE = "docs.json";
-
-const defaultLinkLabel = (input: {
-  href: string;
-  label?: string;
-  type?: "discord" | "github";
-}) => {
-  if (input.label) {
-    return input.label;
-  }
-  if (input.type === "github") {
-    return "GitHub";
-  }
-  if (input.type === "discord") {
-    return "Discord";
-  }
-  try {
-    return new URL(input.href).hostname;
-  } catch {
-    return input.href;
-  }
-};
-
-// oxlint-disable-next-line eslint/complexity
-const mapDocsConfig = (docs: DocsConfig): SiteConfig => {
-  const navigation = {
-    global:
-      docs.navbar?.links?.length || docs.navigation.global?.anchors?.length
-        ? {
-            anchors: docs.navigation.global?.anchors?.map((anchor) => ({
-              href: anchor.href,
-              label: anchor.anchor,
-            })),
-            links: docs.navbar?.links?.map((link) => ({
-              href: link.href,
-              label: defaultLinkLabel(link),
-            })),
-          }
-        : undefined,
-    groups: docs.navigation.groups?.map((group) => ({
-      expanded: group.expanded,
-      group: group.group,
-      hidden: group.hidden,
-      pages: group.root
-        ? [
-            group.root,
-            ...(group.pages ?? []).filter((page) => page !== group.root),
-          ]
-        : group.pages,
-    })),
-    languages: docs.navigation.languages?.map((language) => ({
-      label: language.language,
-      locale: language.language,
-      url: language.href,
-    })),
-    pages: docs.navigation.pages,
-    tabs: docs.navigation.tabs?.map((tab) => ({
-      groups: tab.groups?.map((group) => ({
-        expanded: group.expanded,
-        group: group.group,
-        hidden: group.hidden,
-        pages: group.root
-          ? [
-              group.root,
-              ...(group.pages ?? []).filter((page) => page !== group.root),
-            ]
-          : group.pages,
-      })),
-      href: tab.href,
-      icon: tab.icon,
-      label: tab.tab,
-      pages: tab.pages,
-    })),
-    versions: docs.navigation.versions?.map((version) => ({
-      label: version.version,
-      url: version.href,
-    })),
-  } satisfies SiteConfig["navigation"];
-
-  return {
-    collections: [
-      {
-        id: "docs",
-        navigation,
-        openapi: docs.api?.openapi,
-        root: "",
-        type: "docs",
-      },
-    ],
-    contextual: docs.contextual,
-    description: docs.description,
-    favicon:
-      typeof docs.favicon === "string" ? docs.favicon : docs.favicon?.light,
-    features: {
-      rightToc: true,
-      search: true,
-      themeToggle: docs.appearance?.strict !== true,
-      toc: true,
-    },
-    logo: docs.logo
-      ? {
-          dark: typeof docs.logo === "string" ? docs.logo : docs.logo.dark,
-          href: typeof docs.logo === "string" ? undefined : docs.logo.href,
-          light: typeof docs.logo === "string" ? docs.logo : docs.logo.light,
-        }
-      : undefined,
-    name: docs.name,
-    navigation,
-    openapiProxy: {
-      enabled:
-        docs.api?.playground?.proxy !== false &&
-        Boolean(docs.api?.openapi || docs.api?.asyncapi),
-    },
-    seo: docs.seo,
-    slug: docs.slug,
-  };
-};
-
-const getProjectWarnings = (config: { slug?: string }): string[] =>
-  config.slug ? [] : [LEGACY_PROJECT_NAME_FALLBACK_WARNING];
-
-const readJsonConfig = async (source: ContentSource, relativePath: string) =>
-  JSON.parse(await source.readFile(relativePath)) as unknown;
-
-const normalizeRefPath = (baseDirectory: string, reference: string) => {
-  if (
-    reference.startsWith("/") ||
-    reference.startsWith("\\") ||
-    reference.startsWith("http://") ||
-    reference.startsWith("https://")
-  ) {
-    throw new Error(
-      `Invalid $ref "${reference}". Only relative JSON files are supported.`
-    );
-  }
-
-  const normalized = normalizePath(path.posix.join(baseDirectory, reference));
-  if (
-    !normalized ||
-    normalized === "." ||
-    normalized.startsWith("../") ||
-    normalized.includes("/../")
-  ) {
-    throw new Error(`Invalid $ref "${reference}".`);
-  }
-  return normalized;
-};
-
-const resolveJsonRefs = async (
-  source: ContentSource,
-  value: unknown,
-  baseDirectory: string,
-  seen: Set<string>
-): Promise<unknown> => {
-  if (Array.isArray(value)) {
-    return await Promise.all(
-      value.map((item) => resolveJsonRefs(source, item, baseDirectory, seen))
-    );
-  }
-
-  if (!value || typeof value !== "object") {
-    return value;
-  }
-
-  const record = value as Record<string, unknown>;
-  const reference = record.$ref;
-  if (typeof reference === "string") {
-    const resolvedPath = normalizeRefPath(baseDirectory, reference);
-    if (seen.has(resolvedPath)) {
-      throw new Error(`Circular $ref detected for "${resolvedPath}".`);
-    }
-
-    const nextSeen = new Set(seen);
-    // oxlint-disable-next-line eslint-plugin-unicorn/no-immediate-mutation
-    nextSeen.add(resolvedPath);
-    const referenced = await readJsonConfig(source, resolvedPath);
-    const referencedValue = await resolveJsonRefs(
-      source,
-      referenced,
-      path.posix.dirname(resolvedPath) === "."
-        ? ""
-        : normalizePath(path.posix.dirname(resolvedPath)),
-      nextSeen
-    );
-
-    const siblingEntries = Object.entries(record).filter(
-      ([key]) => key !== "$ref"
-    );
-    if (
-      !siblingEntries.length ||
-      !referencedValue ||
-      typeof referencedValue !== "object" ||
-      Array.isArray(referencedValue)
-    ) {
-      return referencedValue;
-    }
-
-    const siblingValue = await resolveJsonRefs(
-      source,
-      Object.fromEntries(siblingEntries),
-      baseDirectory,
-      seen
-    );
-    return {
-      ...(referencedValue as Record<string, unknown>),
-      ...(siblingValue as Record<string, unknown>),
-    };
-  }
-
-  const resolvedEntries = await Promise.all(
-    Object.entries(record).map(async ([key, entryValue]) => [
-      key,
-      await resolveJsonRefs(source, entryValue, baseDirectory, seen),
-    ])
-  );
-  return Object.fromEntries(resolvedEntries);
-};
-
-const readResolvedJsonConfig = async (
-  source: ContentSource,
-  relativePath: string
-) =>
-  await resolveJsonRefs(
-    source,
-    await readJsonConfig(source, relativePath),
-    path.posix.dirname(relativePath) === "."
-      ? ""
-      : normalizePath(path.posix.dirname(relativePath)),
-    new Set([relativePath])
-  );
-
-const loadDocsConfig = async (
-  source: ContentSource
-): Promise<SiteConfigResult | null> => {
-  if (!(await source.exists(DOCS_CONFIG_FILE))) {
-    return null;
-  }
-
-  try {
-    const parsed = await readResolvedJsonConfig(source, DOCS_CONFIG_FILE);
-
-    // Try SiteConfig format first (has collections, theme, colors, etc.)
-    const siteResult = validateSiteConfig(parsed);
-    if (siteResult.success) {
-      return {
-        config: siteResult.data,
-        ok: true,
-        warnings: getProjectWarnings(siteResult.data),
-      };
-    }
-
-    // Fall back to DocsConfig format (Mintlify-compatible) and map to SiteConfig
-    const docsResult = validateDocsConfig(parsed);
-    if (docsResult.success) {
-      return {
-        config: mapDocsConfig(docsResult.data),
-        ok: true,
-        warnings: getProjectWarnings(docsResult.data),
-      };
-    }
-
-    return { errors: docsResult.errors, ok: false };
-  } catch (error) {
-    return {
-      errors: [
-        error instanceof Error
-          ? error.message
-          : `Failed to load ${DOCS_CONFIG_FILE}`,
-      ],
-      ok: false,
-    };
-  }
-};
-
-export const loadSiteConfig = async (
-  source: ContentSource
-): Promise<SiteConfigResult> => {
-  const docsConfig = await loadDocsConfig(source);
-  if (docsConfig) {
-    return docsConfig;
-  }
-
-  return {
-    errors: [`${DOCS_CONFIG_FILE} not found.`],
-    ok: false,
-  };
-};
-
-export const getDocsCollection = (config: SiteConfig) =>
-  config.collections.find((collection) => collection.type === "docs");
-
-export const getDocsNavigation = (config: SiteConfig) =>
-  getDocsCollection(config)?.navigation ?? config.navigation;
-
-export const getDocsCollectionWithNavigation = (
-  config: SiteConfig
-): SiteConfig["collections"][number] | undefined => {
-  const docsCollection = getDocsCollection(config);
-  const docsNavigation = getDocsNavigation(config);
-
-  return docsCollection &&
-    docsNavigation &&
-    docsCollection.navigation !== docsNavigation
-    ? { ...docsCollection, navigation: docsNavigation }
-    : docsCollection;
-};

package/packages/@repo/previewing/src/constants.ts

@@ -1,16 +0,0 @@
-export const PREBUILT_INDEX_PATH = "_content-index.json";
-export const PREBUILT_OPENAPI_INDEX_PATH = "_openapi-index.json";
-export const PREBUILT_SEARCH_INDEX_PATH = "_search-index.json";
-export const PREBUILT_TOC_INDEX_PATH = "_toc-index.json";
-export const PREBUILT_UTILITY_INDEX_PATH = "_utility-index.json";
-export const PREBUILT_UTILITY_SITEMAP_PATH = "_utility/sitemap.xml";
-export const PREBUILT_UTILITY_LLMS_PATH = "_utility/llms.txt";
-export const PREBUILT_UTILITY_LLMS_FULL_PATH = "_utility/llms-full.txt";
-export const PREBUILT_UTILITY_LLMS_SEGMENT_PREFIX = "_utility/llms/";
-export const PREBUILT_UTILITY_SKILLS_INDEX_PATH = "_utility/skills-index.json";
-export const PREBUILT_UTILITY_SKILLS_MD_PREFIX = "_utility/skills/";
-export const UTILITY_DOCS_ROOT_TOKEN = "__BLODEMD_DOCS_ROOT__";
-export const LEGACY_PROJECT_NAME_FALLBACK_WARNING =
-  "docs.json.slug is recommended. Falling back to docs.json.name as the deployment slug is deprecated.";
-
-export const NEWLINE_REGEX = /\r?\n/;