blodemd 0.1.0 → 0.2.0

package/docs/lib/edge-config.ts

@@ -1,95 +0,0 @@
-import type {
-  TenantEdgeHostRecord,
-  TenantEdgeSlugRecord,
-} from "@repo/contracts";
-import {
-  TenantEdgeHostRecordSchema,
-  TenantEdgeSlugRecordSchema,
-  getTenantEdgeHostKeys,
-  getTenantEdgeHostKey,
-  getTenantEdgeSlugKeys,
-  getTenantEdgeSlugKey,
-} from "@repo/contracts";
-import { createClient } from "@vercel/edge-config";
-
-import { createTimedPromiseCache } from "./server-cache";
-
-const EDGE_CONFIG_CACHE_TTL_MS = 30 * 1000;
-
-const readTrimmedEnv = (name: string) => {
-  const value = process.env[name];
-  if (typeof value !== "string") {
-    return;
-  }
-  const trimmed = value.trim();
-  if (!trimmed) {
-    return;
-  }
-  return trimmed;
-};
-
-const edgeConfigConnectionString = readTrimmedEnv("EDGE_CONFIG");
-const edgeConfigClient = edgeConfigConnectionString
-  ? createClient(edgeConfigConnectionString)
-  : null;
-
-export { getTenantEdgeHostKey, getTenantEdgeSlugKey };
-
-const hostRecordCache = createTimedPromiseCache<
-  string,
-  TenantEdgeHostRecord | null
->({
-  maxEntries: 512,
-  ttlMs: EDGE_CONFIG_CACHE_TTL_MS,
-});
-
-const slugRecordCache = createTimedPromiseCache<
-  string,
-  TenantEdgeSlugRecord | null
->({
-  maxEntries: 512,
-  ttlMs: EDGE_CONFIG_CACHE_TTL_MS,
-});
-
-const getEdgeConfigValue = async (key: string) => {
-  if (!edgeConfigClient) {
-    return null;
-  }
-
-  try {
-    return (await edgeConfigClient.get(key)) as unknown;
-  } catch {
-    return null;
-  }
-};
-
-export const isEdgeConfigEnabled = () => Boolean(edgeConfigClient);
-
-export const clearTenantEdgeConfigCaches = () => {
-  hostRecordCache.clear();
-  slugRecordCache.clear();
-};
-
-export const getTenantEdgeHostRecord = async (host: string) =>
-  await hostRecordCache.getOrCreate(getTenantEdgeHostKey(host), async () => {
-    for (const key of getTenantEdgeHostKeys(host)) {
-      const value = await getEdgeConfigValue(key);
-      const parsed = TenantEdgeHostRecordSchema.safeParse(value);
-      if (parsed.success) {
-        return parsed.data;
-      }
-    }
-    return null;
-  });
-
-export const getTenantEdgeSlugRecord = async (slug: string) =>
-  await slugRecordCache.getOrCreate(getTenantEdgeSlugKey(slug), async () => {
-    for (const key of getTenantEdgeSlugKeys(slug)) {
-      const value = await getEdgeConfigValue(key);
-      const parsed = TenantEdgeSlugRecordSchema.safeParse(value);
-      if (parsed.success) {
-        return parsed.data;
-      }
-    }
-    return null;
-  });

package/docs/lib/env.ts

@@ -1,23 +0,0 @@
-const readTrimmedEnv = (name: string) => {
-  const value = process.env[name];
-  if (typeof value !== "string") {
-    return;
-  }
-  const trimmed = value.trim();
-  if (!trimmed) {
-    return;
-  }
-  return trimmed;
-};
-
-// Must reference process.env.NEXT_PUBLIC_API_URL as a literal so Next.js
-// inlines it into the client bundle. Dynamic access via readTrimmedEnv is
-// not replaced at build time and would always be undefined on the client.
-export const docsApiBase =
-  process.env.NEXT_PUBLIC_API_URL?.trim() || "http://localhost:4000";
-
-export const platformAssetPrefix =
-  readTrimmedEnv("PLATFORM_ASSET_PREFIX") ?? "";
-
-export const platformRootDomain =
-  readTrimmedEnv("PLATFORM_ROOT_DOMAIN") ?? "blode.md";

