crowd-funder-for-time-pwa/src/views/ContactQRScanFullView.vue

<template>
  <!-- CONTENT -->
  <section id="Content" class="relative w-[100vw] h-[100vh]">
    <div
      class="p-6 bg-white w-full max-w-[calc((100vh-env(safe-area-inset-top)-env(safe-area-inset-bottom))*0.4)] mx-auto"
    >
      <div class="mb-4">
        <h1 class="text-xl text-center font-semibold relative">
          <!-- Back -->
          <a
            class="text-lg text-center px-2 py-1 absolute -left-2 -top-1"
            @click="handleBack"
          >
            <font-awesome icon="chevron-left" class="fa-fw" />
          </a>

          <!-- Quick Help -->
          <a
            class="text-xl text-center text-blue-500 px-2 py-1 absolute -right-2 -top-1"
            @click="toastQRCodeHelp()"
          >
            <font-awesome icon="circle-question" class="fa-fw" />
          </a>

          Share Contact Info
        </h1>
      </div>

      <div
        v-if="!givenName"
        class="bg-amber-200 text-amber-900 border-amber-500 border-dashed border text-center rounded-md overflow-hidden px-4 py-3 mt-4"
      >
        <p class="mb-2">
          <b>Note:</b> your identity currently does <b>not</b> include a name.
        </p>
        <button
          class="inline-block text-md uppercase bg-gradient-to-b from-blue-400 to-blue-700 shadow-[inset_0_-1px_0_0_rgba(0,0,0,0.5)] text-white px-4 py-2 rounded-md"
          @click="openUserNameDialog"
        >
          Set Your Name
        </button>
      </div>

      <UserNameDialog ref="userNameDialog" />

      <div
        v-if="activeDid && activeDid.startsWith(ETHR_DID_PREFIX)"
        class="block w-full max-w-[calc((100vh-env(safe-area-inset-top)-env(safe-area-inset-bottom))*0.4)] mx-auto mt-4"
        @click="onCopyUrlToClipboard()"
      >
        <!--
          Play with display options: https://qr-code-styling.com/
          See docs: https://www.npmjs.com/package/qr-code-generator-vue3
        -->
        <QRCodeVue3
          :value="qrValue"
          :width="606"
          :height="606"
          :corners-square-options="{ type: 'square' }"
          :dots-options="{ type: 'square', color: '#000' }"
        />
      </div>

      <div v-else-if="activeDid" class="text-center mt-4">
        <!-- Not an ETHR DID so force them to paste it. (Passkey Peer DIDs are too big.) -->
        <span class="text-blue-500" @click="onCopyDidToClipboard()">
          Click here to copy your DID to your clipboard.
        </span>
        <span>
          Then give it to them so they can paste it in their list of People.
        </span>
      </div>

      <div v-else class="text-center mt-4">
        You have no identitifiers yet, so
        <router-link
          :to="{ name: 'start' }"
          class="bg-blue-500 text-white px-1.5 py-1 rounded-md"
        >
          create your identifier.
        </router-link>
        <br />
        If you don't do that first, these contacts won't see your activity.
      </div>
    </div>

    <div
      class="relative w-full max-w-[calc((100vh-env(safe-area-inset-top)-env(safe-area-inset-bottom))*0.4)] mx-auto border border-dashed border-white mt-8 aspect-square"
    >
      <p
        class="absolute top-0 left-0 right-0 bg-black bg-opacity-50 text-white text-sm text-center py-2 z-10"
      >
        Position QR code in the frame
      </p>

      <p
        v-if="error"
        class="absolute bottom-0 left-0 right-0 bg-black bg-opacity-50 text-sm text-center py-2 z-20 text-rose-400"
      >
        {{ error }}
      </p>
    </div>
  </section>
</template>

<script lang="ts">
import QRCodeVue3 from "qr-code-generator-vue3";
import { Component, Vue } from "vue-facing-decorator";
import { Router } from "vue-router";
import { useClipboard } from "@vueuse/core";

