@nexpress/core 0.1.0

package/dist/chunk-DP2PREDU.js

@@ -0,0 +1,597 @@
+import {
+  findDocuments
+} from "./chunk-VGTPQXNQ.js";
+import {
+  getI18nConfig
+} from "./chunk-4ZLMEKFX.js";
+import {
+  getAllCollectionSlugs,
+  getCollectionConfig
+} from "./chunk-FZ7O6DWI.js";
+import {
+  getDb
+} from "./chunk-XANPEOJC.js";
+import {
+  npSettings
+} from "./chunk-M43PGOQY.js";
+
+// src/seo/sitemap.ts
+var DEFAULT_LIMIT_PER_COLLECTION = 5e3;
+async function buildSitemap(options = {}) {
+  const limit = options.perCollectionLimit ?? DEFAULT_LIMIT_PER_COLLECTION;
+  const slugs = options.collections ?? getAllCollectionSlugs();
+  const entries = [];
+  const i18n = getI18nConfig();
+  const localeFilter = options.locale;
+  for (const slug of slugs) {
+    let config;
+    try {
+      config = getCollectionConfig(slug);
+    } catch {
+      continue;
+    }
+    const seo = config.seo;
+    if (!seo?.urlPath) continue;
+    if (localeFilter && !config.i18n) {
+      if (!i18n || localeFilter !== i18n.defaultLocale) continue;
+    }
+    let result;
+    try {
+      result = await findDocuments(
+        slug,
+        {
+          limit,
+          page: 1,
+          where: { status: "published" }
+          // For i18n collections we deliberately fetch *every*
+          // locale's rows even when a localeFilter is set so the
+          // grouping pass below can still build a complete
+          // hreflang-alternates list. The emission step further
+          // down filters siblings to the requested locale before
+          // pushing entries. Non-i18n collections take the
+          // localeFilter path through the early `continue` above.
+        },
+        // Anonymous — `access.read` must allow it for the row to
+        // appear. Collections gated to authenticated users won't
+        // throw here because the access check runs on the
+        // collection level (not per-row); they'll throw and we
+        // skip below.
+        void 0
+      );
+    } catch {
+      continue;
+    }
+    const docs = result.docs;
+    if (config.i18n) {
+      const groups = /* @__PURE__ */ new Map();
+      const orphans = [];
+      for (const doc of docs) {
+        const groupId = typeof doc.translationGroupId === "string" ? doc.translationGroupId : null;
+        if (!groupId) {
+          orphans.push(doc);
+          continue;
+        }
+        const list = groups.get(groupId);
+        if (list) list.push(doc);
+        else groups.set(groupId, [doc]);
+      }
+      for (const siblings of groups.values()) {
+        const alternates = [];
+        for (const sibling of siblings) {
+          const siblingPath = seo.urlPath(sibling);
+          const locale = typeof sibling.locale === "string" ? sibling.locale : null;
+          if (siblingPath && locale) {
+            alternates.push({ hreflang: locale, href: siblingPath });
+          }
+        }
+        for (const sibling of siblings) {
+          if (localeFilter) {
+            const siblingLocale = typeof sibling.locale === "string" ? sibling.locale : null;
+            if (siblingLocale !== localeFilter) continue;
+          }
+          const path = seo.urlPath(sibling);
+          if (!path || !path.startsWith("/")) continue;
+          entries.push({
+            loc: path,
+            lastmod: pickLastmod(sibling),
+            changefreq: seo.changefreq,
+            priority: seo.priority,
+            alternates: alternates.length > 1 ? alternates : void 0
+          });
+        }
+      }
+      for (const doc of orphans) {
+        if (localeFilter) {
+          const docLocale = typeof doc.locale === "string" ? doc.locale : null;
+          if (docLocale !== localeFilter) continue;
+        }
+        const path = seo.urlPath(doc);
+        if (!path || !path.startsWith("/")) continue;
+        entries.push({
+          loc: path,
+          lastmod: pickLastmod(doc),
+          changefreq: seo.changefreq,
+          priority: seo.priority
+        });
+      }
+      continue;
+    }
+    for (const doc of docs) {
+      const path = seo.urlPath(doc);
+      if (!path) continue;
+      if (!path.startsWith("/")) continue;
+      entries.push({
+        loc: path,
+        lastmod: pickLastmod(doc),
+        changefreq: seo.changefreq,
+        priority: seo.priority
+      });
+    }
+  }
+  return entries;
+}
+function pickLastmod(doc) {
+  const candidate = doc.updatedAt ?? doc.createdAt;
+  if (candidate instanceof Date) return candidate.toISOString();
+  if (typeof candidate === "string") {
+    const parsed = new Date(candidate);
+    if (!Number.isNaN(parsed.getTime())) return parsed.toISOString();
+  }
+  return void 0;
+}
+function renderSitemapXml(origin, entries) {
+  const trimmed = origin.replace(/\/+$/, "");
+  const usesAlternates = entries.some(
+    (e) => e.alternates && e.alternates.length > 0
+  );
+  const lines = [
+    '<?xml version="1.0" encoding="UTF-8"?>',
+    usesAlternates ? '<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" xmlns:xhtml="http://www.w3.org/1999/xhtml">' : '<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">'
+  ];
+  for (const entry of entries) {
+    lines.push("  <url>");
+    lines.push(`    <loc>${escapeXml(`${trimmed}${entry.loc}`)}</loc>`);
+    if (entry.lastmod) {
+      lines.push(`    <lastmod>${entry.lastmod}</lastmod>`);
+    }
+    if (entry.changefreq) {
+      lines.push(`    <changefreq>${entry.changefreq}</changefreq>`);
+    }
+    if (typeof entry.priority === "number") {
+      lines.push(`    <priority>${entry.priority.toFixed(1)}</priority>`);
+    }
+    if (entry.alternates) {
+      for (const alt of entry.alternates) {
+        lines.push(
+          `    <xhtml:link rel="alternate" hreflang="${escapeXml(alt.hreflang)}" href="${escapeXml(`${trimmed}${alt.href}`)}"/>`
+        );
+      }
+    }
+    lines.push("  </url>");
+  }
+  lines.push("</urlset>");
+  return lines.join("\n");
+}
+function renderSitemapIndexXml(origin, entries) {
+  const trimmed = origin.replace(/\/+$/, "");
+  const lines = [
+    '<?xml version="1.0" encoding="UTF-8"?>',
+    '<sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">'
+  ];
+  for (const entry of entries) {
+    lines.push("  <sitemap>");
+    lines.push(`    <loc>${escapeXml(`${trimmed}${entry.loc}`)}</loc>`);
+    if (entry.lastmod) {
+      lines.push(`    <lastmod>${entry.lastmod}</lastmod>`);
+    }
+    lines.push("  </sitemap>");
+  }
+  lines.push("</sitemapindex>");
+  return lines.join("\n");
+}
+function escapeXml(value) {
+  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
+}
+
+// src/seo/page-metadata.ts
+var DEFAULT_SITE_SEO_SETTINGS = {
+  siteName: "NexPress",
+  siteUrl: "http://localhost:3000",
+  defaultDescription: "",
+  defaultOgImage: null,
+  twitterHandle: null,
+  defaultLocale: "en_US"
+};
+async function getSiteSeoSettings() {
+  const db = getDb();
+  const rows = await db.select().from(npSettings);
+  const map = /* @__PURE__ */ new Map();
+  for (const row of rows) map.set(row.key, row.value);
+  const site = readObject(map.get("site"));
+  const seo = readObject(map.get("seo"));
+  const description = map.get("description");
+  return {
+    siteName: readString(site?.name) ?? DEFAULT_SITE_SEO_SETTINGS.siteName,
+    siteUrl: readString(site?.url) ?? DEFAULT_SITE_SEO_SETTINGS.siteUrl,
+    defaultDescription: (typeof description === "string" ? description : null) ?? DEFAULT_SITE_SEO_SETTINGS.defaultDescription,
+    defaultOgImage: readString(seo?.defaultOgImage) ?? DEFAULT_SITE_SEO_SETTINGS.defaultOgImage,
+    twitterHandle: readString(seo?.twitterHandle) ?? DEFAULT_SITE_SEO_SETTINGS.twitterHandle,
+    defaultLocale: readString(seo?.defaultLocale) ?? DEFAULT_SITE_SEO_SETTINGS.defaultLocale
+  };
+}
+function readObject(v) {
+  if (v && typeof v === "object" && !Array.isArray(v)) {
+    return v;
+  }
+  return null;
+}
+function readString(v) {
+  if (typeof v === "string" && v.trim().length > 0) return v.trim();
+  return null;
+}
+async function buildPageMetadata(input = {}) {
+  const settings = await getSiteSeoSettings();
+  const path = normalizePath(input.path);
+  const titleText = input.title?.trim() ? `${input.title.trim()} \xB7 ${settings.siteName}` : settings.siteName;
+  const descriptionText = input.description?.trim() ?? settings.defaultDescription;
+  const canonicalUrl = `${settings.siteUrl.replace(/\/+$/, "")}${path}`;
+  const ogImage = resolveOgImage(input.ogImage, settings);
+  const ogType = input.ogType ?? "website";
+  const metadata = {
+    title: titleText,
+    description: descriptionText,
+    alternates: { canonical: canonicalUrl },
+    openGraph: {
+      title: titleText,
+      description: descriptionText,
+      siteName: settings.siteName,
+      url: canonicalUrl,
+      type: ogType,
+      // Page-supplied locale wins over the site default so
+      // translated copies surface their actual language to
+      // social previews. Falls back to the site setting when
+      // the caller doesn't pass one (non-i18n routes).
+      locale: input.locale ?? settings.defaultLocale,
+      ...ogImage ? { images: [{ url: ogImage }] } : {},
+      ...ogType === "article" && input.publishedTime ? { publishedTime: input.publishedTime.toISOString() } : {},
+      ...ogType === "article" && input.modifiedTime ? { modifiedTime: input.modifiedTime.toISOString() } : {}
+    },
+    twitter: {
+      card: ogImage ? "summary_large_image" : "summary",
+      title: titleText,
+      description: descriptionText,
+      ...settings.twitterHandle ? { site: `@${settings.twitterHandle}` } : {},
+      ...ogImage ? { images: [ogImage] } : {}
+    }
+  };
+  return metadata;
+}
+function normalizePath(raw) {
+  if (!raw || !raw.startsWith("/")) return "/";
+  if (raw === "/") return "/";
+  return raw.replace(/\/+$/, "");
+}
+function resolveOgImage(pageImage, settings) {
+  const candidate = pageImage?.trim() || settings.defaultOgImage;
+  if (!candidate) return null;
+  if (/^https?:\/\//i.test(candidate)) return candidate;
+  if (candidate.startsWith("/")) {
+    return `${settings.siteUrl.replace(/\/+$/, "")}${candidate}`;
+  }
+  return candidate;
+}
+function validateSeoSettingsPatch(patch) {
+  if (!patch || typeof patch !== "object" || Array.isArray(patch)) {
+    throw new Error("Body must be a JSON object");
+  }
+  const raw = patch;
+  const out = {};
+  if ("defaultOgImage" in raw) {
+    const v = raw.defaultOgImage;
+    if (v === null || v === "") {
+      out.defaultOgImage = null;
+    } else if (typeof v === "string") {
+      const trimmed = v.trim();
+      if (!/^https?:\/\//i.test(trimmed) && !trimmed.startsWith("/")) {
+        throw new Error(
+          "defaultOgImage must be an absolute URL or a /-rooted path"
+        );
+      }
+      out.defaultOgImage = trimmed;
+    } else {
+      throw new Error("defaultOgImage must be a string or null");
+    }
+  }
+  if ("twitterHandle" in raw) {
+    const v = raw.twitterHandle;
+    if (v === null || v === "") {
+      out.twitterHandle = null;
+    } else if (typeof v === "string") {
+      const trimmed = v.trim().replace(/^@/, "");
+      if (!/^[A-Za-z0-9_]{1,15}$/.test(trimmed)) {
+        throw new Error(
+          "twitterHandle must be 1\u201315 alphanumeric/underscore characters"
+        );
+      }
+      out.twitterHandle = trimmed;
+    } else {
+      throw new Error("twitterHandle must be a string or null");
+    }
+  }
+  if ("defaultLocale" in raw) {
+    const v = raw.defaultLocale;
+    if (v === null || v === "") {
+      out.defaultLocale = null;
+    } else if (typeof v === "string") {
+      const trimmed = v.trim();
+      if (!/^[a-z]{2,3}(?:[_-][A-Za-z0-9]{2,8})?$/.test(trimmed)) {
+        throw new Error("defaultLocale must look like 'en' or 'en_US'");
+      }
+      out.defaultLocale = trimmed.replace("-", "_");
+    } else {
+      throw new Error("defaultLocale must be a string or null");
+    }
+  }
+  return out;
+}
+
+// src/seo/feed.ts
+var DEFAULT_FEED_LIMIT = 50;
+var DEFAULT_FEED_COLLECTION = "posts";
+async function buildAtomFeed(options = {}) {
+  const collection = options.collection ?? DEFAULT_FEED_COLLECTION;
+  const limit = options.limit ?? DEFAULT_FEED_LIMIT;
+  let config;
+  try {
+    config = getCollectionConfig(collection);
+  } catch {
+    return null;
+  }
+  const urlPath = config.seo?.urlPath;
+  if (!urlPath) return null;
+  const settings = await getSiteSeoSettings();
+  const origin = settings.siteUrl.replace(/\/+$/, "");
+  let result;
+  try {
+    result = await findDocuments(
+      collection,
+      {
+        where: { status: "published" },
+        limit,
+        page: 1,
+        sort: "-updatedAt",
+        // Phase 12.4 — when the caller passed a locale AND
+        // this collection is i18n-enabled, scope the feed to
+        // that locale. findDocuments() ignores `locale` for
+        // non-i18n collections so passing it unconditionally
+        // is safe; we still gate on config.i18n to keep the
+        // intent obvious to readers.
+        ...options.locale && config.i18n ? { locale: options.locale } : {}
+      },
+      void 0
+    );
+  } catch {
+    return null;
+  }
+  const entries = [];
+  for (const doc of result.docs) {
+    const path = urlPath(doc);
+    if (!path) continue;
+    const link = `${origin}${path}`;
+    const updated = pickIso(
+      doc.updatedAt ?? doc.createdAt
+    );
+    if (!updated) continue;
+    entries.push({
+      id: link,
+      title: pickTitle(doc),
+      summary: pickSummary(doc),
+      link,
+      author: pickAuthor(doc),
+      updated,
+      published: pickIso(
+        doc.publishedAt ?? doc.createdAt
+      )
+    });
+  }
+  const extras = options.extraEntries ?? [];
+  if (extras.length > 0) {
+    const seenIds = new Set(entries.map((e) => e.id));
+    for (const extra of extras) {
+      if (seenIds.has(extra.id)) continue;
+      seenIds.add(extra.id);
+      entries.push(extra);
+    }
+    entries.sort((a, b) => a.updated < b.updated ? 1 : -1);
+    if (entries.length > limit) entries.length = limit;
+  }
+  return { entries, collection };
+}
+function pickTitle(doc) {
+  if (typeof doc.title === "string" && doc.title.length > 0) return doc.title;
+  if (typeof doc.name === "string" && doc.name.length > 0) return doc.name;
+  if (typeof doc.slug === "string" && doc.slug.length > 0) return doc.slug;
+  return "Untitled";
+}
+function pickSummary(doc) {
+  for (const key of ["excerpt", "summary", "description", "seoDescription"]) {
+    const value = doc[key];
+    if (typeof value === "string" && value.trim().length > 0) {
+      const trimmed = value.trim();
+      return trimmed.length > 500 ? `${trimmed.slice(0, 497)}\u2026` : trimmed;
+    }
+  }
+  return null;
+}
+function pickAuthor(doc) {
+  if (typeof doc.authorName === "string" && doc.authorName.length > 0) {
+    return doc.authorName;
+  }
+  return null;
+}
+function pickIso(value) {
+  if (value instanceof Date) {
+    const time = value.getTime();
+    if (Number.isNaN(time)) return null;
+    return value.toISOString();
+  }
+  if (typeof value === "string") {
+    const parsed = new Date(value);
+    if (!Number.isNaN(parsed.getTime())) return parsed.toISOString();
+  }
+  return null;
+}
+async function renderAtomFeed(options = {}) {
+  const result = await buildAtomFeed(options);
+  if (!result) return null;
+  const settings = await getSiteSeoSettings();
+  const origin = settings.siteUrl.replace(/\/+$/, "");
+  const queryParts = [];
+  if (result.collection !== DEFAULT_FEED_COLLECTION) {
+    queryParts.push(`collection=${encodeURIComponent(result.collection)}`);
+  }
+  if (options.locale) {
+    queryParts.push(`locale=${encodeURIComponent(options.locale)}`);
+  }
+  const feedSelfUrl = `${origin}/feed.xml${queryParts.length ? `?${queryParts.join("&")}` : ""}`;
+  const updated = result.entries[0]?.updated ?? (/* @__PURE__ */ new Date()).toISOString();
+  const lines = [
+    '<?xml version="1.0" encoding="UTF-8"?>',
+    options.locale ? `<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="${escapeXml2(options.locale)}">` : '<feed xmlns="http://www.w3.org/2005/Atom">',
+    `  <title>${escapeXml2(settings.siteName)}</title>`,
+    settings.defaultDescription ? `  <subtitle>${escapeXml2(settings.defaultDescription)}</subtitle>` : "",
+    `  <id>${escapeXml2(feedSelfUrl)}</id>`,
+    `  <link rel="self" href="${escapeXml2(feedSelfUrl)}"/>`,
+    `  <link rel="alternate" type="text/html" href="${escapeXml2(origin)}/"/>`,
+    `  <updated>${updated}</updated>`
+  ];
+  for (const entry of result.entries) {
+    lines.push("  <entry>");
+    lines.push(`    <id>${escapeXml2(entry.id)}</id>`);
+    lines.push(`    <title>${escapeXml2(entry.title)}</title>`);
+    lines.push(
+      `    <link rel="alternate" type="text/html" href="${escapeXml2(entry.link)}"/>`
+    );
+    lines.push(`    <updated>${entry.updated}</updated>`);
+    if (entry.published) {
+      lines.push(`    <published>${entry.published}</published>`);
+    }
+    if (entry.author) {
+      lines.push("    <author>");
+      lines.push(`      <name>${escapeXml2(entry.author)}</name>`);
+      lines.push("    </author>");
+    }
+    if (entry.summary) {
+      lines.push(
+        `    <summary type="text">${escapeXml2(entry.summary)}</summary>`
+      );
+    }
+    lines.push("  </entry>");
+  }
+  lines.push("</feed>");
+  return lines.filter(Boolean).join("\n");
+}
+function escapeXml2(value) {
+  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
+}
+
+// src/seo/json-ld.ts
+var SCHEMA = "https://schema.org";
+async function resolveOrigin(ctx = {}) {
+  if (ctx.origin) return ctx.origin.replace(/\/+$/, "");
+  const settings = await getSiteSeoSettings();
+  return settings.siteUrl.replace(/\/+$/, "");
+}
+function absoluteUrl(origin, path) {
+  if (/^https?:\/\//i.test(path)) return path;
+  return `${origin}${path.startsWith("/") ? "" : "/"}${path}`;
+}
+async function buildWebSiteJsonLd(ctx = {}) {
+  const settings = await getSiteSeoSettings();
+  const origin = await resolveOrigin(ctx);
+  return {
+    "@context": SCHEMA,
+    "@type": "WebSite",
+    name: settings.siteName,
+    url: `${origin}/`,
+    potentialAction: {
+      "@type": "SearchAction",
+      target: {
+        "@type": "EntryPoint",
+        urlTemplate: `${origin}/search?q={search_term_string}`
+      },
+      "query-input": "required name=search_term_string"
+    }
+  };
+}
+async function buildArticleJsonLd(input, ctx = {}) {
+  const settings = await getSiteSeoSettings();
+  const origin = await resolveOrigin(ctx);
+  const out = {
+    "@context": SCHEMA,
+    "@type": input.type ?? "BlogPosting",
+    headline: input.headline,
+    url: input.url,
+    publisher: {
+      "@type": "Organization",
+      name: settings.siteName,
+      url: `${origin}/`
+    }
+  };
+  if (input.description) out.description = input.description;
+  if (input.image) out.image = absoluteUrl(origin, input.image);
+  const published = toIso(input.datePublished);
+  if (published) out.datePublished = published;
+  const modified = toIso(input.dateModified);
+  if (modified) out.dateModified = modified;
+  if (input.authorName) {
+    out.author = { "@type": "Person", name: input.authorName };
+  }
+  return out;
+}
+async function buildDiscussionForumPostingJsonLd(input, ctx = {}) {
+  const article = await buildArticleJsonLd(input, ctx);
+  return { ...article, "@type": "DiscussionForumPosting" };
+}
+async function buildPersonJsonLd(input, ctx = {}) {
+  const origin = await resolveOrigin(ctx);
+  const out = {
+    "@context": SCHEMA,
+    "@type": "Person",
+    name: input.name,
+    url: input.url
+  };
+  if (input.alternateName) out.alternateName = input.alternateName;
+  if (input.image) out.image = absoluteUrl(origin, input.image);
+  if (input.description) out.description = input.description;
+  return out;
+}
+function toIso(value) {
+  if (!value) return null;
+  if (value instanceof Date) {
+    if (Number.isNaN(value.getTime())) return null;
+    return value.toISOString();
+  }
+  if (typeof value === "string") {
+    const parsed = new Date(value);
+    if (!Number.isNaN(parsed.getTime())) return parsed.toISOString();
+  }
+  return null;
+}
+
+export {
+  buildSitemap,
+  renderSitemapXml,
+  renderSitemapIndexXml,
+  DEFAULT_SITE_SEO_SETTINGS,
+  getSiteSeoSettings,
+  buildPageMetadata,
+  validateSeoSettingsPatch,
+  buildAtomFeed,
+  renderAtomFeed,
+  buildWebSiteJsonLd,
+  buildArticleJsonLd,
+  buildDiscussionForumPostingJsonLd,
+  buildPersonJsonLd
+};
+//# sourceMappingURL=chunk-DP2PREDU.js.map