@sarimarcus/content-sites-core 0.16.0 → 0.18.0

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 All packages in the platform release in lockstep; entries are per release version.
 
+## 0.18.0 (2026-10-02)
+
+- `./url`: `articleFeedItem(article, site, author?)` builds one @astrojs/rss item (relative `/articles/<slug>` link, date-only values read as noon UTC, the OG image as `media:content`) (SLA-2744).
+
+## 0.17.0 (2026-10-01)
+
+- No changes; released in lockstep (SLA-2741).
+
 ## 0.16.0 (2026-10-01)
 
 - `./config`: `PAGEFIND_EXCLUDE_SELECTORS`, the selectors `defineSiteConfig` passes to Pagefind, now exported (SLA-2735).

package/dist/url/feed.d.ts

@@ -0,0 +1,20 @@
+export interface FeedArticle {
+    title: string;
+    description: string;
+    /** ISO datetime with offset; a legacy date-only value is read as noon UTC. */
+    datePublished: string;
+    slug: string;
+}
+export interface FeedItem {
+    title: string;
+    description: string;
+    pubDate: Date;
+    link: string;
+    customData: string;
+    author?: string;
+}
+/**
+ * One @astrojs/rss item for an article: a relative /articles/<slug> link (resolved against the feed's `site`) and its
+ * 1200×675 OG image as `media:content`, so the feed needs `xmlns: { media: 'http://search.yahoo.com/mrss/' }`.
+ */
+export declare function articleFeedItem(article: FeedArticle, site: URL, author?: string): FeedItem;

package/dist/url/feed.js

@@ -0,0 +1,16 @@
+import { getOgImagePath } from "./ogImage.js";
+/**
+ * One @astrojs/rss item for an article: a relative /articles/<slug> link (resolved against the feed's `site`) and its
+ * 1200×675 OG image as `media:content`, so the feed needs `xmlns: { media: 'http://search.yahoo.com/mrss/' }`.
+ */
+export function articleFeedItem(article, site, author) {
+    const { datePublished } = article;
+    return {
+        title: article.title,
+        description: article.description,
+        pubDate: datePublished.includes('T') ? new Date(datePublished) : new Date(`${datePublished}T12:00:00+00:00`),
+        link: `/articles/${article.slug}`,
+        customData: `<media:content url="${new URL(getOgImagePath('articles', article.slug), site)}" medium="image" type="image/jpeg" width="1200" height="675" />`,
+        ...(author ? { author } : {}),
+    };
+}

package/dist/url/index.d.ts

@@ -2,3 +2,5 @@ export { url, normalizePagePath, toAbsoluteSiteUrl, normalizeSiteUrl } from './u
 export { getOgImagePath } from './ogImage.ts';
 export { normalizeHref, extractProseHrefs, dedupRelated } from './relatedDedup.ts';
 export { buildImageMap, keyBySlug } from './imageMap.ts';
+export { articleFeedItem } from './feed.ts';
+export type { FeedArticle, FeedItem } from './feed.ts';

package/dist/url/index.js

@@ -3,3 +3,4 @@ export { url, normalizePagePath, toAbsoluteSiteUrl, normalizeSiteUrl } from "./u
 export { getOgImagePath } from "./ogImage.js";
 export { normalizeHref, extractProseHrefs, dedupRelated } from "./relatedDedup.js";
 export { buildImageMap, keyBySlug } from "./imageMap.js";
+export { articleFeedItem } from "./feed.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sarimarcus/content-sites-core",
-  "version": "0.16.0",
+  "version": "0.18.0",
   "description": "Non-visual utilities, Astro config builders and SEO schema assembly shared by the content sites.",
   "type": "module",
   "license": "MIT",

package/src/url/feed.ts

@@ -0,0 +1,34 @@
+import { getOgImagePath } from './ogImage.ts';
+
+export interface FeedArticle {
+  title: string;
+  description: string;
+  /** ISO datetime with offset; a legacy date-only value is read as noon UTC. */
+  datePublished: string;
+  slug: string;
+}
+
+export interface FeedItem {
+  title: string;
+  description: string;
+  pubDate: Date;
+  link: string;
+  customData: string;
+  author?: string;
+}
+
+/**
+ * One @astrojs/rss item for an article: a relative /articles/<slug> link (resolved against the feed's `site`) and its
+ * 1200×675 OG image as `media:content`, so the feed needs `xmlns: { media: 'http://search.yahoo.com/mrss/' }`.
+ */
+export function articleFeedItem(article: FeedArticle, site: URL, author?: string): FeedItem {
+  const { datePublished } = article;
+  return {
+    title: article.title,
+    description: article.description,
+    pubDate: datePublished.includes('T') ? new Date(datePublished) : new Date(`${datePublished}T12:00:00+00:00`),
+    link: `/articles/${article.slug}`,
+    customData: `<media:content url="${new URL(getOgImagePath('articles', article.slug), site)}" medium="image" type="image/jpeg" width="1200" height="675" />`,
+    ...(author ? { author } : {}),
+  };
+}

package/src/url/index.ts

@@ -3,3 +3,5 @@ export { url, normalizePagePath, toAbsoluteSiteUrl, normalizeSiteUrl } from './u
 export { getOgImagePath } from './ogImage.ts';
 export { normalizeHref, extractProseHrefs, dedupRelated } from './relatedDedup.ts';
 export { buildImageMap, keyBySlug } from './imageMap.ts';
+export { articleFeedItem } from './feed.ts';
+export type { FeedArticle, FeedItem } from './feed.ts';