package/docs/lib/etag.ts

@@ -1,22 +0,0 @@
-import { createHash } from "node:crypto";
-
-import { NextResponse } from "next/server";
-
-export const computeETag = (content: string): string => {
-  const hash = createHash("sha256").update(content).digest("hex").slice(0, 16);
-  return `"${hash}"`;
-};
-
-export const handleIfNoneMatch = (
-  request: Request,
-  etag: string
-): NextResponse | null => {
-  const ifNoneMatch = request.headers.get("if-none-match");
-  if (ifNoneMatch && ifNoneMatch === etag) {
-    return new NextResponse(null, {
-      headers: { ETag: etag },
-      status: 304,
-    });
-  }
-  return null;
-};

package/docs/lib/github-install.ts

@@ -1,33 +0,0 @@
-import { apiFetch } from "@/lib/api-client";
-
-export const GITHUB_INSTALL_STATE_KEY = "blodemd:install-state";
-
-export interface PendingGithubInstall {
-  projectId: string;
-  projectSlug: string;
-  state: string;
-}
-
-export const startGithubInstall = async ({
-  accessToken,
-  projectId,
-  projectSlug,
-}: {
-  accessToken: string;
-  projectId: string;
-  projectSlug: string;
-}): Promise<void> => {
-  const result = await apiFetch<{ url: string; state: string }>(
-    `/projects/${projectId}/git/install-url`,
-    { accessToken, method: "POST" }
-  );
-  sessionStorage.setItem(
-    GITHUB_INSTALL_STATE_KEY,
-    JSON.stringify({
-      projectId,
-      projectSlug,
-      state: result.state,
-    })
-  );
-  window.location.assign(result.url);
-};

package/docs/lib/llms-full.ts

