Patch Changes
-
#3515
d274172Thanks @ascorbic! - Releases EmDash 1.0. This release includes breaking changes, such as removing APIs deprecated during 0.x. The other entries for this version describe each one and how to migrate; check them before upgrading from 0.42.From this release, breaking changes ship only in a new major version.
The first 1.x version is 1.0.1. npm also lists a deprecated
emdash@1.0.0, published by mistake from 0.7-era code; do not install it. -
#3518
bc54886Thanks @ascorbic! - Moves the subpaths that only EmDash itself loads underemdash/internal/, and the D1 and Hyperdrive migration executors under@emdash-cms/cloudflare/internal/. These paths are not public API: their exports can change or be removed in any release.Sites that use
emdash()inastro.config.mjsneed no changes. The integration, the database, cache and media adapter helpers, and the first-party Cloudflare, workerd sandbox and plugin-test packages all load the new paths automatically.The following subpaths are removed:
Removed subpath Now loaded from emdash/routes/*emdash/internal/routes/*emdash/middleware/authemdash/internal/middleware/authemdash/middleware/redirectemdash/internal/middleware/redirectemdash/middleware/request-contextemdash/internal/middleware/request-contextemdash/middleware/setupemdash/internal/middleware/setupemdash/middleware/media-usage-write-fenceemdash/internal/middleware/media-usage-write-fenceemdash/image-endpointemdash/internal/image-endpointemdash/media/local-runtimeemdash/internal/media/local-runtimeemdash/object-cache/memoryemdash/internal/object-cache/memoryemdash/db/sqlite-migrationsemdash/internal/db/sqlite-migrationsemdash/db/libsql-migrationsemdash/internal/db/libsql-migrationsemdash/db/postgres-migrationsemdash/internal/db/postgres-migrationsemdash/database/migration-lockemdash/internal/database/migration-lockemdash/database/pg-migration-lockemdash/internal/database/pg-migration-lockemdash/plugins/hostemdash/internal/plugins/hostemdash/plugins/http-wireemdash/internal/plugins/http-wireemdash/plugins/adapt-sandbox-entryemdash/internal/plugins/adapt-sandbox-entryemdash/plugin-test-runtimeemdash/internal/plugin-test-runtimeemdash/testing/registryemdash/internal/testing/registry@emdash-cms/cloudflare/db/d1-migrations@emdash-cms/cloudflare/internal/db/d1-migrations@emdash-cms/cloudflare/db/hyperdrive-migrations@emdash-cms/cloudflare/internal/db/hyperdrive-migrationsWhat should I do?
If your project or package imports one of the removed subpaths directly, replace the import with a public entrypoint:
- To configure a database, object cache or media provider, use
sqlite(),libsql()orpostgres()fromemdash/db,memoryCache()fromemdash/astro, orlocalMedia()fromemdash/media, instead of writing their entrypoints by hand. - To test a plugin, use
@emdash-cms/plugin-testinstead ofemdash/plugin-test-runtime. - To run your own middleware before EmDash's, set the
middleware.outeroption ofemdash(). The internal auth, setup, redirect and request-context middleware have no public replacement.
Rebuild after upgrading.
emdash migraterejects a migration manifest written by an earlier EmDash version. - To configure a database, object cache or media provider, use
-
#3519
0b4be2cThanks @ascorbic! - Removes the deprecatedcloudflareCache()route-cache provider and its@emdash-cms/cloudflare/cacheand@emdash-cms/cloudflare/cache/configentry points. Sites that still importcloudflareCachefail to build after upgrading.Switch to native Workers Caching with the Astro Cloudflare adapter's provider. The adapter enables Workers Cache in the generated deployment configuration when this provider is set:
- import { cloudflareCache } from "@emdash-cms/cloudflare"; + import { cacheCloudflare } from "@astrojs/cloudflare/cache"; export default defineConfig({ cache: { - provider: cloudflareCache(), + provider: cacheCloudflare(), }, });
Invalidation moves to
cache.purge()fromcloudflare:workers, so theCF_ZONE_IDandCF_CACHE_PURGE_TOKENsecrets are no longer needed and can be deleted. The KV object cache (kvCache()and@emdash-cms/cloudflare/cache/kv) is unchanged. -
#3519
0b4be2cThanks @ascorbic! - Adds a startup warning when an installed or configured plugin declares deprecated capability names such asread:content,network:fetchorpage:inject. The warning appears once per plugin and lists each current replacement, for exampleread:content → content:read. The deprecated names keep working throughout 1.x. If a plugin you use triggers the warning, update it, or ask its author to publish a version that uses the current names.aiSearch()from@emdash-cms/cloudflarenow declarescontent:read, so it no longer triggers the warning. -
Updated dependencies [
d274172,bc54886,0b4be2c,0b4be2c,0b4be2c,0b4be2c]:- emdash@1.0.1-rc.0