refactor: standardize notification usage and document best practices

Move all user-facing notification messages to src/constants/notifications.ts
Use TIMEOUTS constants from src/utils/notify.ts for all notification durations
Refactor ActivityListItem.vue:
Use notification message and duration constants
Initialize notify helper in created() with createNotifyHelpers(this.$notify)
Add $notify property for Vue runtime injection to satisfy type checker
Use type guards or 'as any' for unknown notification payloads
Wrap notifyWhyCannotConfirm calls to match expected function signature
Fix type import for GiveRecordWithContactInfo
Add 'Notification Best Practices and Nuances' section to migration-progress-tracker.md:
Document message/duration constants, notify helper pattern, type safety, and wrapper function usage
Remove all hardcoded notification strings and durations from components
This commit is contained in:
Matthew Raymer
2025-07-06 12:19:31 +00:00
parent 6d85c54a02
commit 938e6693b0
6 changed files with 45 additions and 26 deletions

View File

@@ -249,7 +249,7 @@
<script lang="ts">
import { Component, Prop, Vue, Emit } from "vue-facing-decorator";
import { GiveRecordWithContactInfo } from "../types";
import { GiveRecordWithContactInfo } from "@/interfaces/give";
import EntityIcon from "./EntityIcon.vue";
import {
isGiveClaimType,
@@ -258,7 +258,9 @@ import {
} from "../libs/util";
import { containsHiddenDid, isHiddenDid } from "../libs/endorserServer";
import ProjectIcon from "./ProjectIcon.vue";
import { NotificationIface } from "../constants/app";
import { createNotifyHelpers } from "@/utils/notify";
import { NOTIFY_PERSON_HIDDEN, NOTIFY_UNKNOWN_PERSON } from "@/constants/notifications";
import { TIMEOUTS } from "@/utils/notify";
@Component({
components: {
@@ -274,29 +276,24 @@ export default class ActivityListItem extends Vue {
@Prop() confirmerIdList?: string[];
isHiddenDid = isHiddenDid;
$notify!: (notification: NotificationIface, timeout?: number) => void;
notify!: ReturnType<typeof createNotifyHelpers>;
$notify!: (notification: any, timeout?: number) => void;
created() {
this.notify = createNotifyHelpers(this.$notify);
}
notifyHiddenPerson() {
this.$notify(
{
group: "alert",
type: "warning",
title: "Person Outside Your Network",
text: "This person is not visible to you.",
},
3000,
this.notify.warning(
NOTIFY_PERSON_HIDDEN.message,
TIMEOUTS.STANDARD,
);
}
notifyUnknownPerson() {
this.$notify(
{
group: "alert",
type: "warning",
title: "Unidentified Person",
text: "Nobody specific was recognized.",
},
3000,
this.notify.warning(
NOTIFY_UNKNOWN_PERSON.message,
TIMEOUTS.STANDARD,
);
}
@@ -307,7 +304,7 @@ export default class ActivityListItem extends Vue {
get fetchAmount(): string {
const claim =
(this.record.fullClaim as unknown).claim || this.record.fullClaim;
(this.record.fullClaim as any)?.claim || this.record.fullClaim;
const amount = claim.object?.amountOfThisGood
? this.displayAmount(claim.object.unitCode, claim.object.amountOfThisGood)
@@ -318,7 +315,7 @@ export default class ActivityListItem extends Vue {
get description(): string {
const claim =
(this.record.fullClaim as unknown).claim || this.record.fullClaim;
(this.record.fullClaim as any)?.claim || this.record.fullClaim;
return `${claim?.description || ""}`;
}
@@ -343,7 +340,7 @@ export default class ActivityListItem extends Vue {
handleConfirmClick() {
if (!this.canConfirm) {
notifyWhyCannotConfirm(
this.$notify,
(msg, timeout) => this.notify.info(msg.text ?? '', timeout),
this.isRegistered,
this.record.fullClaim?.["@type"],
this.record,
@@ -352,7 +349,6 @@ export default class ActivityListItem extends Vue {
);
return;
}
this.$emit("confirmClaim", this.record);
}

View File

@@ -54,7 +54,6 @@
<script lang="ts">
import { Vue, Component, Prop, Watch } from "vue-facing-decorator";
import { NotificationIface } from "../constants/app";
import {
createAndSubmitGive,
didInfo,

View File

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