@@ -1,82 +0,0 @@
-export const LLMS_FULL_CHAR_LIMIT = 80_000;
-
-const FENCE_LINE_REGEX = /^ {0,3}(`{3,}|~{3,})/;
-
-const getTruncationFooter = (indexUrl: string) =>
-  [
-    "",
-    "---",
-    "",
-    "Content truncated to keep this response under crawler size limits.",
-    `Use ${indexUrl} for the full page index and fetch individual .md pages for uncapped content.`,
-  ].join("\n");
-
-const findOpenFence = (source: string) => {
-  let openFence: string | null = null;
-
-  for (const line of source.split(/\r?\n/)) {
-    const marker = FENCE_LINE_REGEX.exec(line)?.[1];
-    if (!marker) {
-      continue;
-    }
-
-    if (!openFence) {
-      openFence = marker;
-      continue;
-    }
-
-    if (marker[0] === openFence[0] && marker.length >= openFence.length) {
-      openFence = null;
-    }
-  }
-
-  return openFence;
-};
-
-const closeOpenFence = (source: string) => {
-  const openFence = findOpenFence(source);
-  return openFence ? `${source}\n${openFence}` : source;
-};
-
-const findTruncationBoundary = (source: string, minimum: number) => {
-  const sectionBoundary = source.lastIndexOf("\n# ");
-  if (sectionBoundary > minimum) {
-    return sectionBoundary;
-  }
-
-  const paragraphBoundary = source.lastIndexOf("\n\n");
-  if (paragraphBoundary > minimum) {
-    return paragraphBoundary;
-  }
-
-  const lineBoundary = source.lastIndexOf("\n");
-  return lineBoundary > 0 ? lineBoundary : source.length;
-};
-
-export const capLlmsFullContent = (
-  content: string,
-  indexUrl: string,
-  limit = LLMS_FULL_CHAR_LIMIT
-) => {
-  const trimmed = content.trim();
-  if (trimmed.length <= limit) {
-    return trimmed;
-  }
-
-  const footer = getTruncationFooter(indexUrl);
-  let room = limit - footer.length - 16;
-  while (room > 0) {
-    const draft = trimmed.slice(0, room);
-    const boundary = findTruncationBoundary(draft, Math.floor(room / 2));
-    const capped = closeOpenFence(draft.slice(0, boundary).trimEnd());
-    const result = `${capped}${footer}`;
-
-    if (result.length <= limit) {
-      return result;
-    }
-
-    room -= result.length - limit + 16;
-  }
-
-  return footer.trim().slice(0, limit);
-};

package/docs/lib/marketing-markdown.ts

@@ -1,79 +0,0 @@
-const MARKETING_MARKDOWN: Record<string, string> = {
-  "/": `# Blode.md
-
-Docs your users love. And their AI understands.
-
-Write MDX, commit, push. blode.md ships a fast, beautiful docs site in one git push, wired up for the LLMs your users ask too.
-
-## How it works
-
-1. Install the GitHub app at github.com/apps/blodemd
-2. Pick a repo and a docs folder
-3. Push to \`main\`, deployed to \`acme.blode.md\`
-
-Or use the CLI:
-
-\`\`\`
-npm i -g blodemd
-blodemd login
-blodemd new docs
-blodemd push docs
-\`\`\`
-
-## What you get
-
-- **GitHub auto-deploy** — Install once. Every push to your branch deploys in seconds.
-- **Custom domains** — Point a domain, get SSL. Or proxy docs at yourdomain.com/docs.
-- **MDX components** — 30+ components out of the box: callouts, tabs, code groups, API refs.
-- **Search** — Full-text search across every page. No plugin, no config.
-- **Content types** — Docs, blogs, changelogs, and courses in one project, one domain.
-- **API reference** — Point at an OpenAPI spec, ship an interactive API reference.
-
-## Links
-
-- [About](https://blode.md/about)
-- [Blog](https://blode.md/blog)
-- [Changelog](https://blode.md/changelog)
-- [Privacy](https://blode.md/privacy)
-- [Terms](https://blode.md/terms)
-- [Security](https://blode.md/security)
-- [Docs](https://blode.md/docs)
-- [GitHub](https://github.com/mblode/blodemd)
-`,
-  "/about": `# About Blode.md
-
-blode.md is a docs platform that lives in your git repo. Write MDX, push to main, ship docs.
-`,
-  "/blog": `# Blog
-
-Notes from the team building blode.md.
-`,
-  "/changelog": `# Changelog
-
-Latest updates to the blode.md platform.
-`,
-  "/pricing": `# Pricing
-
-Blode.md is currently free for hosted projects and MIT licensed for self-hosting.
-`,
-  "/privacy": `# Privacy Policy
-
-How blode.md collects, uses, and protects your information.
-`,
-  "/security": `# Security
-
-Security practices at blode.md.
-`,
-  "/terms": `# Terms of Service
-
-Terms governing your use of blode.md.
-`,
-};
-
-export const getMarketingMarkdown = (pathname: string): string | null => {
-  const normalized = pathname.replace(/\/+$/, "") || "/";
-  return MARKETING_MARKDOWN[normalized] ?? null;
-};
-
-export const hasMarketingMarkdown = (pathname: string): boolean =>
-  getMarketingMarkdown(pathname) !== null;

package/docs/lib/marketing-site.ts

@@ -1,31 +0,0 @@
-import { platformRootDomain } from "./env";
-
-export const MARKETING_ORIGIN = `https://${platformRootDomain}`;
-
-export const MARKETING_CANONICAL_PATHS = [
-  "/",
-  "/about",
-  "/blog",
-  "/changelog",
-  "/pricing",
-  "/privacy",
-  "/security",
-  "/terms",
-] as const;
-
-export const MARKETING_API_CATALOG_PATH = "/.well-known/api-catalog";
-export const MARKETING_SKILLS_INDEX_PATH =
-  "/.well-known/agent-skills/index.json";
-export const MARKETING_MCP_SERVER_CARD_PATH =
-  "/.well-known/mcp/server-card.json";
-export const MARKETING_OAUTH_AUTHORIZATION_SERVER_PATH =
-  "/.well-known/oauth-authorization-server";
-export const MARKETING_OAUTH_PROTECTED_RESOURCE_PATH =
-  "/.well-known/oauth-protected-resource";
-export const MARKETING_OPENID_CONFIGURATION_PATH =
-  "/.well-known/openid-configuration";
-export const MARKETING_API_DOCS_PATH = "/docs/api/overview";
-export const MARKETING_API_STATUS_PATH = "/api/health";
-export const MARKETING_API_SERVICE_DESC_PATH = "/api/openapi.json";
-
-export const marketingUrl = (path: string) => `${MARKETING_ORIGIN}${path}`;

