Skip to content

emdash

v@emdash-cms/[email protected] Breaking

This release includes 2 breaking changes for platform teams planning a safe upgrade.

Published 1mo Productivity & Wikis
✓ No known CVEs patched
Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Topics

astro cms emdash typescript

Affected surfaces

breaking_upgrade

ReleasePort's take

Light signal
editorial:auto 1mo

The release adds a scheduled publishing sweep and mandates Cloudflare Workers sites to add a Cron Trigger plus update their entry point for this feature.

Why it matters: Operators must modify Worker configurations before the new version, or publishing will fail; failure triggers affect all content slated for automated publication.

Summary

AI summary

Updates Minor Changes, Patch Changes, and https://github.com/ascorbic across a mixed release.

Changes in this release

Breaking High

Requires Cloudflare Workers sites to add Cron Trigger and update entry point for scheduled publishing.

Requires Cloudflare Workers sites to add Cron Trigger and update entry point for scheduled publishing.

Source: llm_adapter@2026-06-12

Confidence: high

Feature Medium

Adds scheduled publishing sweep that transitions content to published at its due time.

Adds scheduled publishing sweep that transitions content to published at its due time.

Source: llm_adapter@2026-06-12

Confidence: high

Dependency Low

Updated dependencies; emdash upgraded to version 0.19.0.

Updated dependencies; emdash upgraded to version 0.19.0.

Source: llm_adapter@2026-06-12

Confidence: high

Full changelog

Minor Changes

  • #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

Breaking Changes

  • Removal of `PiggybackScheduler` in Cloudflare Worker entry; existing deployments must replace with `@emdash-cms/cloudflare/worker` and add a Cron Trigger (`"crons": ["* * * * *"]`) to wrangler.jsonc.
  • Minimum version bump: @emdash-cms/cloudflare now requires Node.js >= 18.17 or equivalent Cloudflare Workers runtime supporting Cron Triggers.

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

Share this release

Track emdash

Get notified when new releases ship.

Sign up free

About emdash

All releases →

Related context

Related tools

Earlier breaking changes

Beta — feedback welcome: [email protected]