emdash-cms/emdash emdash@0.19.0

on GitHub

Minor Changes

• #1442 e96587f Thanks @ascorbic! - Add status, author, and date-range filtering to the admin content list (#1288). The content list API gains authorId, dateField, dateFrom, and dateTo query params (all additive and optional), and a new GET /_emdash/api/content/{collection}/authors endpoint lists the distinct authors of a collection's content (gated on content:read). Filtering runs server-side, so it works across the whole collection rather than only the loaded page.

• #1439 023893a Thanks @ascorbic! - Add content filtering by byline credit. getEmDashCollection now accepts a reserved byline key in where that returns entries credited to a byline in any position, including co-authored entries where the byline is a secondary credit. This makes author archive pages possible without querying the database directly. Pass a single byline translation group or an array to match any of several.

  const byline = await getBylineBySlug("jane-doe");
  const { entries } = await getEmDashCollection("posts", {
  	where: { byline: byline.translationGroup ?? byline.id },
  	orderBy: { published_at: "desc" },
  });

  A getEntriesByByline(collection, byline, options) helper wraps the same filter, mirroring getEntriesByTerm.

• #1367 f41092b Thanks @MA2153! - Add content-reference database schema: _emdash_relations (relationship-type definitions, row-per-locale) and _emdash_content_references (directed, locale-agnostic edges between content entries linked by translation_group). Additive, forward-only migration 043; no existing tables change. Groundwork for reference fields — no field type, API, or admin UI yet.

• #1438 850c1b7 Thanks @ascorbic! - Generate responsive srcsets for media rendered with the Image and Portable Text image components. EmDash now routes locally/R2-stored media through Astro's configured image service (astro:assets) -- the Cloudflare Images binding on Workers, sharp on Node -- producing width-appropriate candidates and modern formats (e.g. WebP) instead of a single full-size <img>.

  This works automatically:

  • Media served from a configured storage publicUrl (R2 custom domain, S3/CDN) is authorized and optimized.
  • Same-origin proxied media (local storage, or R2 without a public URL) is optimized when siteUrl is set; the matching image.remotePatterns entry is registered for you, scoped to the media route.
  • In astro dev it works out of the box without configuration.

  When optimization isn't possible (no image service available, an unauthorized host, or unknown dimensions) the components fall back to a plain <img>, so existing sites keep rendering exactly as before. No template changes are required.

• #1312 c39789c Thanks @ascorbic! - Drive scheduled publishing from a real heartbeat instead of request side effects (#1303).

  Content scheduled via the admin now actually transitions to published when its time arrives. Previously nothing promoted the row — status stayed scheduled and published_at stayed null forever.

  A new sweep (publishDueContent) promotes due content and runs alongside the existing cron tick and system cleanup:

  • Node / single-process: the timer-based scheduler already drives it — no action needed.
  • Cloudflare Workers: a scheduled() handler driven by a Cron Trigger now runs the sweep. The request-driven PiggybackScheduler is gone, so there are no maintenance side effects on visitor requests.

  @emdash-cms/cloudflare ships a Worker entry that wraps Astro's handler with the scheduled() handler (@emdash-cms/cloudflare/worker, plus createScheduledHandler() for hand-assembled Workers). When a cache provider is configured, the handler also purges edge-cache tags for whatever it published, so stale snapshots produced before the scheduled time are evicted.

  Migration for existing Cloudflare sites. New sites get this from the templates. Existing deployments must update two files:

  // src/worker.ts
  export { default, PluginBridge } from "@emdash-cms/cloudflare/worker";

  // wrangler.jsonc
  "triggers": { "crons": ["* * * * *"] }

  Without the Cron Trigger, scheduled publishing and plugin cron do not run on Workers.

  Scheduled publishing matches manual publishing exactly: it fires content:afterPublish hooks (search indexing, webhooks, syndication), and records the scheduled time as published_at on first publication rather than the (later) sweep time. The sweep claims each row atomically before promoting it, so an entry unscheduled or rescheduled just before its time is never published, and overlapping sweeps can't double-publish. Local astro dev keeps running the timer-driven sweep even under the Cloudflare adapter (where production relies on the Cron Trigger).

  Each tick promotes at most 100 items per collection (a large backlog drains over successive ticks) so a single Worker invocation can't exhaust its CPU/subrequest budget, and edge-cache tags are purged incrementally after each collection's batch rather than only at the end. On Node, the maintenance interval is capped at 60s so scheduled-publish latency matches the Cloudflare Cron Trigger cadence instead of lagging up to five minutes when no plugin cron is due.

Patch Changes

• #1307 cedfcc5 Thanks @emdashbot! - Read ?locale= in content write routes (DELETE, publish, unpublish, discard-draft, schedule, unschedule) and forward it to handleContentGet for locale-aware slug resolution (#1242)

• #1420 c63f9ca Thanks @swissky! - getTaxonomyTerms() now returns the term description for flat
  (non-hierarchical) taxonomies (#1419)

  The query already fetched the data column, but the non-hierarchical branch
  dropped it when mapping rows to TaxonomyTerm — only hierarchical taxonomies
  (via buildTree) parsed the description. Descriptions set in the admin UI are
  now returned for both kinds of taxonomies.

• #1426 61ea3c9 Thanks @MA2153! - Fix seed CLI hardcoding en as the default locale (#1421)

  emdash export-seed now emits a top-level defaultLocale for single-locale
  projects, and emdash seed (applySeed) honors it when backfilling the locale
  of menus, taxonomies, and content rows that omit an explicit locale. Previously
  an export-seed → seed round-trip silently rewrote a non-en default locale
  (e.g. de) to en, since the CLI runs outside the Astro runtime and the
  fallback collapsed to en. Projects whose default locale is en are unaffected.

• #1445 a4c2af2 Thanks @ascorbic! - Fix getEmDashEntry / getEmDashCollection hydrating taxonomy terms in the request-context or default locale instead of the entry's resolved locale (#1441). When querying with an explicit locale (or via a localized route), entry.data.terms could return default-locale term variants even though the content row was correctly localized. Term hydration now uses the same resolved locale as the content query.

• Updated dependencies [e96587f, cedfcc5, 7e70abc, 783e663, 157237d]:

  • @emdash-cms/admin@0.19.0
  • @emdash-cms/auth@0.19.0
  • @emdash-cms/gutenberg-to-portable-text@0.19.0