URO-208: orcidlink main view

src/common/api/orcidLinkCommon.ts

@@ -0,0 +1,73 @@
+export interface ORCIDAuthPublic {
+  expires_in: number;
+  name: string;
+  orcid: string;
+  scope: string;
+}
+
+export interface LinkRecordPublic {
+  created_at: number;
+  expires_at: number;
+  retires_at: number;
+  username: string;
+  orcid_auth: ORCIDAuthPublic;
+}
+
+export interface ORCIDAuthPublicNonOwner {
+  orcid: string;
+  name: string;
+}
+
+export interface LinkRecordPublicNonOwner {
+  username: string;
+  orcid_auth: ORCIDAuthPublicNonOwner;
+}
+
+// ORCID User Profile (our version)
+
+export interface Affiliation {
+  name: string;
+  role: string;
+  startYear: string;
+  endYear: string | null;
+}
+
+export interface ORCIDFieldGroupBase {
+  private: boolean;
+}
+
+export interface ORCIDFieldGroupPrivate extends ORCIDFieldGroupBase {
+  private: true;
+  fields: null;
+}
+
+export interface ORCIDFieldGroupAccessible<T> extends ORCIDFieldGroupBase {
+  private: false;
+  fields: T;
+}
+
+export type ORCIDFieldGroup<T> =
+  | ORCIDFieldGroupPrivate
+  | ORCIDFieldGroupAccessible<T>;
+
+export interface ORCIDNameFieldGroup {
+  firstName: string;
+  lastName: string | null;
+  creditName: string | null;
+}
+
+export interface ORCIDBiographyFieldGroup {
+  bio: string;
+}
+
+export interface ORCIDEmailFieldGroup {
+  emailAddresses: Array<string>;
+}
+
+export interface ORCIDProfile {
+  orcidId: string;
+  nameGroup: ORCIDFieldGroup<ORCIDNameFieldGroup>;
+  biographyGroup: ORCIDFieldGroup<ORCIDBiographyFieldGroup>;
+  emailGroup: ORCIDFieldGroup<ORCIDEmailFieldGroup>;
+  employment: Array<Affiliation>;
+}

src/common/api/orcidlinkAPI.ts

@@ -1,56 +1,67 @@
 import { baseApi } from '.';
-import { jsonRpcService } from './utils/serviceHelpers';
+import { LinkRecordPublic, ORCIDProfile } from './orcidLinkCommon';
+import { jsonRpc2Service } from './utils/serviceHelpers';
 
-// orcidlink system types
+// system info
 
