feat(plugins): provide state to transformSource

Author: francoischalifour

examples/recently-viewed-items/recentlyViewedItemsPlugin.tsx

@@ -48,9 +48,9 @@ export function createLocalStorageRecentlyViewedItems<
 
       return search(params);
     },
-    transformSource({ source, onRemove }) {
+    transformSource({ source, onRemove, state }) {
       const transformedSource = params.transformSource
-        ? params.transformSource({ source, onRemove })
+        ? params.transformSource({ source, onRemove, state })
         : source;
 
       return {

packages/autocomplete-plugin-query-suggestions/src/createQuerySuggestionsPlugin.ts

@@ -18,6 +18,7 @@ export type CreateQuerySuggestionsPluginParams<
   getSearchParams?(params: { state: AutocompleteState<TItem> }): SearchOptions;
   transformSource?(params: {
     source: AutocompleteSource<TItem>;
+    state: AutocompleteState<TItem>;
     onTapAhead(item: TItem): void;
   }): AutocompleteSource<TItem>;
   /**
@@ -115,6 +116,7 @@ export function createQuerySuggestionsPlugin<
             templates: getTemplates({ onTapAhead }),
           },
           onTapAhead,
+          state,
         }),
       ];
     },

packages/autocomplete-plugin-recent-searches/src/createRecentSearchesPlugin.ts

@@ -1,5 +1,6 @@
 import {
   AutocompletePlugin,
+  AutocompleteState,
   PluginSubscribeParams,
 } from '@algolia/autocomplete-core';
 import { AutocompleteSource } from '@algolia/autocomplete-js';
@@ -21,6 +22,7 @@ export type CreateRecentSearchesPluginParams<
   storage: Storage<TItem>;
   transformSource?(params: {
     source: AutocompleteSource<TItem>;
+    state: AutocompleteState<TItem>;
     onRemove(id: string): void;
     onTapAhead(item: TItem): void;
   }): AutocompleteSource<TItem>;
@@ -70,7 +72,7 @@ export function createRecentSearchesPlugin<TItem extends RecentSearchesItem>({
         store.addItem(recentItem as TItem);
       }
     },
-    getSources({ query, setQuery, refresh }) {
+    getSources({ query, setQuery, refresh, state }) {
       lastItemsRef.current = store.getAll(query);
 
       function onRemove(id: string) {
@@ -102,6 +104,7 @@ export function createRecentSearchesPlugin<TItem extends RecentSearchesItem>({
             },
             onRemove,
             onTapAhead,
+            state,
           }),
         ];
       });

packages/website/docs/createLocalStorageRecentSearchesPlugin.md

@@ -140,7 +140,7 @@ function search({ query, items, limit }) {
 
 ### `transformSource`
 
-> `(params: { source: AutocompleteSource, onRemove: () => void, onTapAhead: () => void })`
+> `(params: { source: AutocompleteSource, state: AutocompleteState, onRemove: () => void, onTapAhead: () => void })`
 
 A function to transform the provided source.
 

packages/website/docs/createQuerySuggestionsPlugin.md

@@ -104,7 +104,7 @@ A function returning [Algolia search parameters](https://www.algolia.com/doc/api
 
 ### `transformSource`
 
-> `(params: { source: AutocompleteSource, onTapAhead: () => void })`
+> `(params: { source: AutocompleteSource, state: AutocompleteState, onTapAhead: () => void })`
 
 A function to transform the provided source.
 

packages/website/docs/createRecentSearchesPlugin.md

@@ -145,7 +145,7 @@ type RecentSearchesStorage<TItem extends RecentSearchesItem> = {
 
 ### `transformSource`
 
-> `(params: { source: AutocompleteSource, onRemove: () => void, onTapAhead: () => void })`
+> `(params: { source: AutocompleteSource, state: AutocompleteState, onRemove: () => void, onTapAhead: () => void })`
 
 A function to transform the provided source.