Note: your identity currently does not include a name.
Error: {{ error }}
- + {{ cameraStateMessage || "Ready to scan" }}
This is a project for public benefit. You are invited to add your gratitude @@ -100,7 +100,7 @@
This app encourages people to offer small bits of time to one another. It's a way to @@ -116,7 +116,7 @@
These are mostly at the beginning stages, so any of them will appreciate your offers that show interest. @@ -129,7 +129,7 @@
Make your claims and get others to confirm them. Then you can use the API to pull your copy of all that @@ -155,7 +155,7 @@
This requires motivated, dedicated citizens. The good thing is that dedication the primary ingredient; @@ -174,7 +174,7 @@
This platform is not optimal for balancing needs and resources at this point, @@ -532,12 +532,7 @@ If you have Bitcoin, donate to bc1q90v4ted6cpt63tjfh2lvd5xzfc67sd4g9w8xma @@ -601,12 +596,40 @@ import { Capacitor } from "@capacitor/core"; import * as Package from "../../package.json"; import QuickNav from "../components/QuickNav.vue"; -import { APP_SERVER, NotificationIface } from "../constants/app"; -import * as databaseUtil from "../db/databaseUtil"; - -@Component({ components: { QuickNav } }) +import { APP_SERVER } from "../constants/app"; +import { PlatformServiceMixin } from "@/utils/PlatformServiceMixin"; + +/** + * HelpView.vue - Comprehensive Help System Component + * + * This component provides extensive documentation, troubleshooting guides, and support + * information for TimeSafari users. It serves as the primary user support resource with + * detailed explanations of features, data backup/restore procedures, and platform-specific + * guidance. + * + * Key Features: + * - Interactive help sections for different user types and interests + * - Onboarding management with reset functionality + * - Context-aware navigation to different app sections + * - Clipboard operations for copying addresses and data + * - Platform detection for iOS, Android, and desktop guidance + * - Version display showing current app version and commit hash + * + * Migration Status: Enhanced Triple Migration Pattern Applied + * - Database Migration: PlatformServiceMixin integrated for settings management + * - SQL Abstraction: No raw SQL queries (component uses high-level operations) + * - Notification Migration: No notifications used (clean component) + * - Template Streamlining: Interactive handlers extracted to methods + * + * @author Matthew Raymer + * @component HelpView + * @vue-facing-decorator + */ +@Component({ + components: { QuickNav }, + mixins: [PlatformServiceMixin], +}) export default class HelpView extends Vue { - $notify!: (notification: NotificationIface, timeout?: number) => void; $router!: Router; package = Package; @@ -625,31 +648,129 @@ export default class HelpView extends Vue { // Ideally, we put no functionality in here, especially in the setup, // because we never want this page to have a chance of throwing an error. - // call fn, copy text to the clipboard, then redo fn after 2 seconds - doCopyTwoSecRedo(text: string, fn: () => void) { + /** + * Copy text to clipboard with visual feedback + * + * This method executes a callback function, copies the provided text to the clipboard, + * and then re-executes the callback after 2 seconds. This is typically used for + * showing a temporary visual indicator (like a checkmark) after copying. + * + * @param {string} text - The text to copy to clipboard + * @param {Function} fn - Callback function to execute before and after copying + */ + doCopyTwoSecRedo(text: string, fn: () => void): void { fn(); useClipboard() .copy(text) .then(() => setTimeout(fn, 2000)); } - async unsetFinishedOnboarding() { - const settings = await databaseUtil.retrieveSettingsForActiveAccount(); - - if (settings.activeDid) { - await databaseUtil.updateDidSpecificSettings(settings.activeDid, { - finishedOnboarding: false, - }); + /** + * Reset onboarding state for the active account + * + * This method allows users to restart the onboarding process by setting + * the finishedOnboarding flag to false for their active DID. This is useful + * when users want to see the page-by-page help guide again. + * + * @returns {Promise} Promise that resolves when onboarding is reset + */ + async unsetFinishedOnboarding(): Promise { + try { + const settings = await this.$accountSettings(); + + if (settings.activeDid) { + await this.$updateSettings({ + ...settings, + finishedOnboarding: false, + }); + + this.$log( + "[HelpView] Onboarding reset successfully for DID: " + + settings.activeDid, + ); + } + + this.$router.push({ name: "home" }); + } catch (error) { + this.$log( + "[HelpView] Error resetting onboarding: " + (error as Error).message, + ); + + // Still navigate to home even if settings update fails + this.$router.push({ name: "home" }); } - this.$router.push({ name: "home" }); } - private handleQRCodeClick() { + /** + * Handle QR code scanner navigation + * + * This method provides platform-aware navigation to the appropriate QR code + * scanner component. On native platforms (iOS/Android), it navigates to the + * full-screen scanner. On web platforms, it navigates to the web-based scanner. + * + * @private + */ + private handleQRCodeClick(): void { if (Capacitor.isNativePlatform()) { this.$router.push({ name: "contact-qr-scan-full" }); } else { this.$router.push({ name: "contact-qr" }); } } + + /** + * Toggle Alpha chat section visibility + */ + toggleAlpha(): void { + this.showAlpha = !this.showAlpha; + } + + /** + * Toggle Group section visibility + */ + toggleGroup(): void { + this.showGroup = !this.showGroup; + } + + /** + * Toggle Community section visibility + */ + toggleCommunity(): void { + this.showCommunity = !this.showCommunity; + } + + /** + * Toggle Verifiable data section visibility + */ + toggleVerifiable(): void { + this.showVerifiable = !this.showVerifiable; + } + + /** + * Toggle Governance section visibility + */ + toggleGovernance(): void { + this.showGovernance = !this.showGovernance; + } + + /** + * Toggle Basics section visibility + */ + toggleBasics(): void { + this.showBasics = !this.showBasics; + } + + /** + * Copy Bitcoin address to clipboard with visual feedback + * + * This method copies the Bitcoin donation address to the clipboard and + * shows a visual indicator (checkmark) for 2 seconds. + */ + copyBitcoinAddress(): void { + this.doCopyTwoSecRedo( + "bc1q90v4ted6cpt63tjfh2lvd5xzfc67sd4g9w8xma", + () => (this.showDidCopy = !this.showDidCopy), + ); + } }