@publish.os/nextjs 0.0.1-alpha.2 → 0.0.1-alpha.3

package/dist/kernel/routes/pages/leaf.cjs

@@ -0,0 +1,421 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/kernel/routes/pages/leaf.tsx
+var leaf_exports = {};
+__export(leaf_exports, {
+  appendPoweredByFooter: () => appendPoweredByFooter,
+  createLeafMetadata: () => createLeafMetadata,
+  createLeafPage: () => createLeafPage,
+  createLeafStaticParams: () => createLeafStaticParams
+});
+module.exports = __toCommonJS(leaf_exports);
+var import_mdx = require("@publish.os/nextjs/mdx");
+var import_cache = require("next/cache");
+var import_navigation = require("next/navigation");
+var import_react = require("react");
+
+// src/cache/tags.ts
+var import_node_crypto = require("crypto");
+var MAX_TAG_LEN = 256;
+var MAX_SEGMENT_LEN = 80;
+var TAG_PATTERN = /^[a-z0-9:_./-]+$/;
+function sha256(value) {
+  return (0, import_node_crypto.createHash)("sha256").update(value).digest("hex").slice(0, 16);
+}
+function safeSegment(value) {
+  const raw = value.trim().toLowerCase() || "root";
+  const normalized = raw.replace(/\\/g, "/").replace(/\/+/g, "/").replace(/^\//, "").replace(/\/$/, "").replace(/[^a-z0-9:_./-]+/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
+  const segment = normalized || "root";
+  if (segment.length <= MAX_SEGMENT_LEN) return segment;
+  return `${segment.slice(0, 48)}.${sha256(segment)}`;
+}
+function assertTag(tag) {
+  if (tag.length > MAX_TAG_LEN || !TAG_PATTERN.test(tag)) {
+    return `tag:${sha256(tag)}`;
+  }
+  return tag;
+}
+var tags = {
+  site() {
+    return "site";
+  },
+  pages() {
+    return "pages";
+  },
+  group(group) {
+    return assertTag(`group:${safeSegment(group)}`);
+  },
+  page(group, slug) {
+    const path = Array.isArray(slug) ? slug.join("/") : slug;
+    return assertTag(`page:${safeSegment(group)}:${safeSegment(path)}`);
+  },
+  manifest(contentHash) {
+    return assertTag(`manifest:${safeSegment(contentHash)}`);
+  },
+  sitemap() {
+    return "sitemap";
+  },
+  robots() {
+    return "robots";
+  },
+  llms(scope = "root") {
+    return assertTag(`llms:${safeSegment(scope)}`);
+  },
+  feed(format, scope = "site") {
+    return assertTag(`feed:${safeSegment(format)}:${safeSegment(scope)}`);
+  }
+};
+
+// src/internal/utils/logger.ts
+var isDev = process.env.NODE_ENV !== "production";
+var isDebugEnabled = process.env.NEXT_PRIVATE_DEBUG_CACHE === "1";
+var log = {
+  debug(...args) {
+    if (isDev && isDebugEnabled) console.debug("[publish.os:debug]", ...args);
+  },
+  info(...args) {
+    console.log("[publish.os]", ...args);
+  },
+  warn(...args) {
+    console.warn("[publish.os:warn]", ...args);
+  },
+  error(...args) {
+    console.error("[publish.os:error]", ...args);
+  }
+};
+
+// src/resolvers/manifest-resolver.ts
+function findNodeInTree(nodes, id) {
+  for (const node of nodes) {
+    if (node.type === "page") {
+      if (node.fileID === id) return node;
+    } else if (node.id === id) {
+      return node;
+    }
+    if (node.type === "section" || node.type === "folder") {
+      const found = findNodeInTree(node.children, id);
+      if (found) return found;
+    }
+  }
+  return null;
+}
+function pageNode(page) {
+  return {
+    type: "page",
+    fileID: page.fileID,
+    title: page.title,
+    path: page.path,
+    group: page.group,
+    description: page.description,
+    status: page.status,
+    publishedAt: page.publishedAt,
+    updatedAt: page.updatedAt,
+    authors: page.authors,
+    tags: page.tags,
+    meta: page.meta
+  };
+}
+function resolveLeaf(manifest, group, slug) {
+  const slugPath = Array.isArray(slug) ? slug.join("/") : slug;
+  const page = manifest.pages.find((p) => p.group === group && p.slug === slugPath) ?? null;
+  if (!page) return null;
+  const groupData = manifest.groups[group];
+  if (!groupData) return null;
+  return {
+    site: manifest.site,
+    tree: groupData.tree,
+    node: findNodeInTree(groupData.tree, page.fileID) ?? pageNode(page),
+    page,
+    currentPath: page.path,
+    group
+  };
+}
+function listStaticParams(manifest, group) {
+  const groupData = manifest.groups[group];
+  if (!groupData) return [];
+  return groupData.pages.map((page) => ({ slug: page.slug.split("/") }));
+}
+
+// src/kernel/routes/pages/agent-metadata.ts
+function normalizePath(path) {
+  const prefixed = path.startsWith("/") ? path : `/${path}`;
+  if (prefixed === "/") return prefixed;
+  return prefixed.replace(/\/+$/, "");
+}
+function markdownPathForHtmlPath(path) {
+  const normalized = normalizePath(path);
+  if (normalized === "/") return "/index.md";
+  return `${normalized}.md`;
+}
+function agentReadableAlternates({
+  canonicalPath,
+  manifest,
+  markdownPath
+}) {
+  return {
+    ...manifest.site.url ? { canonical: normalizePath(canonicalPath) } : {},
+    types: {
+      ...markdownPath ? { "text/markdown": normalizePath(markdownPath) } : {},
+      "text/plain": "/llms.txt"
+    }
+  };
+}
+
+// src/kernel/routes/pages/social-metadata.ts
+function isDevelopment() {
+  return process.env.NODE_ENV === "development";
+}
+function absoluteUrl(path, siteUrl) {
+  if (/^https:\/\//.test(path)) return path;
+  if (isDevelopment()) return path;
+  if (!siteUrl) return path;
+  return new URL(path, siteUrl).toString();
+}
+function createSocialMetadata({
+  canonicalPath,
+  description,
+  manifest,
+  ogManifest,
+  title,
+  type = "website"
+}) {
+  const key = ogManifest?.routes?.[canonicalPath];
+  const rootKey = ogManifest?.routes?.["/"];
+  const entry = (key ? ogManifest?.entries?.[key] : void 0) ?? (rootKey ? ogManifest?.entries?.[rootKey] : void 0);
+  if (!entry) {
+    return {
+      openGraph: {
+        description,
+        title,
+        type,
+        url: canonicalPath
+      },
+      twitter: {
+        card: "summary",
+        description,
+        title
+      }
+    };
+  }
+  const imageUrl = absoluteUrl(entry.url, manifest.site.url);
+  return {
+    openGraph: {
+      description,
+      images: [
+        {
+          alt: entry.alt,
+          height: entry.height,
+          url: imageUrl,
+          width: entry.width
+        }
+      ],
+      siteName: manifest.site.name,
+      title,
+      type,
+      url: canonicalPath
+    },
+    twitter: {
+      card: "summary_large_image",
+      description,
+      images: [imageUrl],
+      title
+    }
+  };
+}
+
+// src/kernel/routes/pages/leaf.tsx
+var import_jsx_runtime = require("react/jsx-runtime");
+var manifests = /* @__PURE__ */ new Map();
+var leaves = /* @__PURE__ */ new Map();
+var poweredByFooters = /* @__PURE__ */ new Map();
+function hasClassName(value, className) {
+  return typeof value === "string" && value.split(/\s+/).includes(className);
+}
+function isPlatformMdx(value) {
+  return value === import_mdx.MDX || typeof value === "function" && value.__publishOsMdx === true;
+}
+function findMdxPath(node) {
+  if (!(0, import_react.isValidElement)(node)) {
+    return null;
+  }
+  if (isPlatformMdx(node.type)) {
+    return [];
+  }
+  const children = import_react.Children.toArray(node.props.children);
+  for (let index = 0; index < children.length; index += 1) {
+    const childPath = findMdxPath(children[index]);
+    if (childPath) {
+      return [
+        {
+          childIndex: index,
+          children,
+          element: node
+        },
+        ...childPath
+      ];
+    }
+  }
+  return null;
+}
+function targetDepthForMdxPath(path) {
+  for (let index = path.length - 1; index >= 0; index -= 1) {
+    const entry = path[index];
+    if (entry && entry.childIndex < entry.children.length - 1) {
+      return index;
+    }
+  }
+  for (let index = path.length - 1; index >= 0; index -= 1) {
+    const entry = path[index];
+    if (!hasClassName(entry?.element.props.className, "markdown-prose")) {
+      return index;
+    }
+  }
+  return 0;
+}
+function appendFooterAtPath({
+  currentPath = [],
+  footer,
+  node,
+  targetPath
+}) {
+  if (!(0, import_react.isValidElement)(node)) {
+    return node;
+  }
+  const children = import_react.Children.toArray(node.props.children);
+  if (currentPath.length === targetPath.length) {
+    return (0, import_react.cloneElement)(node, void 0, ...children, footer);
+  }
+  const childIndex = targetPath[currentPath.length];
+  const nextChildren = children.map(
+    (child, index) => index === childIndex ? appendFooterAtPath({
+      currentPath: [...currentPath, index],
+      footer,
+      node: child,
+      targetPath
+    }) : child
+  );
+  return (0, import_react.cloneElement)(node, void 0, ...nextChildren);
+}
+function appendPoweredByFooter({
+  footer,
+  node
+}) {
+  const path = findMdxPath(node);
+  if (!path?.length) {
+    return { node, placed: false };
+  }
+  const targetDepth = targetDepthForMdxPath(path);
+  const targetPath = path.slice(0, targetDepth).map((entry) => entry.childIndex);
+  return {
+    node: appendFooterAtPath({ footer, node, targetPath }),
+    placed: true
+  };
+}
+async function CachedLeafPage({
+  group,
+  slug
+}) {
+  "use cache";
+  (0, import_cache.cacheLife)("page");
+  (0, import_cache.cacheTag)(
+    tags.site(),
+    tags.pages(),
+    tags.group(group),
+    tags.page(group, slug)
+  );
+  const manifest = manifests.get(group);
+  const Leaf = leaves.get(group);
+  const PoweredByFooter = poweredByFooters.get(group);
+  if (!manifest || !Leaf) (0, import_navigation.notFound)();
+  (0, import_cache.cacheTag)(tags.manifest(manifest.contentHash));
+  log.debug("[cache]", `${group}/${slug.join("/")}`);
+  const resolved = resolveLeaf(manifest, group, slug);
+  if (!resolved) (0, import_navigation.notFound)();
+  const attribution = manifest.attribution?.[group] ?? { enabled: false };
+  const leaf = await Leaf(resolved);
+  const footer = attribution.enabled && PoweredByFooter ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)(PoweredByFooter, { attribution }) : null;
+  const placed = footer ? appendPoweredByFooter({ footer, node: leaf }) : { node: leaf, placed: true };
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "flex min-h-full min-w-0 flex-1 flex-col", children: [
+    placed.node,
+    footer && !placed.placed ? footer : null
+  ] });
+}
+function createLeafPage({
+  group,
+  manifest,
+  Leaf,
+  PoweredByFooter
+}) {
+  manifests.set(group, manifest);
+  leaves.set(group, Leaf);
+  if (PoweredByFooter) {
+    poweredByFooters.set(group, PoweredByFooter);
+  } else {
+    poweredByFooters.delete(group);
+  }
+  return async function Page({ params }) {
+    const { slug = [] } = await params;
+    log.debug("[render]", `${group}/${slug.join("/")}`);
+    return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(CachedLeafPage, { group, slug });
+  };
+}
+function createLeafMetadata({
+  group,
+  manifest,
+  ogManifest
+}) {
+  return async function generateMetadata({
+    params
+  }) {
+    const { slug = [] } = await params;
+    log.debug("[metadata]", `${group}/${slug.join("/")}`);
+    const resolved = resolveLeaf(manifest, group, slug);
+    if (!resolved) return {};
+    return {
+      title: resolved.page.title,
+      description: resolved.page.description,
+      alternates: agentReadableAlternates({
+        canonicalPath: resolved.page.path,
+        manifest,
+        markdownPath: markdownPathForHtmlPath(resolved.page.path)
+      }),
+      ...createSocialMetadata({
+        canonicalPath: resolved.page.path,
+        description: resolved.page.description,
+        manifest,
+        ogManifest,
+        title: resolved.page.title,
+        type: "article"
+      })
+    };
+  };
+}
+function createLeafStaticParams({ group, manifest }) {
+  return function generateStaticParams() {
+    return listStaticParams(manifest, group);
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  appendPoweredByFooter,
+  createLeafMetadata,
+  createLeafPage,
+  createLeafStaticParams
+});