import { logger } from "../utils/logger";
import { QRScannerFactory } from "../services/QRScanner/QRScannerFactory";
import QuickNav from "../components/QuickNav.vue";
import { NotificationIface, USE_DEXIE_DB } from "../constants/app";
import { db } from "../db/index";
import { Contact } from "../db/tables/contacts";
import { getContactJwtFromJwtUrl } from "../libs/crypto";
import { decodeEndorserJwt, ETHR_DID_PREFIX } from "../libs/crypto/vc";
import { retrieveSettingsForActiveAccount } from "../db/index";
import * as databaseUtil from "../db/databaseUtil";
import { setVisibilityUtil } from "../libs/endorserServer";
import UserNameDialog from "../components/UserNameDialog.vue";
import { generateEndorserJwtUrlForAccount } from "../libs/endorserServer";
import { retrieveAccountMetadata } from "../libs/util";
import { PlatformServiceFactory } from "@/services/PlatformServiceFactory";
import { parseJsonField } from "../db/databaseUtil";

interface QRScanResult {
  rawValue?: string;
  barcode?: string;
}

interface IUserNameDialog {
  open: (callback: (name: string) => void) => void;
}

@Component({
  components: {
    QuickNav,
    QRCodeVue3,
    UserNameDialog,
  },
})
export default class ContactQRScan extends Vue {
  $notify!: (notification: NotificationIface, timeout?: number) => void;
  $router!: Router;

  isScanning = false;
  error: string | null = null;
  activeDid = "";
  apiServer = "";
  givenName = "";
  qrValue = "";
  ETHR_DID_PREFIX = ETHR_DID_PREFIX;

  // Add new properties to track scanning state
  private lastScannedValue: string = "";
  private lastScanTime: number = 0;
  private readonly SCAN_DEBOUNCE_MS = 5000; // Increased from 2000 to 5000ms to better handle mobile scanning

  // Add cleanup tracking
  private isCleaningUp = false;
  private isMounted = false;

  async created() {
    try {
      let settings = await databaseUtil.retrieveSettingsForActiveAccount();
      if (USE_DEXIE_DB) {
        settings = await retrieveSettingsForActiveAccount();
      }
      this.activeDid = settings.activeDid || "";
      this.apiServer = settings.apiServer || "";
      this.givenName = settings.firstName || "";

      const account = await retrieveAccountMetadata(this.activeDid);
      if (account) {
        const name =
          (settings.firstName || "") +
          (settings.lastName ? ` ${settings.lastName}` : "");
        this.qrValue = await generateEndorserJwtUrlForAccount(
          account,
          !!settings.isRegistered,
          name,
          settings.profileImageUrl || "",
          false,
        );
      }
    } catch (error) {
      logger.error("Error initializing component:", {
        error: error instanceof Error ? error.message : String(error),
        stack: error instanceof Error ? error.stack : undefined,
      });
      this.$notify({
        group: "alert",
        type: "danger",
        title: "Initialization Error",
        text: "Failed to initialize QR scanner. Please try again.",
      });
    }
  }

  async startScanning() {
    if (this.isCleaningUp) {
      logger.debug("Cannot start scanning during cleanup");
      return;
    }

    try {
      this.error = null;
      this.isScanning = true;
      this.lastScannedValue = "";
      this.lastScanTime = 0;

      const scanner = QRScannerFactory.getInstance();

      // Check if scanning is supported first
      if (!(await scanner.isSupported())) {
        this.error =
          "Camera access requires HTTPS. Please use a secure connection.";
        this.isScanning = false;
        this.$notify(
          {
            group: "alert",
            type: "warning",
            title: "HTTPS Required",
            text: "Camera access requires a secure (HTTPS) connection",
          },
          5000,
        );
        return;
      }

      // Check permissions first
      if (!(await scanner.checkPermissions())) {
        const granted = await scanner.requestPermissions();
        if (!granted) {
          this.error = "Camera permission denied";
          this.isScanning = false;
          // Show notification for better visibility
          this.$notify(
            {
              group: "alert",
              type: "warning",
              title: "Camera Access Required",
              text: "Camera permission denied",
            },
            5000,
          );
          return;
        }
      }

      // Add scan listener
      scanner.addListener({
        onScan: this.onScanDetect,
        onError: this.onScanError,
      });

      // Start scanning
      await scanner.startScan();
    } catch (error) {
      this.error = error instanceof Error ? error.message : String(error);
      this.isScanning = false;
      logger.error("Error starting scan:", {
        error: error instanceof Error ? error.message : String(error),
        stack: error instanceof Error ? error.stack : undefined,
      });
    }
  }

