UILD-688: Hub search - LoC source behavior (#287)

* feat: Add configurations for Library of Congress and Local hubs with complex lookup capabilities

* feat: Update HubsModal and SearchView for new hubs lookup functionality and configuration

* feat: Refactor Hubs components and add HubsLookupResultList with local check functionality

* feat: Add local hubs endpoint and update hooks for local availability checks

* feat: Implement local hub availability checks and enrich search results with local data

* feat: Update HubSourceFormatter to differentiate between local and Library of Congress sources

* feat: Refactor hub result formatting and add utility functions for source handling

* feat: Add search operator and check query parameters for hub local checks

* feat: Enhance local hub checks by adding loading state and error handling in hooks

* feat: Add local availability enrichment for Library of Congress hub search results

* feat: Enhance hub search results with local availability enrichment and update source labels

* feat: Remove loading state handling from HubsResultList and simplify data formatting

* feat: Implement local hub availability check service and enrich hub search results

* feat: Refactor HubsLocalAvailabilityEnricher checks, adjust hubsTableConfig width, and update HubSourceFormatter for localization

* feat: Update import button label to 'Import/Edit' for clarity in HubActionFormatter

* feat: Add unit tests for hub local check service, hubs local availability enricher, and hub formatters

* feat: Rename HubsResultList to HubsLookupResultList and update related tests; modify searchUIRegistry tests to check for limit property instead of searchableIndices

* Update changelog

Author: SKarolFolio

CHANGELOG.md

@@ -62,6 +62,7 @@
 * Update Complex lookups to use the new Search feature. Refs [UILD-686].
 * Add Hub tab to landing page. Refs [UILD-687].
 * Add custom workspace profile settings application. Refs [UILD-684].
+* Add Hub search behavior for LoC source. Refs [UILD-688].
 
 [UILD-552]:https://folio-org.atlassian.net/browse/UILD-552
 [UILD-544]:https://folio-org.atlassian.net/browse/UILD-544
@@ -124,6 +125,7 @@
 [UILD-686]:https://folio-org.atlassian.net/browse/UILD-686
 [UILD-687]:https://folio-org.atlassian.net/browse/UILD-687
 [UILD-684]:https://folio-org.atlassian.net/browse/UILD-684
+[UILD-688]:https://folio-org.atlassian.net/browse/UILD-688
 
 ## 1.0.5 (2025-04-30)
 * Fixed incorrect behavior when navigating between duplicated resources. Fixes [UILD-553].

src/common/constants/api.constants.ts

@@ -18,6 +18,7 @@ export const SEARCH_API_ENDPOINT = {
   AUTHORITIES_SEARCH: '/search/authorities',
   AUTHORITIES_BROWSE: '/browse/authorities',
   HUBS_EXTERNAL: 'https://id.loc.gov/resources/hubs/suggest2/',
+  HUBS_LOCAL: '/search/linked-data/hubs',
 };
 
 export const MARC_PREVIEW_ENDPOINT = {

src/common/constants/search.constants.ts

@@ -156,3 +156,11 @@ export enum AuthRefType {
 }
 
 export const SEARCH_QUERY_VALUE_PARAM = ':value';
+
+export const SEARCH_OPERATOR = {
+  OR: 'or',
+};
+
+export const SEARCH_CHECK_QUERY_PARAM = {
+  ORIGINAL_ID: 'originalId',
+};

src/features/complexLookup/components/modals/HubsModal/HubsModal.test.tsx

@@ -51,14 +51,14 @@ jest.mock('@/features/search/ui/components/Search', () => {
 });
 
 jest.mock('@/features/search/ui', () => ({
-  HubsResultList: ({
+  HubsLookupResultList: ({
     context,
     onAssign,
   }: {
     context: string;
     onAssign: (record: ComplexLookupAssignRecordDTO) => void;
   }) => (
-    <div data-testid="hubs-result-list">
+    <div data-testid="hubs-lookup-result-list">
       <span>{context}</span>
       <button onClick={() => onAssign({ id: 'hub-1', title: 'Hub 1' })}>Assign Hub</button>
     </div>
@@ -97,8 +97,8 @@ describe('HubsModal', () => {
       expect(ComplexLookupHooks.useComplexLookupModalState).toHaveBeenCalledWith({
         isOpen: true,
         initialQuery: 'Test Hub',
-        defaultSegment: 'hubs',
-        defaultSource: 'external',
+        defaultSegment: 'hubsLookup',
+        defaultSource: 'libraryOfCongress',
       });
     });
 
@@ -108,8 +108,8 @@ describe('HubsModal', () => {
       expect(ComplexLookupHooks.useComplexLookupModalState).toHaveBeenCalledWith({
         isOpen: true,
         initialQuery: undefined,
-        defaultSegment: 'hubs',
-        defaultSource: 'external',
+        defaultSegment: 'hubsLookup',
+        defaultSource: 'libraryOfCongress',
       });
     });
 
@@ -136,15 +136,15 @@ describe('HubsModal', () => {
       expect(screen.getByTestId('complex-lookup-search-contents')).toBeInTheDocument();
     });
 
-    it('renders HubsResultList with complexLookup context', () => {
+    it('renders HubsLookupResultList with complexLookup context', () => {
       render(<HubsModal isOpen={true} onClose={mockOnClose} onAssign={mockOnAssign} />);
 
-      const resultList = screen.getByTestId('hubs-result-list');
+      const resultList = screen.getByTestId('hubs-lookup-result-list');
       expect(resultList).toBeInTheDocument();
       expect(resultList).toHaveTextContent('complexLookup');
     });
 
-    it('passes onAssign to HubsResultList', () => {
+    it('passes onAssign to HubsLookupResultList', () => {
       render(<HubsModal isOpen={true} onClose={mockOnClose} onAssign={mockOnAssign} />);
 
       const assignButton = screen.getByText('Assign Hub');

src/features/complexLookup/components/modals/HubsModal/HubsModal.tsx

@@ -3,7 +3,7 @@ import { FormattedMessage } from 'react-intl';
 import classNames from 'classnames';
 import { Modal } from '@/components/Modal';
 import { Search } from '@/features/search/ui/components/Search';
-import { HubsResultList } from '@/features/search/ui';
+import { HubsLookupResultList } from '@/features/search/ui';
 import { useComplexLookupModalState } from '@/features/complexLookup/hooks';
 import { IS_EMBEDDED_MODE } from '@/common/constants/build.constants';
 
@@ -22,8 +22,8 @@ export const HubsModal: FC<HubsModalProps> = ({ isOpen, onClose, initialQuery, o
   useComplexLookupModalState({
     isOpen,
     initialQuery,
-    defaultSegment: 'hubs',
-    defaultSource: 'external',
+    defaultSegment: 'hubsLookup',
+    defaultSource: 'libraryOfCongress',
   });
 
   return (
@@ -40,7 +40,13 @@ export const HubsModal: FC<HubsModalProps> = ({ isOpen, onClose, initialQuery, o
       showModalControls={false}
     >
       <div className="complex-lookup-search-contents" data-testid="complex-lookup-search-contents">
-        <Search segments={['hubs']} defaultSegment="hubs" defaultSource="external" flow="value" mode="custom">
+        <Search
+          segments={['hubsLookup']}
+          defaultSegment="hubsLookup"
+          defaultSource="libraryOfCongress"
+          flow="value"
+          mode="custom"
+        >
           <Search.Controls>
             <Search.Controls.InputsWrapper />
             <Search.Controls.SubmitButton />
@@ -53,7 +59,7 @@ export const HubsModal: FC<HubsModalProps> = ({ isOpen, onClose, initialQuery, o
             <Search.ContentContainer>
               <Search.Results>
                 {/* Existing component already supports complexLookup context! */}
-                <HubsResultList context="complexLookup" onAssign={onAssign} />
+                <HubsLookupResultList context="complexLookup" onAssign={onAssign} />
                 <Search.Results.Pagination />
               </Search.Results>
             </Search.ContentContainer>

src/features/complexLookup/configs/resultsTable/index.ts

@@ -1,8 +1,8 @@
 import { authoritiesTableConfig } from '../../../search/ui/config/results/authoritiesTable.config';
-import { hubsTableConfig } from '../../../search/ui/config/results/hubsTable.config';
+import { hubsLookupTableConfig } from '../../../search/ui/config/results/hubsLookupTable.config';
 
 export const SEARCH_RESULTS_TABLE_CONFIG: Record<string, SearchResultsTableConfig> = {
   default: authoritiesTableConfig,
   authorities: authoritiesTableConfig,
-  hub: hubsTableConfig,
+  hub: hubsLookupTableConfig,
 };

src/features/search/core/config/hubsLibraryOfCongress.config.ts

@@ -4,11 +4,12 @@ import type { SearchTypeConfig } from '../types';
 import { HubsLoCRequestBuilder } from '../strategies/requestBuilders';
 import { HubResponseTransformer } from '../strategies/responseTransformers';
 import { HubsResultFormatter } from '../strategies/resultFormatters';
+import { HubsLocalAvailabilityEnricher } from '../strategies/resultEnrichers';
 
 /**
- * Hubs External Configuration (Atomic)
+ * Hubs Library Of Congress Configuration for Search page (Atomic)
  *
- * Search in external hub services.
+ * Search in Library Of Congress hub services.
  * Composite key: "hubs:libraryOfCongress"
  */
 export const hubsLibraryOfCongressConfig: SearchTypeConfig = {
@@ -18,6 +19,7 @@ export const hubsLibraryOfCongressConfig: SearchTypeConfig = {
     requestBuilder: new HubsLoCRequestBuilder(HUB_SEARCHABLE_INDICES_MAP),
     responseTransformer: new HubResponseTransformer(),
     resultFormatter: new HubsResultFormatter(),
+    resultEnricher: new HubsLocalAvailabilityEnricher(),
   },
 
   capabilities: {
@@ -26,7 +28,7 @@ export const hubsLibraryOfCongressConfig: SearchTypeConfig = {
   },
 
   defaults: {
-    searchBy: SearchableIndexEnum.HubNameLeftAnchored,
+    searchBy: SearchableIndexEnum.HubNameKeyword,
     query: '',
     limit: 100, // API fetches 100 results
     offset: 0,

src/features/search/core/config/hubsLocal.config.ts

@@ -3,10 +3,10 @@ import { HUB_SEARCHABLE_INDICES_MAP } from '@/features/complexLookup/configs';
 import type { SearchTypeConfig } from '../types';
 import { HubsLoCRequestBuilder } from '../strategies/requestBuilders';
 import { ResourcesResponseTransformer } from '../strategies/responseTransformers';
-import { HubsResultFormatter } from '../strategies/resultFormatters';
+import { HubsLookupResultFormatter } from '../strategies/resultFormatters';
 
 /**
- * Hubs Internal Configuration (Atomic)
+ * Hubs Local Configuration for Search page (Atomic)
  *
  * Search in local hub registry.
  * Composite key: "hubs:local"
@@ -19,7 +19,7 @@ export const hubsLocalConfig: SearchTypeConfig = {
     // Can be replaced with HubsInternalRequestBuilder when implemented
     requestBuilder: new HubsLoCRequestBuilder(HUB_SEARCHABLE_INDICES_MAP),
     responseTransformer: new ResourcesResponseTransformer(),
-    resultFormatter: new HubsResultFormatter(),
+    resultFormatter: new HubsLookupResultFormatter(),
   },
 
   capabilities: {
@@ -28,7 +28,7 @@ export const hubsLocalConfig: SearchTypeConfig = {
   },
 
   defaults: {
-    searchBy: SearchableIndexEnum.HubNameLeftAnchored,
+    searchBy: SearchableIndexEnum.HubNameKeyword,
     query: '',
     limit: 100, // API fetches 100 results
     offset: 0,

src/features/search/core/config/hubsLookupLibraryOfCongress.config.ts

@@ -0,0 +1,34 @@
+import { SearchableIndex as SearchableIndexEnum } from '@/common/constants/searchableIndex.constants';
+import { HUB_SEARCHABLE_INDICES_MAP } from '@/features/complexLookup/configs';
+import type { SearchTypeConfig } from '../types';
+import { HubsLoCRequestBuilder } from '../strategies/requestBuilders';
+import { HubResponseTransformer } from '../strategies/responseTransformers';
+import { HubsLookupResultFormatter } from '../strategies/resultFormatters';
+
+/**
+ * Hubs Library Of Congress Configuration for Complex Lookup modal (Atomic)
+ *
+ * Search in Library Of Congress hub services.
+ * Composite key: "hubs:libraryOfCongress"
+ */
+export const hubsLookupLibraryOfCongressConfig: SearchTypeConfig = {
+  id: 'hubs:libraryOfCongress',
+
+  strategies: {
+    requestBuilder: new HubsLoCRequestBuilder(HUB_SEARCHABLE_INDICES_MAP),
+    responseTransformer: new HubResponseTransformer(),
+    resultFormatter: new HubsLookupResultFormatter(),
+  },
+
+  capabilities: {
+    defaultLimit: 100,
+    maxLimit: 100,
+  },
+
+  defaults: {
+    searchBy: SearchableIndexEnum.HubNameLeftAnchored,
+    query: '',
+    limit: 100, // API fetches 100 results
+    offset: 0,
+  },
+};

src/features/search/core/config/hubsLookupLocal.config.ts

@@ -0,0 +1,36 @@
+import { SearchableIndex as SearchableIndexEnum } from '@/common/constants/searchableIndex.constants';
+import { HUB_SEARCHABLE_INDICES_MAP } from '@/features/complexLookup/configs';
+import type { SearchTypeConfig } from '../types';
+import { HubsLoCRequestBuilder } from '../strategies/requestBuilders';
+import { ResourcesResponseTransformer } from '../strategies/responseTransformers';
+import { HubsLookupResultFormatter } from '../strategies/resultFormatters';
+
+/**
+ * Hubs Local Configuration for Complex lookups (Atomic)
+ *
+ * Search in local hub registry.
+ * Composite key: "hubs:local"
+ */
+export const hubsLookupLocalConfig: SearchTypeConfig = {
+  id: 'hubs:local',
+
+  strategies: {
+    // Uses same request builder as external for now
+    // Can be replaced with HubsInternalRequestBuilder when implemented
+    requestBuilder: new HubsLoCRequestBuilder(HUB_SEARCHABLE_INDICES_MAP),
+    responseTransformer: new ResourcesResponseTransformer(),
+    resultFormatter: new HubsLookupResultFormatter(),
+  },
+
+  capabilities: {
+    defaultLimit: 100,
+    maxLimit: 100,
+  },
+
+  defaults: {
+    searchBy: SearchableIndexEnum.HubNameLeftAnchored,
+    query: '',
+    limit: 100, // API fetches 100 results
+    offset: 0,
+  },
+};