package/docs/lib/mdx.ts

@@ -1,98 +0,0 @@
-import { run } from "@mdx-js/mdx";
-import rehypeShikiFromHighlighter from "@shikijs/rehype/core";
-import { compileMDX } from "next-mdx-remote/rsc";
-import { createElement } from "react";
-import type { ComponentType } from "react";
-import * as jsxRuntime from "react/jsx-runtime";
-import rehypeAutolinkHeadings from "rehype-autolink-headings";
-import rehypeSlug from "rehype-slug";
-import remarkGfm from "remark-gfm";
-
-import { createMdxComponents } from "@/components/mdx";
-
-import { getHighlighter, SHIKI_THEME_PAIR } from "./shiki";
-
-const FRONTMATTER_REGEX = /^---\s*\n[\s\S]*?\n---\s*\n?/;
-
-const stripFrontmatter = (source: string) => ({
-  body: source.replace(FRONTMATTER_REGEX, ""),
-  frontmatter: {} as Record<string, unknown>,
-});
-
-/**
- * Renders pre-compiled MDX content. The `compiledSource` is a JS function body
- * produced by `@repo/mdx-compiler` at deploy time via `compile()` with
- * `outputFormat: 'function-body'`. This is the fast path — no parsing,
- * no plugin execution, no Shiki. Sub-millisecond execution.
- */
-export const renderFromCompiled = async (
-  compiledSource: string,
-  basePath = "",
-  currentPath = ""
-) => {
-  const components = createMdxComponents(basePath, currentPath);
-  const mdxModule = await run(compiledSource, {
-    ...jsxRuntime,
-    baseUrl: import.meta.url,
-  });
-  const Content = mdxModule.default as ComponentType<{
-    components?: ReturnType<typeof createMdxComponents>;
-  }>;
-
-  return {
-    content: createElement(Content, { components }),
-    frontmatter: {} as Record<string, unknown>,
-  };
-};
-
-/**
- * Full MDX compilation + rendering. Used as fallback for local development
- * (FsContentSource) and any content that wasn't pre-compiled at deploy time.
- */
-export const renderMdx = async (
-  source: string,
-  basePath = "",
-  currentPath = ""
-) => {
-  const { body, frontmatter } = stripFrontmatter(source);
-  const components = createMdxComponents(basePath, currentPath);
-  const highlighter = await getHighlighter();
-  const shikiTransformer = rehypeShikiFromHighlighter(highlighter, {
-    defaultColor: false,
-    fallbackLanguage: "text",
-    themes: SHIKI_THEME_PAIR,
-  });
-  const shikiPlugin = () => shikiTransformer;
-
-  const result = await compileMDX({
-    components,
-    options: {
-      blockDangerousJS: false,
-      blockJS: false,
-      mdxOptions: {
-        rehypePlugins: [
-          rehypeSlug,
-          [
-            rehypeAutolinkHeadings,
-            {
-              behavior: "append",
-              properties: {
-                className: [
-                  "ml-2 text-[0.9em] opacity-0 transition-opacity hover:opacity-100",
-                ],
-              },
-            },
-          ],
-          shikiPlugin,
-        ],
-        remarkPlugins: [remarkGfm],
-      },
-    },
-    source: body,
-  });
-
-  return {
-    content: result.content,
-    frontmatter,
-  };
-};