feat: Implement FlagshipLinkRequest interface through localMethods

In previous commits we configured the application's cozy-client to use
CozyPouchLink

This link is configured for all react-native side queries, but not for
cozy-app queries as they are served inside of WebViews and use a
different cozy-client instance

We want cozy-apps to benefits from the CozyPouchLink by redirecting
their queries to the react-native side using the new FlagshipLink
interface

With this interface, all cozy-apps queries can be redirected to the
react-native side using cozy-intent/post-me

In order to intercept them, then we should declare
`FlagshipLinkRequest()` method `localMethods`

Related PR: cozy/cozy-client#1505

src/@types/cozy-client.d.ts

@@ -1,7 +1,13 @@
 /* eslint-disable @typescript-eslint/no-unused-vars */
 
 import 'cozy-client'
-import { FileDocument, CozyClientDocument } from 'cozy-client/types/types'
+import { QueryDefinition } from 'cozy-client'
+import {
+  FileDocument,
+  CozyClientDocument,
+  QueryOptions,
+  QueryResult
+} from 'cozy-client/types/types'
 
 declare module 'cozy-client' {
   interface ClientOptions {
@@ -157,6 +163,10 @@ declare module 'cozy-client' {
     on: (event: string, callback: () => void) => void
     removeListener: (event: string, callback: () => void) => void
     logout: () => Promise<void>
+    query: (
+      queryDefinition: QueryDefinition,
+      options?: QueryOptions
+    ) => Promise<QueryResult>
   }
 
   export const createMockClient = (options?: ClientOptions): CozyClient =>

src/libs/intents/flagshipLink.ts

@@ -0,0 +1,33 @@
+import CozyClient, { QueryDefinition } from 'cozy-client'
+import type { QueryResult } from 'cozy-client/types/types'
+import Minilog from 'cozy-minilog'
+
+import { getErrorMessage } from '/libs/functions/getErrorMessage'
+
+const log = Minilog('⛳🔗 flagshipLink')
+
+export const flagshipLinkRequest = async (
+  operation: QueryDefinition,
+  client: CozyClient | undefined
+): Promise<QueryResult> => {
+  try {
+    if (!client) {
+      throw new Error(
+        'FlagshipLinkRequest should not be called with undefined client'
+      )
+    }
+
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+    const result = await client.query(operation)
+
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+    return result
+  } catch (error) {
+    const errorMessage = getErrorMessage(error)
+    log.error(
+      `Something when wrong while processing FlagshipLinkRequest: ${errorMessage}`,
+      operation
+    )
+    throw error
+  }
+}

src/libs/intents/localMethods.ts

@@ -1,7 +1,7 @@
 import { Linking } from 'react-native'
 import { getDeviceName } from 'react-native-device-info'
 
-import CozyClient from 'cozy-client'
+import CozyClient, { QueryDefinition } from 'cozy-client'
 import {
   FlagshipUI,
   NativeMethodsRegisterWithOptions,
@@ -36,6 +36,7 @@ import { openApp } from '/libs/functions/openApp'
 import { routes } from '/constants/routes'
 import { sendKonnectorsLogs } from '/libs/konnectors/sendKonnectorsLogs'
 import { setDefaultRedirection } from '/libs/defaultRedirection/defaultRedirection'
+import { flagshipLinkRequest } from '/libs/intents/flagshipLink'
 import { setFlagshipUI } from '/libs/intents/setFlagshipUI'
 import { showInAppBrowser, closeInAppBrowser } from '/libs/intents/InAppBrowser'
 import { isBiometryDenied } from '/app/domain/authentication/services/BiometryService'
@@ -398,6 +399,8 @@ export const localMethods = (
       _options: PostMeMessageOptions,
       colorScheme: string | undefined
     ) => Promise.resolve(setColorScheme(colorScheme)),
+    flagshipLinkRequest: (_options, operation) =>
+      flagshipLinkRequest(operation as QueryDefinition, client),
     ...mergedMethods
   }
 }