  async stopScanning() {
    try {
      const scanner = QRScannerFactory.getInstance();
      await scanner.stopScan();
    } catch (error) {
      logger.error("Error stopping scan:", {
        error: error instanceof Error ? error.message : String(error),
        stack: error instanceof Error ? error.stack : undefined,
      });
    } finally {
      this.isScanning = false;
      this.lastScannedValue = "";
      this.lastScanTime = 0;
    }
  }

  async cleanupScanner() {
    if (this.isCleaningUp) {
      return;
    }

    this.isCleaningUp = true;
    try {
      logger.info("Cleaning up QR scanner resources");
      await this.stopScanning();
      await QRScannerFactory.cleanup();
    } catch (error) {
      logger.error("Error during scanner cleanup:", {
        error: error instanceof Error ? error.message : String(error),
        stack: error instanceof Error ? error.stack : undefined,
      });
    } finally {
      this.isCleaningUp = false;
    }
  }

  /**
   * Handle QR code scan result with debouncing to prevent duplicate scans
   */
  async onScanDetect(result: string | QRScanResult) {
    try {
      // Extract raw value from different possible formats
      const rawValue =
        typeof result === "string"
          ? result
          : result?.rawValue || result?.barcode;
      if (!rawValue) {
        logger.warn("Invalid scan result - no value found:", result);
        return;
      }

      // Debounce duplicate scans
      const now = Date.now();
      if (
        rawValue === this.lastScannedValue &&
        now - this.lastScanTime < this.SCAN_DEBOUNCE_MS
      ) {
        logger.info("Ignoring duplicate scan:", rawValue);
        return;
      }

      // Update scan tracking
      this.lastScannedValue = rawValue;
      this.lastScanTime = now;

      logger.info("Processing QR code scan result:", rawValue);

      // Extract JWT
      const jwt = getContactJwtFromJwtUrl(rawValue);
      if (!jwt) {
        logger.warn("Invalid QR code format - no JWT found in URL");
        this.$notify({
          group: "alert",
          type: "danger",
          title: "Invalid QR Code",
          text: "This QR code does not contain valid contact information. Please scan a TimeSafari contact QR code.",
        });
        return;
      }

      // Process JWT and contact info
      logger.info("Decoding JWT payload from QR code");
      const decodedJwt = await decodeEndorserJwt(jwt);
      if (!decodedJwt?.payload?.own) {
        logger.warn("Invalid JWT payload - missing 'own' field");
        this.$notify({
          group: "alert",
          type: "danger",
          title: "Invalid Contact Info",
          text: "The contact information is incomplete or invalid.",
        });
        return;
      }

      const contactInfo = decodedJwt.payload.own;
      const did = contactInfo.did || decodedJwt.payload.iss;
      if (!did) {
        logger.warn("Invalid contact info - missing DID");
        this.$notify({
          group: "alert",
          type: "danger",
          title: "Invalid Contact",
          text: "The contact DID is missing.",
        });
        return;
      }

      // Create contact object
      const contact = {
        did: did,
        name: contactInfo.name || "",
        email: contactInfo.email || "",
        phone: contactInfo.phone || "",
        company: contactInfo.company || "",
        title: contactInfo.title || "",
        notes: contactInfo.notes || "",
      };

      // Add contact but keep scanning
      logger.info("Adding new contact to database:", {
        did: contact.did,
        name: contact.name,
      });
      await this.addNewContact(contact);
    } catch (error) {
      logger.error("Error processing contact QR code:", {
        error: error instanceof Error ? error.message : String(error),
        stack: error instanceof Error ? error.stack : undefined,
      });
      this.$notify({
        group: "alert",
        type: "danger",
        title: "Error",
        text:
          error instanceof Error
            ? error.message
            : "Could not process QR code. Please try again.",
      });
    }
  }

  onScanError(error: Error) {
    this.error = error.message;
    logger.error("QR code scan error:", {
      error: error.message,
      stack: error.stack,
    });
  }

  async setVisibility(contact: Contact, visibility: boolean) {
    const result = await setVisibilityUtil(
      this.activeDid,
      this.apiServer,
      this.axios,
      db,
      contact,
      visibility,
    );
    if (result.error) {
      this.$notify({
        group: "alert",
        type: "danger",
        title: "Error Setting Visibility",
        text: result.error as string,
      });
    } else if (!result.success) {
      logger.warn("Unexpected result from setting visibility:", result);
    }
  }

