v17.3.1 - Editors, UI, Aliases.

This is a Patch release for uSync for Umbraco v17.1. it contains fixes and updates for known issues.:

the principle issue is uSync being to clever and trying to update the EditorUIAlias based on best guess when in some situations (#949) it should just leave it alone

What's Changed

• 👍 remove unused parameter on download, make it require admin at all times (not just tree access) by @KevinJump in #948
• 👍 update build script so we genete uSync.Extend now too. by @KevinJump in #951
• 🐛 Fixes: #949 - Property Editor UI alias values get overwritten on import by @KevinJump in #950

Full Changelog: v17.3.0...v17.3.1

Installing

dotnet add package uSync --version 17.3.1

Updating

[NOTE!] with the new centralized package management feature being using on v17.3+ umbraco projects you need to up date package versions using dotnet package update, dotnet add package won't do it.

dotnet package update uSync --version 17.3.1

v17.3.0 - 🎈Floating points release

This is a major point release update for uSync for Umbraco v17. it contains quite a few updates, fixes and performance improvements.

Warning

This release jumps two point releases (there is no v17.1 or v17.2) because it has a dependency on Umbraco v17.3 and we figure the easiest way to mange that is to keep the release versions in sync.

Highlights

Client auth updates.

There are a couple of small changes in v17.3 that we wanted to support. We have for example moved the client authentication to the newer umbHttpClient.getConfig() methods to match the newer extension templates - moving to 17.3 also allows us to move our version of @hey-api/openapi-ts independently of Umbraco which means we can update for some critical vulnerabilities.

Changing HMAC Key support

We have added support for changing HMAC image keys, The umbraco recommendation is that these keys match across your site installations, but if you are moving between clients, or projects or for some other reason you might not have these values match and incline images inside RTE blocks for example will have the wrong HMAC value assigned to them - off by default uSync can go in an update these HMAC values so you can sync stuff across non-matching installations.

Performance.

We asked AI . "Analyse this code base for any performance improvements, ignore the minor improvements in things like string allocation and concentrate on any potential reduction in database calls or file IO that could be improved upon" #924.

This gave us some nice pointers. Most of these updates are around file IO, and file parsing, it didn't reduce and DB calls within the code.

For example there is now some parallelism in how we read in files (https://github.com/KevinJump/uSync/blob/v17/main/uSync.BackOffice/Services/SyncFileService.cs#L493-L520) which does give some measurable improvements in the read time of large folder structures.

Updates

• 💨 A few IO improvements based on suggestions from AI prompts. by @KevinJump in #924
• ⭐ V17/17.3 hmac image url updates by @KevinJump in #946
• ⚙️ Update so we can disable history via config and not show in ui by @KevinJump in #936
• ⚙️Add single export method to service. by @KevinJump in #937
• ⚙️ Remove version/user from logs, for cleaner log files. by @KevinJump in #943
• 💨 V17/logging guards by @KevinJump in #916
• 💨 Demote some log info to log debug lines. by @KevinJump in #944

uSync.Migrations changes

These changes help the new uSync.Migrations integrate into the usync processes better.

• v17/migrations - delegate tracking out of core. by @KevinJump in #921
• V17/community migrations by @KevinJump in #914
• Cleanup the legacy tab, so it aligns more with what uSync.Migrations … by @KevinJump in #918
• V17/nested content by @KevinJump in #903
• Fix RichTextMigration tests: toolbar extraction always returning empty by @Copilot in #907

Fixes

• 🐛 Fixes typo in setting screen #911 by @KevinJump in #941
• 🐛 Fix - remove tab when deleted from file fixes: #923 by @KevinJump in #940
• 🐛 Fixes #910 - adds date to export filename by @KevinJump in #942
• 🐛 Fix: Cannot create templates during sync when running in production mode (Umbraco 17.3+) by @KevinJump in #938
• 🐛 Revert "Fix: Cannot create templates during sync when running in production mode (Umbraco 17.3+) (#938)" by @KevinJump in #939

Dependency Updates

• Bump rollup from 4.21.2 to 4.59.0 in /uSync.Backoffice.Management.Client/usync-assets by @dependabot[bot] in #900
• Bump minimatch from 3.1.2 to 3.1.5 in /uSync.History/history-client by @dependabot[bot] in #901
• Bump dompurify from 3.3.0 to 3.3.3 in /uSync.History/history-client by @dependabot[bot] in #912
• Bump dompurify from 3.3.0 to 3.3.3 in /uSync.Backoffice.Management.Client/usync-assets by @dependabot[bot] in #913
• Bump picomatch from 4.0.3 to 4.0.4 in /uSync.Backoffice.Management.Client/usync-assets by @dependabot[bot] in #920
• Bump defu from 6.1.4 to 6.1.6 in /uSync.History/history-client by @dependabot[bot] in #927
• Bump vite from 8.0.1 to 8.0.5 in /uSync.Backoffice.Management.Client/usync-assets by @dependabot[bot] in #928
• Bump vite from 8.0.3 to 8.0.5 in /uSync.History/history-client by @dependabot[bot] in #929
• Bump lodash and @microsoft/api-extractor in /uSync.Backoffice.Management.Client/usync-assets by @dependabot[bot] in #931
• Bump handlebars, @hey-api/openapi-ts and @umbraco-cms/backoffice in /uSync.History/history-client by @dependabot[bot] in #930
• Bump defu from 6.1.4 to 6.1.6 in /uSync.Backoffice.Management.Client/usync-assets by @dependabot[bot] in #932
• Bump rollup from 4.50.1 to 4.59.0 in /uSync.History/history-client by @dependabot[bot] in #902
• update the dependencies by @KevinJump in #933
• update eslint package. by @KevinJump in #934
• update .net packages to v17.3 umbraco dependencies by @KevinJump in #935
• Package updates by @KevinJump in #915
• V17/history dependency updates by @KevinJump in #922
  Full Changelog: v17.0.4...v17.3.0

---

Installing

You can get into your project via nuget.

dotnet add package usync --version 17.3.0

or add it directly to the csproj file.

<PackageReference Include="uSync" Version="17.3.0" />

If you are using centralized package management, the version entry is what gets updated

 <PackageVersion Include="uSync" Version="17.3.0" />

v17.0.4 - Packaging, Extending and Naming.

This is a patch release of uSync for Umbraco v17 - it contains some fixes for reported issues.

Note

This version supports all versions of Umbraco v17.*

What's Changed

• ⭐ Add IgnoreStopIfOnceExists setting for write-only deployments by @Copilot in #879
• ⭐ Add cleanup in DocumentUrl tables when the content key changes. by @KevinJump in #869
• ⭐ refresh the trees in settings when uSync finishes an import by @KevinJump in #892
• ⭐ V17/extension example by @KevinJump in #888
  • Ensure we don't build the extend examples unless we are in debug. by @KevinJump in #889
• 🐛 Fix - when descriptions are blank, they get filled with 'null' by @KevinJump in #890
• 🐛 Fix - don't save 'null' in property type description name by @KevinJump in #891
• ⬆️ update readme by @KevinJump in #893
• ⬆️ move to centralised package management by @KevinJump in #894
• ⬆️ update dependencies by @KevinJump in #895
• ⬆️ add explicity JsonConverters to all enums, so they are always serialized as strings by @KevinJump in #897
• 🆙 V17/last synced date by @KevinJump in #898
• ⬆️ V17/object property extensions by @KevinJump in #896

Full Changelog: v17.0.2...v17.0.4

v17.0.2 - Tab Clash / Picker Migrations Fix

This is a patch release of uSync for Umbraco v17 it fixes some reported issues with tab name clashes and migrated media and content pickers that have start nodes or filters defined.

What's Changed

• Fix grammar in en-US translation by @stephlane in #872
• Fix: #870 - Migrate Filter and StartNodeId values for pickers from v13 by @KevinJump in #873
• Fix: #862 - Search for exact alias, not just a partial match. #862 by @KevinJump in #876

New Contributors

• @stephlane made their first contribution in #872

Full Changelog: v17.0.1...v17.0.2

v17.0.1 - Migration fixing.

This is a patch release for uSync for Umbraco v17, it contains some fixes to help with the migration of data from v13 sites to v17.

Fixes

• Migration of RTE Values to tiptap can be skipped if incoming rte has no default toolbar config.
• LocalLinks updates to match v17.0.1

Full Changelog: v17.0.0...v17.0.1

v17.0.0 : 🦃🥧🎅 : Thanks be to Seventeen

This is the uSync v17 version for Umbraco v17.0.0 - It contains all the goodies and tweaks required to get things syncing on the shiny new LTS version of Umbraco 🎉

What's Changed

• pull v16/main into v17/main by @KevinJump in #836
• V17/background processing by @KevinJump in #837
• V17/fix tab group on focus by @KevinJump in #839
• V17/history by @henryjump in #844
• V17/history package update by @henryjump in #845
• Clean up legacy code (v13 client, etc) by @KevinJump in #846
• V17/umb rc2 by @KevinJump in #849
• V17/rte block import fix by @KevinJump in #850
• rc2 versioning by @KevinJump in #851
• remove v17 obsoleted methods by @KevinJump in #852
• remove newtonsoft from history by @KevinJump in #853
• Fix: Don't group notifications if they are being fired in a background by @KevinJump in #857
• V17/rc3 by @KevinJump in #859
• Update to rc4 with breaking swashbuckle changes. by @KevinJump in #864
• v17.0.0 Dependencies. by @KevinJump in #865

Full Changelog: v16.1.0...v17.0.0

v17.0.0-rc2 - closing in.

This is the second release candidate for uSync for Umbraco v17 - it is built against the Umbraco v17.0.0-rc2 release.

What's Changed (since the beta).

• pull v16/main into v17/main by @KevinJump in #836
• V17/background processing by @KevinJump in #837
• V17/fix tab group on focus by @KevinJump in #839
• V17/history by @henryjump in #844
• V17/history package update by @henryjump in #845
• Clean up legacy code (v13 client, etc) by @KevinJump in #846
• V17/umb rc2 by @KevinJump in #849
• V17/rte block import fix by @KevinJump in #850
• rc2 versioning by @KevinJump in #851

Full Changelog: v17.0.0-beta...v17.0.0-rc2

v17.0.0-beta - Bee tarrr.

This is the uSync beta release for Umbraco v17 beta . it is indented as a test release for people to check out functionality and report any issues.

This beta release is a v17 port of the uSync 16.1 release it contains no new features other than changes to make the package build and run on Umbraco v17.

We have no yet worked through the list of changes in Umbraco v17 to confirm we have full coverage of any new features or properties with this release, we will be working on that as the releases progress and aim to have any addtional functionality in place for the release candidate versions of Umbraco as they are released.

If you encounter any issues with this release please raise an issue on this repo, mentioning thaty you are running the v17 beta release.

Full Changelog: v16.1.0...v17.0.0-beta

v16.1.0 - Block and File merging.

This is a minor update to uSync for Umbraco v16, it contains feature updates to how BlockList/Grid merges are reported and the ability to merge uSync files for multiple items into single files so they can be read in one block from the server (no UI for this, feature will likely be enabled via the uSync.Cli).

What's Changed

• V16/block converters two by @KevinJump in #822
• pass latest content version between passes. by @KevinJump in #823
• V16/firstboot on startup conflict fix by @KevinJump in #824
• Add operation security filter so swagger auth is allowed. by @KevinJump in #825
• Share second pass actions across commonn IContentBase objects by @KevinJump in #826
• Rix #827 - Removal's code was trying to modify array inside loop of array by @KevinJump in #828
• V16/multiple nodes per file by @KevinJump in #829

Full Changelog: v16.0.8...v16.1.0

This will be the last 'feature' release of uSync for Umbraco v16 as we move on to supporting and targeting Umbraco v17 (see https://docs.jumoo.co.uk/SupportLifecycles#Short-Term-Support-STS-Releases)

v16.0.8 - niggles 😠

This is a patch release of uSync for Umbraco, it contains some fixes issues around imports on startup and UI messages.

What's Changed

• update package.json dependencies. by @KevinJump in #819
• Offer more granular updates to the ordering process by @KevinJump in #820
• Get Correct Content version on second pass events. by @KevinJump in #821

Full Changelog: v16.0.7...v16.0.8