Skip to content

CHANGELOG.md

Latest commit

 

History

History
81 lines (49 loc) · 4.21 KB

CHANGELOG.md

File metadata and controls

81 lines (49 loc) · 4.21 KB
Raw

Changelog

1.2.0 (2026-07-10)

  • Added the --only=type1,type2,... option to migrate only certain A2 doc types and the attachments they reference. Include apostrophe-image (and/or apostrophe-file) in the list if you want the corresponding media to come across.
  • Added the --related-images option to migrate only the images actually referenced by the migrated content (one hop, resolved against the A4-form content), rather than every image. Works on its own or together with --only.
  • Added the --merge option to add the upgraded content to an existing A4 database instead of insisting on --drop. Existing content is preserved and new content is inserted alongside it.
  • Added the --replace option, which upserts documents and attachments (overwriting any with matching ids) rather than inserting them, so re-running an upgrade does not fail with duplicate key errors. --replace implies --merge.
  • Added the --copy-media option (which requires --a4-dir) to copy the physical media files of the migrated attachments into the A4 project, respecting --only and --related-images. Assumes media is stored locally under public/uploads/attachments; it does not use uploadfs and so does not handle remote (e.g. S3) storage.

1.1.2 (2026-04-01)

  • The --drop option now drops all existing collections in the a4-db, as it always promised to do. Previously all it did was bypass the check for existing documents, which doesn't make sense.

1.1.1 (2026-03-19)

  • Documented the need to update the A2 project and ensure parkedId is consistently set on parked pages.

1.1.0 (2026-03-02)

  • Updated misleading references to alpha status in README.
  • Updated legacy references to A3. You should migrate directly to A4.
  • Provided code migration AI agent skill. The @apostrophecms/code-upgrader module is no longer recommended.

1.0.0 (2023-03-16)

  • Declared stable. No code changes.
  • Decision made to start official releases with 1.0.0 for consistency.

3.0.0-beta.10 (2023-02-03)

  • No code changes. Needed to apply the latest tag properly in npm.

3.0.0-beta.9 (2023-02-02)

  • Hotfix: do not delete the published mode of the /archive page when exporting, it is a special exception to the rule that archived documents have no published mode

3.0.0-beta.8 (2023-02-01)

  • Remove the published version of draft documents that are archived (in A3, an archived document exists only as a draft).

3.0.0-beta.7 (2022-12-14)

  • Support for migrating rich text permalinks.

3.0.0-beta.6 (2022-12-12)

  • Safer migration of site pieces, in case that piece type name is used for something else in a non-multisite project.
  • Fixed the link to the document section for migration from Apostrophe 2 in the README.md.

3.0.0-beta.5 (2022-11-22)

  • Migrate existing locales in site pieces.

3.0.0-beta.4 (2022-11-17)

  • Do not localize site pieces.

3.0.0-beta.3 (2022-11-16)

  • Fixed a significant bug preventing proper import of areas when the content has been transformed.
  • Allow the mapWidgetTypes option to override the standard transformers provided for certain widget types.

3.0.0-beta.2 (2022-11-10)

  • Correctly update the path of each page to the A3 pattern.
  • Handle the main "trash" page correctly.
  • Fixed a bug that broke the recursive updating of join/relationship ids.

3.0.0-beta (2022-02-04)

  • Replaced defaultLocale option with mapLocale, which defaults to mapping default to en, as that's the right thing to do for projects with or without workflow in most cases, and allows for a broader remapping if needed. Clarified documentation on how this works and implemented it for the case where workflow is enabled for the first time.
  • The visibility property is now set, as required in A3. If published was true it is set to public, otherwise to loginRequired. While the two features are not identical this does a good job of avoiding premature public access to migrated content.
  • Don't crash if the workflow module is enabled with no prefixes option.
  • Supply an _id for every exported area.
  • As the content upgrader intentionally does not copy user and group pieces, it should not copy the aposUsersSafe collection from 2.x to 3.x, either.

3.0.0-alpha (2021-09-23)

  • First alpha test release.