-export interface ORCIDAuthPublic {
-  expires_in: number;
+export interface ServiceDescription {
   name: string;
-  orcid: string;
-  scope: string;
+  title: string;
+  version: string;
+  language: string;
+  description: string;
+  repoURL: string;
 }
 
-export interface LinkRecordPublic {
-  created_at: number;
-  expires_at: number;
-  retires_at: number;
-  username: string;
-  orcid_auth: ORCIDAuthPublic;
+export interface GitInfo {
+  commit_hash: string;
+  commit_hash_abbreviated: string;
+  author_name: string;
+  committer_name: string;
+  committer_date: number;
+  url: string;
+  branch: string;
+  tag: string | null;
 }
 
-// Method types
-
-export interface StatusResult {
-  status: string;
+export interface RuntimeInfo {
   current_time: number;
-  start_time: number;
+  orcid_api_url: string;
+  orcid_oauth_url: string;
+  orcid_site_url: string;
 }
 
+// TODO: normalize to either kebab or underscore. Pref underscore.
 export interface InfoResult {
-  'service-description': {
-    name: string;
-    title: string;
-    version: string;
-  };
+  'service-description': ServiceDescription;
+  'git-info': GitInfo;
+  runtime_info: RuntimeInfo;
 }
 
-// is-linked
+// combined api calls for initial view
+
+export interface ORCIDLinkInitialStateResult {
+  isLinked: boolean;
+  info: InfoResult;
+}
 
-export interface IsLinkedParams {
+export interface ORCIDLinkInitialStateParams {
   username: string;
 }
 
-export type IsLinkedResult = boolean;
+// combined api call for linked user info
 
-// owner-link
-export interface OwnerLinkParams {
-  username: string;
+export interface ORCIDLinkLinkedUserInfoResult {
+  linkRecord: LinkRecordPublic;
+  profile: ORCIDProfile;
 }
 
-export type OwnerLinkResult = LinkRecordPublic;
+export interface ORCIDLinkLinkedUserInfoParams {
+  username: string;
+}
 
 // It is mostly a JSONRPC 2.0 service, although the oauth flow is rest-ish.
-const orcidlinkService = jsonRpcService({
+const orcidlinkService = jsonRpc2Service({
   url: '/services/orcidlink/api/v1',
   version: '2.0',
 });
@@ -62,31 +73,76 @@ export const orcidlinkAPI = baseApi
   .enhanceEndpoints({ addTagTypes: ['ORCIDLink'] })
   .injectEndpoints({
     endpoints: ({ query }) => ({
-      orcidlinkStatus: query<StatusResult, {}>({
-        query: () => {
-          return orcidlinkService({
-            method: 'status',
-          });
-        },
-      }),
-      orcidlinkIsLinked: query<IsLinkedResult, IsLinkedParams>({
-        query: ({ username }) => {
-          return orcidlinkService({
-            method: 'is-linked',
-            params: {
-              username,
+      orcidlinkInitialState: query<
+        ORCIDLinkInitialStateResult,
+        ORCIDLinkInitialStateParams
+      >({
+        async queryFn({ username }, _queryApi, _extraOptions, fetchWithBQ) {
+          const [isLinked, info] = await Promise.all([
+            fetchWithBQ(
+              orcidlinkService({
+                method: 'is-linked',
+                params: {
+                  username,
+                },
+              })
+            ),
+            fetchWithBQ(
+              orcidlinkService({
+                method: 'info',
+              })
+            ),
+          ]);
+          if (isLinked.error) {
+            return { error: isLinked.error };
+          }
+          if (info.error) {
+            return { error: info.error };
+          }
+          return {
+            data: {
+              isLinked: isLinked.data as boolean,
+              info: info.data as InfoResult,
             },
-          });
+          };
         },
       }),
-      orcidlinkOwnerLink: query<OwnerLinkResult, OwnerLinkParams>({
-        query: ({ username }) => {
-          return orcidlinkService({
-            method: 'owner-link',
+      orcidlinkLinkedUserInfo: query<
+        ORCIDLinkLinkedUserInfoResult,
+        ORCIDLinkLinkedUserInfoParams
+      >({
+        async queryFn({ username }, _queryApi, _extraOptions, fetchWithBQ) {
+          const profileQuery = orcidlinkService({
+            method: 'get-orcid-profile',
             params: {
               username,
             },
           });
+
+          const [linkRecord, profile] = await Promise.all([
+            fetchWithBQ(
+              orcidlinkService({
+                method: 'owner-link',
+                params: {
+                  username,
+                },
+              })
+            ),
+            fetchWithBQ(profileQuery),
+          ]);
+          if (linkRecord.error) {
+            return { error: linkRecord.error };
+          }
+
+          if (profile.error) {
+            return { error: profile.error };
+          }
+          return {
+            data: {
+              linkRecord: linkRecord.data as LinkRecordPublic,
+              profile: profile.data as ORCIDProfile,
+            },
+          };
         },
       }),
     }),

src/common/api/utils/common.ts

@@ -49,6 +49,29 @@ export const isJsonRpcError = (obj: unknown): obj is JsonRpcError => {
   return false;
 };
 
+export const isJsonRpc20Error = (obj: unknown): obj is JsonRpcError => {
+  if (
+    typeof obj === 'object' &&
+    obj !== null &&
+    ['jsonrpc', 'error', 'id'].every((k) => k in obj)
+  ) {
+    const { jsonrpc, error } = obj as { jsonrpc: string; error: unknown };
+    if (jsonrpc !== '2.0') {
+      return false;
+    }
+    // const versionsSupported = new Set(['1.1', '2.0']);
+    // if (!versionsSupported.has(version)) return false;
+    if (
+      typeof error === 'object' &&
+      error !== null &&
+      ['code', 'message'].every((k) => k in error)
+    ) {
+      return true;
+    }
+  }
+  return false;
+};
+
 /**
  * Type predicate to narrow an unknown error to `FetchBaseQueryError`
  */