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

package/dist/{pages → kernel/routes/pages}/group.cjs

@@ -17,7 +17,7 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// src/pages/group.tsx
+// src/kernel/routes/pages/group.tsx
 var group_exports = {};
 __export(group_exports, {
   createGroupMetadata: () => createGroupMetadata,
@@ -73,14 +73,18 @@ var tags = {
   },
   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) console.debug("[publish.os:debug]", ...args);
+    if (isDev && isDebugEnabled) console.debug("[publish.os:debug]", ...args);
   },
   info(...args) {
     console.log("[publish.os]", ...args);
@@ -116,7 +120,89 @@ function resolveGroup(manifest, group) {
   };
 }
 
-// src/pages/group.tsx
+// src/kernel/routes/pages/agent-metadata.ts
+function normalizePath(path) {
+  const prefixed = path.startsWith("/") ? path : `/${path}`;
+  if (prefixed === "/") return prefixed;
+  return prefixed.replace(/\/+$/, "");
+}
+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/group.tsx
 var import_jsx_runtime = require("react/jsx-runtime");
 var manifests = /* @__PURE__ */ new Map();
 var indexPages = /* @__PURE__ */ new Map();
@@ -147,12 +233,27 @@ function createGroupPage({
 }
 function createGroupMetadata({
   group,
-  manifest
+  manifest,
+  ogManifest
 }) {
   const groupData = manifest.groups[group];
+  const title = groupData?.title ?? group;
+  const description = manifest.site.description;
+  const canonicalPath = groupData?.path ?? `/${group}`;
   return {
-    title: groupData?.title ?? group,
-    description: manifest.site.description
+    title,
+    description,
+    alternates: groupData ? agentReadableAlternates({
+      canonicalPath: groupData.path,
+      manifest
+    }) : void 0,
+    ...createSocialMetadata({
+      canonicalPath,
+      description,
+      manifest,
+      ogManifest,
+      title
+    })
   };
 }
 // Annotate the CommonJS export names for ESM import in node:

package/dist/{pages → kernel/routes/pages}/group.d.cts

@@ -1,15 +1,17 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { Metadata } from 'next';
 import { ReactElement } from 'react';
-import { ManifestLike, IndexPageProps } from '../types.cjs';
+import { ManifestLike, IndexPageProps } from '../../../types.cjs';
+import { OgManifestLike } from '../metadata/og-image.cjs';
 
 type IndexPageComponent = (props: IndexPageProps) => ReactElement | Promise<ReactElement>;
 type GroupRouteConfig = {
     group: string;
     manifest: ManifestLike;
+    ogManifest?: OgManifestLike;
     IndexPage: IndexPageComponent;
 };
 declare function createGroupPage({ group, manifest, IndexPage, }: GroupRouteConfig): () => Promise<react_jsx_runtime.JSX.Element>;
-declare function createGroupMetadata({ group, manifest, }: GroupRouteConfig): Metadata;
+declare function createGroupMetadata({ group, manifest, ogManifest, }: GroupRouteConfig): Metadata;
 
 export { type GroupRouteConfig, type IndexPageComponent, createGroupMetadata, createGroupPage };

package/dist/{pages → kernel/routes/pages}/group.d.ts

@@ -1,15 +1,17 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { Metadata } from 'next';
 import { ReactElement } from 'react';
-import { ManifestLike, IndexPageProps } from '../types.js';
+import { ManifestLike, IndexPageProps } from '../../../types.js';
+import { OgManifestLike } from '../metadata/og-image.js';
 
 type IndexPageComponent = (props: IndexPageProps) => ReactElement | Promise<ReactElement>;
 type GroupRouteConfig = {
     group: string;
     manifest: ManifestLike;
+    ogManifest?: OgManifestLike;
     IndexPage: IndexPageComponent;
 };
 declare function createGroupPage({ group, manifest, IndexPage, }: GroupRouteConfig): () => Promise<react_jsx_runtime.JSX.Element>;
-declare function createGroupMetadata({ group, manifest, }: GroupRouteConfig): Metadata;
+declare function createGroupMetadata({ group, manifest, ogManifest, }: GroupRouteConfig): Metadata;
 
 export { type GroupRouteConfig, type IndexPageComponent, createGroupMetadata, createGroupPage };

package/dist/{pages → kernel/routes/pages}/group.js

@@ -1,4 +1,4 @@
-// src/pages/group.tsx
+// src/kernel/routes/pages/group.tsx
 import { cacheLife, cacheTag } from "next/cache";
 import { notFound } from "next/navigation";
 
@@ -48,14 +48,18 @@ var tags = {
   },
   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) console.debug("[publish.os:debug]", ...args);
+    if (isDev && isDebugEnabled) console.debug("[publish.os:debug]", ...args);
   },
   info(...args) {
     console.log("[publish.os]", ...args);
@@ -91,7 +95,89 @@ function resolveGroup(manifest, group) {
   };
 }
 
-// src/pages/group.tsx
+// src/kernel/routes/pages/agent-metadata.ts
+function normalizePath(path) {
+  const prefixed = path.startsWith("/") ? path : `/${path}`;
+  if (prefixed === "/") return prefixed;
+  return prefixed.replace(/\/+$/, "");
+}
+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/group.tsx
 import { jsx } from "react/jsx-runtime";
 var manifests = /* @__PURE__ */ new Map();
 var indexPages = /* @__PURE__ */ new Map();
@@ -122,12 +208,27 @@ function createGroupPage({
 }
 function createGroupMetadata({
   group,
-  manifest
+  manifest,
+  ogManifest
 }) {
   const groupData = manifest.groups[group];
+  const title = groupData?.title ?? group;
+  const description = manifest.site.description;
+  const canonicalPath = groupData?.path ?? `/${group}`;
   return {
-    title: groupData?.title ?? group,
-    description: manifest.site.description
+    title,
+    description,
+    alternates: groupData ? agentReadableAlternates({
+      canonicalPath: groupData.path,
+      manifest
+    }) : void 0,
+    ...createSocialMetadata({
+      canonicalPath,
+      description,
+      manifest,
+      ogManifest,
+      title
+    })
   };
 }
 export {