feat(FN-1118): add mobile sharing and deep-link managers

- Implement ShareManager with native Capacitor sharing, web share fallback, and clipboard fallback plus typed share lifecycle events
- Implement DeepLinkManager with native appUrlOpen and browser hash listeners, URL parsing for fusion schemes and universal links, and error events
- Wire plugin exports and initializePlugins support for share/deepLinks options, and configure Capacitor iOS/Android fusion URL schemes
- Add comprehensive Vitest coverage for sharing and deep-link behavior and document usage in the mobile package README

packages/mobile/src/index.ts

@@ -1,44 +1,104 @@
+import {
+  DeepLinkManager,
+  type DeepLinkManagerOptions,
+} from "./plugins/deep-links.js";
 import {
   PushNotificationManager,
   type PushNotificationManagerOptions,
 } from "./plugins/push-notifications.js";
+import { ShareManager, type ShareManagerOptions } from "./plugins/share.js";
 
+export { DeepLinkManager } from "./plugins/deep-links.js";
+export type {
+  DeepLinkEventMap,
+  DeepLinkManagerOptions,
+  DeepLinkPayload,
+} from "./plugins/deep-links.js";
 export { PushNotificationManager } from "./plugins/push-notifications.js";
 export type {
   PushNotificationEventMap,
   PushNotificationManagerOptions,
 } from "./plugins/push-notifications.js";
+export { ShareManager } from "./plugins/share.js";
+export type {
+  ShareEventMap,
+  ShareManagerOptions,
+  ShareTaskPayload,
+} from "./plugins/share.js";
 export type { MobilePluginManager, PluginEventMap } from "./types.js";
 
+interface LifecycleManager {
+  initialize?: () => Promise<void>;
+  start?: () => Promise<void>;
+}
+
 export interface InitializePluginsOptions {
   pushNotifications?:
     | boolean
     | PushNotificationManager
     | PushNotificationManagerOptions;
+  share?: boolean | ShareManager | ShareManagerOptions;
+  deepLinks?: boolean | DeepLinkManager | DeepLinkManagerOptions;
 }
 
 export interface InitializePluginsResult {
   pushNotifications?: PushNotificationManager;
+  share?: ShareManager;
+  deepLinks?: DeepLinkManager;
+}
+
+async function initializeManager(manager: LifecycleManager): Promise<void> {
+  if (typeof manager.initialize === "function") {
+    await manager.initialize();
+    return;
+  }
+
+  if (typeof manager.start === "function") {
+    await manager.start();
+  }
 }
 
 export async function initializePlugins(
   options: InitializePluginsOptions = {},
 ): Promise<InitializePluginsResult> {
   const result: InitializePluginsResult = {};
-  const pushOptions = options.pushNotifications;
 
-  if (!pushOptions) {
-    return result;
+  const pushOptions = options.pushNotifications;
+  if (pushOptions) {
+    const pushNotifications =
+      pushOptions instanceof PushNotificationManager
+        ? pushOptions
+        : new PushNotificationManager(
+            typeof pushOptions === "object" ? pushOptions : undefined,
+          );
+
+    await initializeManager(pushNotifications);
+    result.pushNotifications = pushNotifications;
   }
 
-  const pushNotifications =
-    pushOptions instanceof PushNotificationManager
-      ? pushOptions
-      : new PushNotificationManager(
-          typeof pushOptions === "object" ? pushOptions : undefined,
-        );
+  const shareOptions = options.share;
+  if (shareOptions) {
+    const share =
+      shareOptions instanceof ShareManager
+        ? shareOptions
+        : new ShareManager(typeof shareOptions === "object" ? shareOptions : undefined);
+
+    await initializeManager(share);
+    result.share = share;
+  }
+
+  const deepLinkOptions = options.deepLinks;
+  if (deepLinkOptions) {
+    const deepLinks =
+      deepLinkOptions instanceof DeepLinkManager
+        ? deepLinkOptions
+        : new DeepLinkManager(
+            typeof deepLinkOptions === "object" ? deepLinkOptions : undefined,
+          );
+
+    await initializeManager(deepLinks);
+    result.deepLinks = deepLinks;
+  }
 
-  await pushNotifications.start();
-  result.pushNotifications = pushNotifications;
   return result;
 }