@scribe-atp/next 1.0.1 → 1.1.1

package/README.md

@@ -91,6 +91,23 @@ The metadata generators are opinionated by design. They produce complete, ready-
 
 Article metadata uses the cached `ArticleRef` snapshot already present in the site record — no extra network request per article at build time.
 
+### Standalone metadata helpers
+
+Outside the factory pattern, `articleMetadata` and `siteMetadata` are exported as standalone functions that accept an `Article`/`Site` object directly. These are useful when you're already fetching content yourself and just need the `Metadata` object:
+
+```ts
+import { articleMetadata, siteMetadata } from "@scribe-atp/next";
+import { fetchArticleBySlug, fetchSite } from "@scribe-atp/core";
+
+export async function generateMetadata({ params }: { params: { slug: string } }) {
+  const [{ article }, site] = await Promise.all([
+    fetchArticleBySlug("alice.bsky.social", "https://alice.bsky.social", params.slug),
+    fetchSite("alice.bsky.social", "https://alice.bsky.social"),
+  ]);
+  return articleMetadata(article, site);
+}
+```
+
 **Need custom metadata?** Call `fetchSite` or `fetchArticle` from `@scribe-atp/core` directly and compose your own `Metadata` object:
 
 ```ts

package/dist/index.cjs

@@ -20,8 +20,10 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  articleMetadata: () => articleMetadata,
   createScribeSite: () => createScribeSite,
-  createWellKnownHandler: () => createWellKnownHandler
+  createWellKnownHandler: () => createWellKnownHandler,
+  siteMetadata: () => siteMetadata
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -87,8 +89,55 @@ function createWellKnownHandler(author, publicationUrl) {
     return new Response(uri, { headers: { "Content-Type": "text/plain" } });
   };
 }
+
+// src/meta.ts
+var import_core2 = require("@scribe-atp/core");
+function articleMetadata(article, site) {
+  const canonicalUrl = (0, import_core2.buildCanonicalUrl)(article, site);
+  return {
+    title: `${article.title} \u2014 ${site.title}`,
+    description: article.description ?? void 0,
+    openGraph: {
+      type: "article",
+      title: article.title,
+      description: article.description ?? void 0,
+      url: canonicalUrl,
+      siteName: site.title,
+      ...article.splashImageUrl ? { images: [article.splashImageUrl] } : {}
+    },
+    twitter: {
+      card: article.splashImageUrl ? "summary_large_image" : "summary",
+      title: article.title,
+      description: article.description ?? void 0,
+      ...article.splashImageUrl ? { images: [article.splashImageUrl] } : {}
+    }
+  };
+}
+function siteMetadata(site) {
+  const siteUrl = `https://${site.url}${site.urlPrefix ? `/${site.urlPrefix}` : ""}`;
+  return {
+    title: site.title,
+    description: site.description ?? void 0,
+    openGraph: {
+      type: "website",
+      title: site.title,
+      description: site.description ?? void 0,
+      url: siteUrl,
+      siteName: site.title,
+      ...site.splashImageUrl ? { images: [site.splashImageUrl] } : {}
+    },
+    twitter: {
+      card: site.splashImageUrl ? "summary_large_image" : "summary",
+      title: site.title,
+      description: site.description ?? void 0,
+      ...site.splashImageUrl ? { images: [site.splashImageUrl] } : {}
+    }
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  articleMetadata,
   createScribeSite,
-  createWellKnownHandler
+  createWellKnownHandler,
+  siteMetadata
 });

package/dist/index.d.cts

@@ -1,4 +1,5 @@
 import { Metadata } from 'next';
+import { Article, Site } from '@scribe-atp/core';
 export { Article, ArticleRef, Site, SiteGroup } from '@scribe-atp/core';
 
 declare function createScribeSite(author: string, publicationUrl: string): {
@@ -19,4 +20,7 @@ declare function createScribeSite(author: string, publicationUrl: string): {
 };
 declare function createWellKnownHandler(author: string, publicationUrl: string): (request: Request) => Promise<Response>;
 
-export { createScribeSite, createWellKnownHandler };
+declare function articleMetadata(article: Article, site: Site): Metadata;
+declare function siteMetadata(site: Site): Metadata;
+
+export { articleMetadata, createScribeSite, createWellKnownHandler, siteMetadata };

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { Metadata } from 'next';
+import { Article, Site } from '@scribe-atp/core';
 export { Article, ArticleRef, Site, SiteGroup } from '@scribe-atp/core';
 
 declare function createScribeSite(author: string, publicationUrl: string): {
@@ -19,4 +20,7 @@ declare function createScribeSite(author: string, publicationUrl: string): {
 };
 declare function createWellKnownHandler(author: string, publicationUrl: string): (request: Request) => Promise<Response>;
 
-export { createScribeSite, createWellKnownHandler };
+declare function articleMetadata(article: Article, site: Site): Metadata;
+declare function siteMetadata(site: Site): Metadata;
+
+export { articleMetadata, createScribeSite, createWellKnownHandler, siteMetadata };

package/dist/index.js

@@ -60,7 +60,54 @@ function createWellKnownHandler(author, publicationUrl) {
     return new Response(uri, { headers: { "Content-Type": "text/plain" } });
   };
 }
+
+// src/meta.ts
+import { buildCanonicalUrl } from "@scribe-atp/core";
+function articleMetadata(article, site) {
+  const canonicalUrl = buildCanonicalUrl(article, site);
+  return {
+    title: `${article.title} \u2014 ${site.title}`,
+    description: article.description ?? void 0,
+    openGraph: {
+      type: "article",
+      title: article.title,
+      description: article.description ?? void 0,
+      url: canonicalUrl,
+      siteName: site.title,
+      ...article.splashImageUrl ? { images: [article.splashImageUrl] } : {}
+    },
+    twitter: {
+      card: article.splashImageUrl ? "summary_large_image" : "summary",
+      title: article.title,
+      description: article.description ?? void 0,
+      ...article.splashImageUrl ? { images: [article.splashImageUrl] } : {}
+    }
+  };
+}
+function siteMetadata(site) {
+  const siteUrl = `https://${site.url}${site.urlPrefix ? `/${site.urlPrefix}` : ""}`;
+  return {
+    title: site.title,
+    description: site.description ?? void 0,
+    openGraph: {
+      type: "website",
+      title: site.title,
+      description: site.description ?? void 0,
+      url: siteUrl,
+      siteName: site.title,
+      ...site.splashImageUrl ? { images: [site.splashImageUrl] } : {}
+    },
+    twitter: {
+      card: site.splashImageUrl ? "summary_large_image" : "summary",
+      title: site.title,
+      description: site.description ?? void 0,
+      ...site.splashImageUrl ? { images: [site.splashImageUrl] } : {}
+    }
+  };
+}
 export {
+  articleMetadata,
   createScribeSite,
-  createWellKnownHandler
+  createWellKnownHandler,
+  siteMetadata
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scribe-atp/next",
-  "version": "1.0.1",
+  "version": "1.1.1",
   "description": "Next.js App Router adapter for reading Scribe CMS content from the AT Protocol.",
   "license": "MIT",
   "engines": {