feat: wire up deeplink2 plugin with desktop app (#1886)

- Add tauri-plugin-deep-link dependency to deeplink2 plugin
- Hook into tauri_plugin_deep_link to listen for deep link URLs
- Parse deep link URLs and emit DeepLinkEvent
- Wire up frontend to listen for DeepLinkEvent and navigate
- Update notification route to handle key search param

Co-authored-by: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-authored-by: yujonglee <[email protected]>

Author: devin-ai-integration[bot]

Cargo.lock

@@ -7,7 +7,10 @@ import {
 import { getCurrentWebviewWindow } from "@tauri-apps/api/webviewWindow";
 import { lazy, useEffect } from "react";
 
-import type { DeepLink } from "@hypr/plugin-deeplink2";
+import {
+  type DeepLink,
+  events as deeplink2Events,
+} from "@hypr/plugin-deeplink2";
 import { events as windowsEvents } from "@hypr/plugin-windows";
 
 import { AuthProvider } from "../auth";
@@ -41,7 +44,8 @@ const useNavigationEvents = () => {
   const navigate = useNavigate();
 
   useEffect(() => {
-    let unlisten: (() => void) | undefined;
+    let unlistenNavigate: (() => void) | undefined;
+    let unlistenDeepLink: (() => void) | undefined;
 
     const webview = getCurrentWebviewWindow();
 
@@ -51,11 +55,20 @@ const useNavigationEvents = () => {
         navigate({ to: payload.path, search: payload.search ?? undefined });
       })
       .then((fn) => {
-        unlisten = fn;
+        unlistenNavigate = fn;
+      });
+
+    deeplink2Events.deepLinkEvent
+      .listen(({ payload }) => {
+        navigate({ to: payload.to, search: payload.search });
+      })
+      .then((fn) => {
+        unlistenDeepLink = fn;
       });
 
     return () => {
-      unlisten?.();
+      unlistenNavigate?.();
+      unlistenDeepLink?.();
     };
   }, [navigate]);
 };

apps/desktop/src/routes/__root.tsx

@@ -1,7 +1,15 @@
 import { createFileRoute, redirect } from "@tanstack/react-router";
 
+import type { NotificationSearch } from "@hypr/plugin-deeplink2";
+
 export const Route = createFileRoute("/notification")({
-  beforeLoad: async () => {
+  validateSearch: (search): NotificationSearch => {
+    return {
+      key: (search as NotificationSearch).key ?? "",
+    };
+  },
+  beforeLoad: async ({ search }) => {
+    console.log("notification deeplink received", search);
     throw redirect({ to: "/app/main" });
   },
 });

apps/desktop/src/routes/notification.tsx

@@ -19,11 +19,13 @@ serde_yaml = { workspace = true }
 
 [dependencies]
 tauri = { workspace = true, features = ["test"] }
+tauri-plugin-deep-link = { workspace = true }
 tauri-specta = { workspace = true, features = ["derive", "typescript"] }
 
 serde = { workspace = true }
 specta = { workspace = true }
 strum = { workspace = true, features = ["derive"] }
 
 thiserror = { workspace = true }
+tracing = { workspace = true }
 url = { workspace = true }

plugins/deeplink2/Cargo.toml

@@ -5,6 +5,12 @@ mod types;
 mod docs;
 
 pub use error::{Error, Result};
+pub use types::{DeepLink, DeepLinkEvent};
+
+use std::str::FromStr;
+
+use tauri_plugin_deep_link::DeepLinkExt;
+use tauri_specta::Event;
 
 const PLUGIN_NAME: &str = "deeplink2";
 
@@ -22,7 +28,30 @@ pub fn init<R: tauri::Runtime>() -> tauri::plugin::TauriPlugin<R> {
 
     tauri::plugin::Builder::new(PLUGIN_NAME)
         .invoke_handler(specta_builder.invoke_handler())
-        .setup(|_app, _api| Ok(()))
+        .setup(|app, _api| {
+            let app_handle = app.clone();
+
+            app.deep_link().on_open_url(move |event| {
+                for url in event.urls() {
+                    let url_str = url.as_str();
+                    tracing::info!(url = url_str, "deeplink_received");
+
+                    match DeepLink::from_str(url_str) {
+                        Ok(deep_link) => {
+                            tracing::info!(deep_link = ?deep_link, "deeplink_parsed");
+                            if let Err(e) = DeepLinkEvent(deep_link).emit(&app_handle) {
+                                tracing::error!(error = ?e, "deeplink_event_emit_failed");
+                            }
+                        }
+                        Err(e) => {
+                            tracing::warn!(error = ?e, url = url_str, "deeplink_parse_failed");
+                        }
+                    }
+                }
+            });
+
+            Ok(())
+        })
         .build()
 }