ferst-core 0.1.0 → 0.2.0

package/content/filters.ts

@@ -1,107 +0,0 @@
-// Named predicates for the content collection filters used across the
-// /posts/* page routes.
-//
-// Why this lives here:
-//   - DRY: each rule is defined once instead of duplicated as an inline
-//     arrow at every call site.
-//   - Testable: pure functions over Post data, no Astro runtime needed.
-//   - Self-documenting: at the page, `getCollection('posts', forArchive)`
-//     reads better than the equivalent arrow.
-//
-// Visibility model encoded here:
-//   - `draft` and `scheduled` posts are never visible (no listing, no detail
-//     page). A `scheduled` post is content that has been written ahead of time:
-//     a cron worker flips it to `published` once its `date` has passed, which
-//     is the only thing that makes it appear. Until then it is hidden exactly
-//     like a draft.
-//   - `published`: appear on /posts/ (paginated index); anything beyond
-//     `LATEST_NEWS_MAX` newest also appears on /posts/archive/ alongside
-//     posts explicitly marked `archived`.
-//   - `archived` posts appear on /posts/archive/ (and still get
-//     /posts/<slug>/).
-//   - "Newsletter" is a tag, not a separate content type — a post tagged
-//     `newsletter` is otherwise an ordinary post (same schema, same
-//     `/posts/<slug>/` detail page, same listing/archive rules above) that
-//     just typically has no body, only an attachment. `/posts/tag/newsletter/`
-//     is the generic per-tag archive every tag gets for free, no bespoke
-//     route needed.
-import type { CollectionEntry } from 'astro:content';
-import type { Post } from './schemas';
-
-type PostEntry = { data: Post };
-
-/** How many published news posts headline /posts/ before they roll into /posts/archive/. */
-export const LATEST_NEWS_MAX = 6;
-
-/**
- * Statuses that are never shown on the public site — no listing, no detail
- * page. `scheduled` joins `draft` here: it stays invisible until the cron
- * worker promotes it to `published`.
- */
-const isHidden = ({ data }: PostEntry): boolean =>
-  data.status === 'draft' || data.status === 'scheduled';
-
-/** Listed on /posts/ (the news index). */
-export function forLatestListing(entry: PostEntry): boolean {
-  return entry.data.status === 'published';
-}
-
-/** Has a generated /posts/<slug>/ detail page. Includes archived posts. */
-export function forLatestDetail(entry: PostEntry): boolean {
-  return !isHidden(entry);
-}
-
-/**
- * Single-entry archive predicate (tests, CMS docs). The live /posts/archive/
- * list is built with `buildArchiveListing` (archived + published overflow).
- */
-export function forArchive(entry: PostEntry): boolean {
-  return entry.data.status === 'archived';
-}
-
-/**
- * /posts/archive/: all `archived` posts, plus `published` news that are not
- * among the `LATEST_NEWS_MAX` newest (same date order as /posts/).
- */
-export function buildArchiveListing(
-  publishedPosts: CollectionEntry<'posts'>[],
-  archivedPosts: CollectionEntry<'posts'>[]
-): CollectionEntry<'posts'>[] {
-  const sorted = [...publishedPosts].sort(
-    (a, b) => b.data.date.valueOf() - a.data.date.valueOf()
-  );
-  const afterLatest = sorted.slice(LATEST_NEWS_MAX);
-  return [...archivedPosts, ...afterLatest].sort(
-    (a, b) => b.data.date.valueOf() - a.data.date.valueOf()
-  );
-}
-
-/** Back link on a news article under /posts/ (archive vs main list; same cut-off as LATEST_NEWS_MAX). */
-export function newsDetailBackLink(
-  post: CollectionEntry<'posts'>,
-  publishedPosts: CollectionEntry<'posts'>[]
-): { href: string; label: string } {
-  if (post.data.status === 'archived') {
-    return { href: '/posts/archive/', label: '← Back to archive' };
-  }
-  const sorted = [...publishedPosts].sort(
-    (a, b) => b.data.date.valueOf() - a.data.date.valueOf()
-  );
-  const topIds = new Set(sorted.slice(0, LATEST_NEWS_MAX).map((p) => p.id));
-  if (topIds.has(post.id)) {
-    return { href: '/posts/', label: '← Back to all news' };
-  }
-  return { href: '/posts/archive/', label: '← Back to archive' };
-}
-
-/**
- * A body-less post with an attachment (the typical newsletter shape) has
- * nothing to show on a `/posts/<slug>/` detail page, so its card/row should
- * open the attachment directly instead of linking internally. An ordinary
- * post that happens to also carry an attachment still opens its detail page
- * (where the attachment is offered as a separate link) since there's a body
- * worth reading first.
- */
-export function opensAttachmentDirectly(entry: PostEntry & { body?: string }): boolean {
-  return Boolean(entry.data.attachment) && !entry.body?.trim();
-}

package/lib/mailLinks.ts

