docs: Add ts-check + some jsdocs

Author: doubleface

packages/cozy-harvest-lib/src/components/KonnectorConfiguration/ConfigurationTab/BiContractActivationWindow.jsx

@@ -1,3 +1,4 @@
+// @ts-check
 import React, { useState, useEffect } from 'react'
 import PropTypes from 'prop-types'
 import { useClient } from 'cozy-client'

packages/cozy-harvest-lib/src/konnector-policies.js

@@ -7,7 +7,9 @@ const defaultKonnectorPolicy = {
   saveInVault: true,
   onAccountCreation: null,
   match: () => true,
-  name: 'default'
+  name: 'default',
+  fetchExtraOAuthUrlParams: null,
+  refreshContracts: null
 }
 
 const policies = [
@@ -18,6 +20,12 @@ const policies = [
 
 logger.info('Available konnector policies', policies)
 
+/**
+ * Find the konnector policy corresponding to the given konnector
+ *
+ * @param {KonnectorManifest} konnector
+ * @returns {KonnectorPolicy}
+ */
 export const findKonnectorPolicy = konnector => {
   const policy = policies.find(policy => policy.match(konnector))
   logger.info(`Using ${policy.name} konnector policy for ${konnector.slug}`)

packages/cozy-harvest-lib/src/types.js

@@ -39,6 +39,17 @@
  * @property {object} aggregator
  */
 
+/**
+ * @typedef KonnectorPolicy
+ * @property {Boolean} accountContainsAuth
+ * @property {Boolean} saveInVault
+ * @property {Function} onAccountCreation
+ * @property {Function} match
+ * @property {String} name
+ * @property {Function} refreshContracts
+ * @property {Function} fetchExtraOAuthUrlParams
+ */
+
 /**
  * @typedef {CozyClientDocument} IoCozyAccount
  *