refactor: standardize notify helper usage and document migration workflow

- Refactor notify usage in GiftedDialog.vue, AccountViewView.vue, ClaimView.vue, and DataExportSection.vue:
  • Use notify as a property initialized in created() with createNotifyHelpers(this.$notify)
  • Remove getter-based notify patterns for consistency and lifecycle safety
  • Fix linter/type errors related to notify property initialization

- Add mandatory per-file migration workflow to doc/migration-progress-tracker.md:
  • For each file: (1) migrate to PlatformServiceMixin, (2) immediately standardize notify usage and fix linter/type errors
  • Clarifies this two-step process is required for every file, not as a global sweep

All migrated files are now consistent, maintainable, and ready for further migration work.

src/components/DataExportSection.vue

@@ -98,9 +98,7 @@ export default class DataExportSection extends Vue {
    * Notification helper for consistent notification patterns
    * Created as a getter to ensure $notify is available when called
    */
-  get notify() {
-    return createNotifyHelpers(this.$notify);
-  }
+  notify!: ReturnType<typeof createNotifyHelpers>;
 
   /**
    * NOTE: PlatformServiceMixin provides both concise helpers (e.g. $contacts, capabilities)
@@ -156,5 +154,9 @@ export default class DataExportSection extends Vue {
       this.isExporting = false;
     }
   }
+
+  created() {
+    this.notify = createNotifyHelpers(this.$notify);
+  }
 }
 </script>

src/components/GiftedDialog.vue

@@ -18,7 +18,7 @@
         :to-project-id="toProjectId"
         :giver="giver"
         :receiver="receiver"
-        :notify="$notify"
+        :notify="notify"
         @entity-selected="handleEntitySelected"
         @cancel="cancel"
       />
@@ -62,17 +62,16 @@ import {
   getHeaders,
 } from "../libs/endorserServer";
 import * as libsUtil from "../libs/util";
-// Removed unused imports: db, retrieveSettingsForActiveAccount
 import { Contact } from "../db/tables/contacts";
-import * as databaseUtil from "../db/databaseUtil";
 import { retrieveAccountDids } from "../libs/util";
 import { logger } from "../utils/logger";
-import { PlatformServiceFactory } from "@/services/PlatformServiceFactory";
 import EntityIcon from "../components/EntityIcon.vue";
 import ProjectIcon from "../components/ProjectIcon.vue";
 import EntitySelectionStep from "../components/EntitySelectionStep.vue";
 import GiftDetailsStep from "../components/GiftDetailsStep.vue";
 import { PlanData } from "../interfaces/records";
+import { PlatformServiceMixin } from "@/utils/PlatformServiceMixin";
+import { createNotifyHelpers, TIMEOUTS } from "@/utils/notify";
 
 @Component({
   components: {
@@ -81,9 +80,10 @@ import { PlanData } from "../interfaces/records";
     EntitySelectionStep,
     GiftDetailsStep,
   },
+  mixins: [PlatformServiceMixin],
 })
 export default class GiftedDialog extends Vue {
-  $notify!: (notification: NotificationIface, timeout?: number) => void;
+  notify!: ReturnType<typeof createNotifyHelpers>;
 
   @Prop() fromProjectId = "";
   @Prop() toProjectId = "";
@@ -230,17 +230,11 @@ export default class GiftedDialog extends Vue {
     this.updateEntityTypes();
 
     try {
-      const settings = await databaseUtil.retrieveSettingsForActiveAccount();
+      const settings = await this.$settings();
       this.apiServer = settings.apiServer || "";
       this.activeDid = settings.activeDid || "";
 
-      const platformService = PlatformServiceFactory.getInstance();
-      const result = await platformService.dbQuery(`SELECT * FROM contacts`);
-      if (result) {
-        this.allContacts = databaseUtil.mapQueryResultToValues(
-          result,
-        ) as unknown as Contact[];
-      }
+      this.allContacts = await this.$contacts();
 
       this.allMyDids = await retrieveAccountDids();
 
@@ -264,17 +258,11 @@ export default class GiftedDialog extends Vue {
       }
     } catch (err: unknown) {
       logger.error("Error retrieving settings from database:", err);
-      this.$notify(
-        {
-          group: "alert",
-          type: "danger",
-          title: "Error",
-          text:
-            err instanceof Error
-              ? err.message
-              : "There was an error retrieving your settings.",
-        },
-        -1,
+      this.notify.error(
+        err instanceof Error
+          ? err.message
+          : "There was an error retrieving your settings.",
+        TIMEOUTS.MODAL,
       );
     }
 
@@ -319,68 +307,37 @@ export default class GiftedDialog extends Vue {
 
   async confirm() {
     if (!this.activeDid) {
-      this.$notify(
-        {
-          group: "alert",
-          type: "danger",
-          title: "Error",
-          text: "You must select an identifier before you can record a give.",
-        },
-        3000,
+      this.notify.error(
+        "You must select an identifier before you can record a give.",
+        TIMEOUTS.STANDARD,
       );
       return;
     }
     if (parseFloat(this.amountInput) < 0) {
-      this.$notify(
-        {
-          group: "alert",
-          type: "danger",
-          text: "You may not send a negative number.",
-          title: "",
-        },
-        2000,
-      );
+      this.notify.error("You may not send a negative number.", TIMEOUTS.SHORT);
       return;
     }
     if (!this.description && !parseFloat(this.amountInput)) {
-      this.$notify(
-        {
-          group: "alert",
-          type: "danger",
-          title: "Error",
-          text: `You must enter a description or some number of ${
-            this.libsUtil.UNIT_LONG[this.unitCode]
-          }.`,
-        },
-        2000,
+      this.notify.error(
+        `You must enter a description or some number of ${
+          this.libsUtil.UNIT_LONG[this.unitCode]
+        }.`,
+        TIMEOUTS.SHORT,
       );
       return;
     }
 
     // Check for person conflict
     if (this.hasPersonConflict) {
-      this.$notify(
-        {
-          group: "alert",
-          type: "danger",
-          title: "Error",
-          text: "You cannot select the same person as both giver and recipient.",
-        },
-        3000,
+      this.notify.error(
+        "You cannot select the same person as both giver and recipient.",
+        TIMEOUTS.STANDARD,
       );
       return;
     }
 
     this.close();
-    this.$notify(
-      {
-        group: "alert",
-        type: "toast",
-        text: "Recording the give...",
-        title: "",
-      },
-      1000,
-    );
+    this.notify.toast("Recording the give...", undefined, TIMEOUTS.BRIEF);
     // this is asynchronous, but we don't need to wait for it to complete
     await this.recordGive(
       (this.giver?.did as string) || null,
@@ -460,25 +417,12 @@ export default class GiftedDialog extends Vue {
       if (!result.success) {
         const errorMessage = this.getGiveCreationErrorMessage(result);
         logger.error("Error with give creation result:", result);
-        this.$notify(
-          {
-            group: "alert",
-            type: "danger",
-            title: "Error",
-            text: errorMessage || "There was an error creating the give.",
-          },
-          -1,
+        this.notify.error(
+          errorMessage || "There was an error creating the give.",
+          TIMEOUTS.MODAL,
         );
       } else {
-        this.$notify(
-          {
-            group: "alert",
-            type: "success",
-            title: "Success",
-            text: `That gift was recorded.`,
-          },
-          7000,
-        );
+        this.notify.success("That gift was recorded.", TIMEOUTS.VERY_LONG);
         if (this.callbackOnSuccess) {
           this.callbackOnSuccess(amount);
         }
@@ -490,15 +434,7 @@ export default class GiftedDialog extends Vue {
         error.userMessage ||
         serverMessageForUser(error) ||
         "There was an error recording the give.";
-      this.$notify(
-        {
-          group: "alert",
-          type: "danger",
-          title: "Error",
-          text: errorMessage,
-        },
-        -1,
-      );
+      this.notify.error(errorMessage, TIMEOUTS.MODAL);
     }
   }
 
@@ -518,15 +454,7 @@ export default class GiftedDialog extends Vue {
   }
 
   explainData() {
-    this.$notify(
-      {
-        group: "alert",
-        type: "success",
-        title: "Data Sharing",
-        text: libsUtil.PRIVACY_MESSAGE,
-      },
-      -1,
-    );
+    this.notify.info(libsUtil.PRIVACY_MESSAGE, TIMEOUTS.MODAL);
   }
 
   selectGiver(contact?: Contact) {
@@ -566,15 +494,7 @@ export default class GiftedDialog extends Vue {
       }
     } catch (error) {
       logger.error("Error loading projects:", error);
-      this.$notify(
-        {
-          group: "alert",
-          type: "danger",
-          title: "Error",
-          text: "Failed to load projects",
-        },
-        3000,
-      );
+      this.notify.error("Failed to load projects", TIMEOUTS.STANDARD);
     }
   }
 
@@ -696,6 +616,10 @@ export default class GiftedDialog extends Vue {
       amountInput: this.amountInput,
     });
   }
+
+  created() {
+    this.notify = createNotifyHelpers(this.$notify);
+  }
 }
 </script>
 

src/components/IdentitySection.vue

@@ -185,3 +185,4 @@ export default class IdentitySection extends Vue {
   }
 }
 </script>
+