package/dist/kernel/routes/pages/leaf.d.cts

@@ -0,0 +1,36 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { Metadata } from 'next';
+import { ReactElement, ReactNode } from 'react';
+import { PageProps, ManifestLike, ResolvedAttribution } from '../../../types.cjs';
+import { OgManifestLike } from '../metadata/og-image.cjs';
+
+type LeafComponent = (props: PageProps) => ReactElement | Promise<ReactElement>;
+type PoweredByFooterComponent = (props: {
+    attribution: ResolvedAttribution;
+}) => ReactElement | null;
+type LeafRouteConfig = {
+    group: string;
+    manifest: ManifestLike;
+    ogManifest?: OgManifestLike;
+    Leaf: LeafComponent;
+    PoweredByFooter?: PoweredByFooterComponent;
+};
+type PageRouteProps = {
+    params: Promise<{
+        slug?: string[];
+    }>;
+};
+declare function appendPoweredByFooter({ footer, node, }: {
+    footer: ReactElement;
+    node: ReactNode;
+}): {
+    node: ReactNode;
+    placed: boolean;
+};
+declare function createLeafPage({ group, manifest, Leaf, PoweredByFooter, }: LeafRouteConfig): ({ params }: PageRouteProps) => Promise<react_jsx_runtime.JSX.Element>;
+declare function createLeafMetadata({ group, manifest, ogManifest, }: LeafRouteConfig): ({ params, }: PageRouteProps) => Promise<Metadata>;
+declare function createLeafStaticParams({ group, manifest }: LeafRouteConfig): () => {
+    slug: string[];
+}[];
+
+export { type LeafComponent, type LeafRouteConfig, type PoweredByFooterComponent, appendPoweredByFooter, createLeafMetadata, createLeafPage, createLeafStaticParams };