  async addNewContact(contact: Contact) {
    try {
      logger.info("Opening database connection for new contact");

      // Check if contact already exists
      const platformService = PlatformServiceFactory.getInstance();
      const dbAllContacts = await platformService.dbQuery(
        "SELECT * FROM contacts WHERE did = ?",
        [contact.did],
      );
      const existingContacts = databaseUtil.mapQueryResultToValues(
        dbAllContacts,
      ) as unknown as Contact[];
      let existingContact: Contact | undefined = existingContacts[0];
      if (USE_DEXIE_DB) {
        await db.open();
        const existingContacts = await db.contacts.toArray();
        existingContact = existingContacts.find((c) => c.did === contact.did);
      }

      if (existingContact) {
        logger.info("Contact already exists", { did: contact.did });
        this.$notify(
          {
            group: "alert",
            type: "warning",
            title: "Contact Exists",
            text: "This contact has already been added to your list.",
          },
          3000,
        );
        return;
      }

      // Add new contact
      // @ts-expect-error because we're just using the value to store to the DB
      contact.contactMethods = JSON.stringify(
        parseJsonField(contact.contactMethods, []),
      );
      const { sql, params } = databaseUtil.generateInsertStatement(
        contact as unknown as Record<string, unknown>,
        "contacts",
      );
      await platformService.dbExec(sql, params);
      if (USE_DEXIE_DB) {
        await db.contacts.add(contact);
      }

      if (this.activeDid) {
        logger.info("Setting contact visibility", { did: contact.did });
        await this.setVisibility(contact, true);
        contact.seesMe = true;
      }

      this.$notify(
        {
          group: "alert",
          type: "success",
          title: "Contact Added",
          text: this.activeDid
            ? "They were added, and your activity is visible to them."
            : "They were added.",
        },
        3000,
      );
    } catch (error) {
      logger.error("Error saving contact to database:", {
        did: contact.did,
        error: error instanceof Error ? error.message : String(error),
        stack: error instanceof Error ? error.stack : undefined,
      });
      this.$notify(
        {
          group: "alert",
          type: "danger",
          title: "Contact Error",
          text: "Could not save contact. Check if it already exists.",
        },
        5000,
      );
    }
  }

  // Lifecycle hooks
  mounted() {
    this.isMounted = true;
    document.addEventListener("pause", this.handleAppPause);
    document.addEventListener("resume", this.handleAppResume);
    this.startScanning(); // Automatically start scanning when view is mounted
  }

  beforeDestroy() {
    this.isMounted = false;
    document.removeEventListener("pause", this.handleAppPause);
    document.removeEventListener("resume", this.handleAppResume);
    this.cleanupScanner();
  }

  async handleAppPause() {
    if (!this.isMounted) return;

    logger.info("App paused, stopping scanner");
    await this.stopScanning();
  }

  handleAppResume() {
    if (!this.isMounted) return;

    logger.info("App resumed, scanner can be restarted by user");
    this.isScanning = false;
  }

  async handleBack() {
    await this.cleanupScanner();
    this.$router.back();
  }

  toastQRCodeHelp() {
    this.$notify(
      {
        group: "alert",
        type: "info",
        title: "QR Code Help",
        text: "Click the QR code to copy your contact info to your clipboard.",
      },
      5000,
    );
  }

  onCopyUrlToClipboard() {
    useClipboard()
      .copy(this.qrValue)
      .then(() => {
        this.$notify(
          {
            group: "alert",
            type: "toast",
            title: "Copied",
            text: "Contact URL was copied to clipboard.",
          },
          2000,
        );
      });
  }

  onCopyDidToClipboard() {
    useClipboard()
      .copy(this.activeDid)
      .then(() => {
        this.$notify(
          {
            group: "alert",
            type: "info",
            title: "Copied",
            text: "Your DID was copied to the clipboard. Have them paste it in the box on their 'People' screen to add you.",
          },
          5000,
        );
      });
  }

  openUserNameDialog() {
    (this.$refs.userNameDialog as IUserNameDialog).open((name: string) => {
      this.givenName = name;
    });
  }
}
</script>

<style scoped>
.aspect-square {
  aspect-ratio: 1 / 1;
}
</style>