feat: added 'updatedAt' field to claimDraft (#7523)

## Explanation

<!--
Thanks for your contribution! Take a moment to answer these questions so
that reviewers have the information they need to properly understand
your changes:

* What is the current state of things and why does it need to change?
* What is the solution your changes offer and how does it work?
* Are there any changes whose purpose might not obvious to those
unfamiliar with the domain?
* If your primary goal was to update one package but you found you had
to update another one along the way, why did you do so?
* If you had to upgrade a dependency, why did you do so?
-->

## References

<!--
Are there any issues that this pull request is tied to?
Are there other links that reviewers should consult to understand these
changes better?
Are there client or consumer pull requests to adopt any breaking
changes?

For example:

* Fixes #12345
* Related to #67890
-->

## Checklist

- [x] I've updated the test suite for new or updated code as appropriate
- [x] I've updated documentation (JSDoc, Markdown, etc.) for new or
updated code as appropriate
- [x] I've communicated my changes to consumers by [updating changelogs
for packages I've
changed](https://github.com/MetaMask/core/tree/main/docs/contributing.md#updating-changelogs)
- [x] I've introduced [breaking
changes](https://github.com/MetaMask/core/tree/main/docs/breaking-changes.md)
in this PR and have prepared draft pull requests for clients and
consumer packages to resolve them

<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> Adds an `updatedAt` timestamp to claim drafts and updates it on
create/update, with tests and changelog updated.
> 
> - **Claims Controller**:
> - **Types**: Include `updatedAt` in `ClaimDraft`
(`packages/claims-controller/src/types.ts`).
> - **Logic**: `saveOrUpdateClaimDraft` now sets `updatedAt` on create
and refreshes it on updates; return value includes `updatedAt`
(`packages/claims-controller/src/ClaimsController.ts`).
> - **Tests**: Update draft tests to expect `updatedAt`
(`packages/claims-controller/src/ClaimsController.test.ts`).
> - **Docs**:
> - Update changelog to note `updatedAt` addition
(`packages/claims-controller/CHANGELOG.md`).
> 
> <sup>Written by [Cursor
Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit
23cae10. This will update automatically
on new commits. Configure
[here](https://cursor.com/dashboard?tab=bugbot).</sup>
<!-- /CURSOR_SUMMARY -->

Author: lwin-kyaw

packages/claims-controller/CHANGELOG.md

@@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- Added `updatedAt` field to the claims draft. ([#7523](https://github.com/MetaMask/core/pull/7523))
+
 ## [0.3.0]
 
 ### Added

packages/claims-controller/src/ClaimsController.test.ts

@@ -265,6 +265,7 @@ describe('ClaimsController', () => {
       impactedTxHash: '0x123',
       reimbursementWalletAddress: '0x456',
       description: 'test description',
+      updatedAt: '2025-12-17T06:10:32.213Z',
     };
     const MOCK_CLAIM_DRAFTS: ClaimDraft[] = [
       {
@@ -275,6 +276,7 @@ describe('ClaimsController', () => {
         impactedTxHash: '0x123',
         reimbursementWalletAddress: '0x456',
         description: 'test description',
+        updatedAt: '2025-12-17T06:10:32.213Z',
       },
       {
         draftId: 'mock-draft-2',
@@ -284,6 +286,7 @@ describe('ClaimsController', () => {
         impactedTxHash: '0x789',
         reimbursementWalletAddress: '0x012',
         description: 'test description 2',
+        updatedAt: '2025-12-17T06:10:32.213Z',
       },
     ];
 
@@ -295,7 +298,10 @@ describe('ClaimsController', () => {
         expect(updatedState).not.toBe(initialState);
         expect(updatedState.drafts).toHaveLength(1);
         expect(updatedState.drafts[0].draftId).toBeDefined();
-        expect(updatedState.drafts[0]).toMatchObject(MOCK_DRAFT);
+        expect(updatedState.drafts[0]).toMatchObject({
+          ...MOCK_DRAFT,
+          updatedAt: expect.any(String),
+        });
         expect(updatedState.drafts[0].draftId).toBeDefined();
       });
     });

packages/claims-controller/src/ClaimsController.ts

@@ -232,14 +232,19 @@ export class ClaimsController extends BaseController<
     );
 
     if (isExistingDraft) {
+      const updatedAt = new Date().toISOString();
       this.update((state) => {
         state.drafts = state.drafts.map((existingDraft) =>
           existingDraft.draftId === draft.draftId
-            ? { ...existingDraft, ...draft }
+            ? {
+                ...existingDraft,
+                ...draft,
+                updatedAt,
+              }
             : existingDraft,
         );
       });
-      return draft as ClaimDraft;
+      return { ...draft, updatedAt } as ClaimDraft;
     }
 
     // generate a new draft id, name and add it to the state
@@ -248,6 +253,7 @@ export class ClaimsController extends BaseController<
     const newDraft: ClaimDraft = {
       ...draft,
       draftId,
+      updatedAt: new Date().toISOString(),
     };
 
     this.update((state) => {

packages/claims-controller/src/types.ts

@@ -51,13 +51,7 @@ export type Claim = {
 export type ClaimDraft = Partial<
   Omit<
     Claim,
-    | 'id'
-    | 'shortId'
-    | 'createdAt'
-    | 'updatedAt'
-    | 'intercomId'
-    | 'status'
-    | 'attachments'
+    'id' | 'shortId' | 'createdAt' | 'intercomId' | 'status' | 'attachments'
   >
 > & {
   /**