@@ -1,13 +0,0 @@
-/**
- * Build a single well-formed mailto URI for use in `<a href>`.
- * Strips duplicated `mailto:` prefixes (CMS / paste errors) without
- * rewriting valid `?subject=` / `&body=` query pairs on the remainder.
- */
-export function normalizeMailtoHref(raw: string): string {
-  let s = raw.trim();
-  while (s.toLowerCase().startsWith('mailto:')) {
-    s = s.slice(7).trimStart();
-  }
-  if (!s) return '';
-  return `mailto:${s}`;
-}

package/lib/mapsLink.ts

@@ -1,7 +0,0 @@
-/**
- * Free-form maps query → real URL. encodeURIComponent for safety; the live
- * site has historically used `+` for spaces — both are equivalent to Google.
- */
-export function mapsLink(query: string): string {
-  return `https://maps.google.com/?q=${encodeURIComponent(query)}`;
-}

package/utils/excerpt.ts

@@ -1,56 +0,0 @@
-/**
- * Cheap markdown → plaintext for listing cards and meta descriptions.
- * Not a full parser; tuned for news-style Markdown (headings, links, emphasis).
- */
-export function markdownToPlainText(markdown: string, maxInputChars = 8000): string {
-  let s = markdown.length > maxInputChars ? markdown.slice(0, maxInputChars) : markdown;
-  s = s.replace(/\r\n/g, '\n');
-  // Drop fenced code (and inline code ticks)
-  s = s.replace(/```[\s\S]*?```/g, ' ');
-  s = s.replace(/`[^`]*`/g, ' ');
-  // Images ![alt](url) → alt text
-  s = s.replace(/!\[([^\]]*)\]\([^)]*\)/g, '$1 ');
-  // Links [text](url) → text
-  s = s.replace(/\[([^\]]*)\]\([^)]*\)/g, '$1 ');
-  s = s.replace(/\[([^\]]+)\]\[[^\]]*]/g, '$1 ');
-  // ATX headings
-  s = s.replace(/^#{1,6}\s+(.+)$/gm, '$1 ');
-  // Setext-style underline headings (rare)
-  s = s.replace(/^\s*[-=]{2,}\s*$/gm, ' ');
-  // Blockquotes, lists
-  s = s.replace(/^>\s?/gm, '');
-  s = s.replace(/^[\t ]*[-*+]\s+/gm, '');
-  s = s.replace(/^\d+\.\s+/gm, '');
-  // HR
-  s = s.replace(/^[\t ]*[-*_]{3,}[\t ]*$/gm, ' ');
-  // Bold / italic (nested patterns handled loosely)
-  s = s.replace(/\*\*([^*]+)\*\*/g, '$1');
-  s = s.replace(/\*([^*]+)\*/g, '$1');
-  s = s.replace(/__([^_]+)__/g, '$1');
-  s = s.replace(/_([^_]+)_/g, '$1');
-  // Strip simple HTML / MDX-looking tags
-  s = s.replace(/<[^>]+>/g, ' ');
-  s = s.replace(/\n+/g, ' ');
-  s = s.replace(/\s+/g, ' ').trim();
-  return s;
-}
-
-/**
- * Plaintext suitable for cards (word-boundary trim + ellipsis).
- */
-export function plainTextExcerpt(markdown: string, maxChars = 220): string {
-  const plain = markdownToPlainText(markdown);
-  if (!plain) return '';
-  if (plain.length <= maxChars) return plain;
-  const slice = plain.slice(0, maxChars);
-  const lastSpace = slice.lastIndexOf(' ');
-  const cut = lastSpace > maxChars * 0.55 ? slice.slice(0, lastSpace) : slice;
-  return `${cut.replace(/[.,;:!?…\s]+$/u, '').trim()}…`;
-}
-
-/**
- * Shorter blurb for `<meta name="description">` and Open Graph.
- */
-export function metaDescriptionFromBody(markdown: string, maxChars = 155): string {
-  return plainTextExcerpt(markdown, maxChars);
-}

package/utils/formatDate.ts

@@ -1,22 +0,0 @@
-/**
- * Single source for the "30 April 2026" date label used across post cards,
- * the post detail page, and the newsletter listing. Pulling it out of four
- * inline `toLocaleDateString(...)` calls means a future change to the
- * format (e.g. add weekday, switch to a relative label) is one edit.
- */
-
-const DEFAULT_OPTIONS: Intl.DateTimeFormatOptions = {
-  day: 'numeric',
-  month: 'long',
-  year: 'numeric',
-};
-
-const DEFAULT_LOCALE = 'en-GB';
-
-export function formatDate(
-  date: Date,
-  options: Intl.DateTimeFormatOptions = DEFAULT_OPTIONS,
-  locale: string = DEFAULT_LOCALE,
-): string {
-  return date.toLocaleDateString(locale, options);
-}

package/utils/freshness.ts

@@ -1,5 +0,0 @@
-export const FRESH_WINDOW_MS = 3 * 24 * 60 * 60 * 1000;
-
-export function isFreshPost(date: Date, now: number = Date.now()): boolean {
-  return now - date.valueOf() < FRESH_WINDOW_MS;
-}