V17/last synced date

[KevinJump]

Adds a notification that will listen for the bulk completion notification that fires when an import is completed, and save the date/time into the key value service for that group.

This will then allow us to present this to the user at some future date

Note

This PR does not include the UI to show the last synced date.

[Copilot]

Pull request overview

This PR implements a tracking mechanism to record the last sync (import/export/report) date/time for each handler group (e.g., Settings, Content, Media) in uSync. When a bulk operation completes, a notification handler captures the group name and stores the timestamp in Umbraco's key-value service. This data is then exposed through the Management API so it can be displayed in the UI in a future PR.

Changes:

• Added ISyncTrackerService with implementation to save and retrieve last sync timestamps per group using Umbraco's IKeyValueService
• Extended notification classes (uSyncBulkNotification, uSyncImportCompletedNotification, etc.) to include an optional Group parameter for tracking which handler group was processed
• Added JSON converters to multiple enums for consistent string-based JSON serialization across the API
• Updated frontend workspace context to refresh actions after import completion and track current set name
• Modified CSS grid layout for action buttons and added placeholder code (commented out) for future UI display of last sync dates

Reviewed changes

Copilot reviewed 36 out of 36 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
uSync.BackOffice/Tracker/*.cs	New tracker service, notification handler, and builder extensions for persisting and retrieving last sync timestamps
uSync.BackOffice/Notifications/uSyncNotifications/*.cs	Added Group parameter to bulk notification classes with obsolete constructors for backward compatibility
uSync.BackOffice/Services/*.cs	Updated service interfaces and implementations to pass group information through the sync pipeline
uSync.BackOffice/Models/SyncActionOptions.cs	Added Group property to track which group is being processed
uSync.BackOffice/uSyncBackOffice.cs	Added EverythingGroupName constant for the "all" group
uSync.Backoffice.Management.Api/Services/*.cs	Made GetActions async to retrieve last sync dates from tracker service
uSync.Backoffice.Management.Api/Models/SyncActionGroup.cs	Added LastSync property to expose timestamp to API consumers
uSync.Backoffice.Management.Client/usync-assets/src/workspace/workspace.context.ts	Added tracking of current set name and refresh actions after completion
uSync.Backoffice.Management.Client/usync-assets/src/components/usync-action-box.ts	Changed base class and added commented-out UI code for displaying last sync
uSync.Backoffice.Management.Client/usync-assets/src/workspace/views/default/default.element.ts	Changed CSS from flexbox to grid layout for action buttons
uSync.Backoffice.Management.Client/usync-assets/src/constants.ts	Added date/time formatting options for future use
uSync.Core/*.cs	Added JsonConverter attributes to multiple enums for string-based JSON serialization
uSync.Backoffice.Management.Client/usync-assets/src/api/*.gen.ts	Auto-generated API client files with updated types and localhost port
uSync.Backoffice.Management.Client/usync-assets/openapi-ts.config.ts	Updated localhost port in OpenAPI configuration

Comments suppressed due to low confidence (4)

uSync.BackOffice/Notifications/uSyncNotifications/uSyncImportCompletedNotification.cs:17

• Inconsistent punctuation in Obsolete attribute message. Most other Obsolete attributes in the codebase include a dash before "will be removed" (e.g., "Use the constructor with the group parameter instead - will be removed in v19"), but this one is missing the dash. For consistency with the rest of the codebase, add a dash after "instead".

    [Obsolete("Use the constructor with the group parameter instead will be removed in v19")]

uSync.BackOffice/Notifications/uSyncNotifications/uSyncExportCompletedNotification.cs:16

• Inconsistent punctuation in Obsolete attribute message. Most other Obsolete attributes in the codebase include a dash before "will be removed" (e.g., "Use the constructor with group and actions instead - will be removed in v19"), but this one is missing the dash. For consistency with the rest of the codebase, add a dash after "instead".

    [Obsolete("Use the constructor with the group parameter instead will be removed in v19")]

uSync.Backoffice.Management.Client/usync-assets/src/workspace/views/default/default.element.ts:361

• The CSS properties display: flex, flex-wrap, and align-content are still present but are not compatible with display: grid. When using CSS Grid (display: grid with grid-template-columns), properties like flex-wrap and align-content have no effect. These flex-related properties should be removed to avoid confusion and maintain clean CSS.

				flex-wrap: wrap;
				align-content: stretch;

uSync.Backoffice.Management.Client/usync-assets/src/components/usync-action-box.ts:125

• The commented-out code for displaying the last sync date (renderLastSync method and its CSS) should be removed if it's not being used in this PR. According to the PR description, the UI to show the last synced date is not included in this PR. Keeping commented-out code can cause confusion about what is actually active. If this code is intended for future use, consider creating a separate branch or issue for it.

	// renderLastSync() {
	// 	if (!this.group?.lastSync) return nothing;
	// 	const lastSync = this.localize.date(
	// 		this.group.lastSync ?? '',
	// 		uSyncTimeFormatOptions,
	// 	);
	// 	return html`<div class="last-sync">Last Import : ${lastSync}</div>`;
	// }

	static styles = css`
		:host {
			flex-grow: 1;
		}

		.action-box {
			transition: opacity 0.2s ease-in-out;
		}

		.box-content {
			display: flex;
			flex-direction: column;
			align-items: center;
		}

		.box-heading {
			font-size: var(--uui-size-8);
			margin: 0;
		}

		umb-icon {
			margin: var(--uui-size-8) 0 var(--uui-size-10);
			font-size: var(--uui-type-h2-size);
			color: var(--uui-color-text-alt);
		}

		uui-button {
			margin: 0 var(--uui-size-space-2);
			font-size: var(--uui-size-6);
		}

		.box-buttons {
			margin: var(--uui-size-space-2) 0;
		}

		.disabled {
			opacity: 0.4;
		}

		.last-sync {
			color: var(--uui-color-text-alt);
			font-style: italic;
			font-size: var(--uui-size-5);
		}

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.