package/dist/kernel/routes/pages/leaf.d.ts

@@ -0,0 +1,36 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { Metadata } from 'next';
+import { ReactElement, ReactNode } from 'react';
+import { PageProps, ManifestLike, ResolvedAttribution } from '../../../types.js';
+import { OgManifestLike } from '../metadata/og-image.js';
+
+type LeafComponent = (props: PageProps) => ReactElement | Promise<ReactElement>;
+type PoweredByFooterComponent = (props: {
+    attribution: ResolvedAttribution;
+}) => ReactElement | null;
+type LeafRouteConfig = {
+    group: string;
+    manifest: ManifestLike;
+    ogManifest?: OgManifestLike;
+    Leaf: LeafComponent;
+    PoweredByFooter?: PoweredByFooterComponent;
+};
+type PageRouteProps = {
+    params: Promise<{
+        slug?: string[];
+    }>;
+};
+declare function appendPoweredByFooter({ footer, node, }: {
+    footer: ReactElement;
+    node: ReactNode;
+}): {
+    node: ReactNode;
+    placed: boolean;
+};
+declare function createLeafPage({ group, manifest, Leaf, PoweredByFooter, }: LeafRouteConfig): ({ params }: PageRouteProps) => Promise<react_jsx_runtime.JSX.Element>;
+declare function createLeafMetadata({ group, manifest, ogManifest, }: LeafRouteConfig): ({ params, }: PageRouteProps) => Promise<Metadata>;
+declare function createLeafStaticParams({ group, manifest }: LeafRouteConfig): () => {
+    slug: string[];
+}[];
+
+export { type LeafComponent, type LeafRouteConfig, type PoweredByFooterComponent, appendPoweredByFooter, createLeafMetadata, createLeafPage, createLeafStaticParams };