@nosto/search-js 3.21.0 → 3.21.2

package/dist/core/src/addToCart.d.ts

@@ -8,5 +8,22 @@ export type SearchHitWithSku = SearchHit & {
  * @param type - The type of search that the hit belongs to.
  * @param hit - The search hit to add to the cart.
  * @param quantity - The quantity of the hit to add to the cart.
+ *
+ * @example
+ * ```ts
+ * import { addToCart } from '@nosto/search-js'
+ *
+ * // Add a single product to cart
+ * await addToCart('serp', {
+ *   productId: '123',
+ *   skuId: 'sku-123'
+ * })
+ *
+ * // Add multiple quantities
+ * await addToCart('serp', {
+ *   productId: '456',
+ *   skuId: 'sku-456'
+ * }, 3)
+ * ```
  */
 export declare function addToCart(type: SearchTrackOptions, hit: SearchHitWithSku, quantity?: number): Promise<void>;

package/dist/core/src/search.d.ts

@@ -6,5 +6,33 @@ import { DecoratedResult, HitDecorator, SearchOptions } from './types';
  * @param query - The search query to be executed.
  * @param options - An object containing optional parameters for the search.
  * @returns A promise that resolves to the search result.
+ *
+ * @example
+ * ```ts
+ * import { search } from '@nosto/search-js'
+ * import { priceDecorator } from '@nosto/search-js/currencies'
+ *
+ * // Basic search
+ * const results = await search({ query: 'shoes' })
+ *
+ * // Search with decorators
+ * const decoratedResults = await search(
+ *   { query: 'shoes' },
+ *   { hitDecorators: [priceDecorator()] }
+ * )
+ * ```
+ *
+ * @example
+ * ```ts
+ * import { search } from '@nosto/search-js'
+ *
+ * // Search with filters
+ * const results = await search({
+ *   query: 'shoes',
+ *   filters: {
+ *     color: ['red', 'blue']
+ *   }
+ * })
+ * ```
  */
 export declare function search<HD extends readonly HitDecorator[]>(query: SearchQuery, options?: SearchOptions<HD>): Promise<DecoratedResult<HD>>;

package/dist/currencies/src/getCurrencyFormatting.d.ts

@@ -5,6 +5,43 @@ export interface CurrencyConfig {
     defaultLocale: string;
     currencySettings: CurrencyFormats;
 }
+/**
+ * Creates a currency formatting function with customizable settings.
+ *
+ * @param overrides - Optional configuration to override default currency settings.
+ * @returns An object containing the formatCurrency function.
+ *
+ * @example
+ * ```ts
+ * import { getCurrencyFormatting } from '@nosto/search-js/currencies'
+ *
+ * // Use default settings from Nosto
+ * const { formatCurrency } = getCurrencyFormatting()
+ * console.log(formatCurrency(1234.56)) // Uses default currency
+ * console.log(formatCurrency(1234.56, 'USD')) // "$1,234.56"
+ * ```
+ *
+ * @example
+ * ```ts
+ * import { getCurrencyFormatting } from '@nosto/search-js/currencies'
+ *
+ * // Override with custom settings
+ * const { formatCurrency } = getCurrencyFormatting({
+ *   defaultCurrency: 'EUR',
+ *   defaultLocale: 'de-DE',
+ *   currencySettings: {
+ *     EUR: {
+ *       currencyBeforeAmount: false,
+ *       currencyToken: '€',
+ *       decimalCharacter: ',',
+ *       groupingSeparator: '.',
+ *       decimalPlaces: 2
+ *     }
+ *   }
+ * })
+ * console.log(formatCurrency(1234.56)) // "1.234,56€"
+ * ```
+ */
 export declare function getCurrencyFormatting(overrides?: Partial<CurrencyConfig>): {
     formatCurrency: (value: number, currency?: string) => string;
 };

package/dist/currencies/src/priceDecorator.d.ts

@@ -8,8 +8,49 @@ export type Result = SearchProduct & FormattedPrices & {
     skus?: (SearchProductSku & FormattedPrices)[];
 };
 /**
- * Exposes currency formatting logic as a SearchProduct decorator
- * Sets priceText and listPriceText fields on product and SKU level
- * Requires price, listPrice and priceCurrencyCode fields to be present
+ * Exposes currency formatting logic as a SearchProduct decorator.
+ * Sets priceText and listPriceText fields on product and SKU level.
+ * Requires price, listPrice and priceCurrencyCode fields to be present.
+ *
+ * @param config - Optional configuration to customize currency formatting.
+ * @returns A decorator function that adds formatted price text to search products.
+ *
+ * @example
+ * ```ts
+ * import { search } from '@nosto/search-js'
+ * import { priceDecorator } from '@nosto/search-js/currencies'
+ *
+ * // Use with default settings
+ * const results = await search(
+ *   { query: 'shoes' },
+ *   { hitDecorators: [priceDecorator()] }
+ * )
+ * console.log(results.products.hits[0].priceText) // "$99.99"
+ * ```
+ *
+ * @example
+ * ```ts
+ * import { search } from '@nosto/search-js'
+ * import { priceDecorator } from '@nosto/search-js/currencies'
+ *
+ * // Use with custom currency settings
+ * const customDecorator = priceDecorator({
+ *   defaultCurrency: 'EUR',
+ *   currencySettings: {
+ *     EUR: {
+ *       currencyBeforeAmount: true,
+ *       currencyToken: '€',
+ *       decimalCharacter: ',',
+ *       groupingSeparator: '.',
+ *       decimalPlaces: 2
+ *     }
+ *   }
+ * })
+ * const results = await search(
+ *   { query: 'shoes' },
+ *   { hitDecorators: [customDecorator] }
+ * )
+ * console.log(results.products.hits[0].priceText) // "€99,99"
+ * ```
  */
 export declare function priceDecorator(config?: Partial<CurrencyConfig>): (hit: SearchProduct) => Result;

package/dist/preact/hooks/hooks.cjs.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const A=require("../../useActions-CY9uts_o.cjs"),P=require("../../logger-Boh_C6Bz.cjs"),h=require("../../useLoadMore-CBshMpps.cjs"),R=require("../../eventBusSubscribe-oONOUGH8.cjs"),l=require("preact/hooks"),C=require("../../useHistory-rc2PvSkv.cjs"),q=require("../../index.es-Dp6Iaxz3.cjs"),z=require("../../eventBusDispatch-BKQcSHAB.cjs"),F=require("../../parseNumber-FsZ8w61u.cjs");function O(e){const s=h.useNostoAppState(t=>t.response);return e&&Array.isArray(e)||e&&P.isPlainObject(e)?e:s}function X(e,s){const t=e.data?.filter(f=>f.selected).length??0,{active:o}={active:t>0,...s},[n,u]=l.useState(o),{toggleProductFilter:c}=A.useActions(),a=l.useCallback(()=>{u(!n)},[n]);return R.useEventBusSubscribe({event:"events/removeAllFilters",callback:()=>{u(!1)}}),{active:n,selectedFiltersCount:t,toggleActive:a,toggleProductFilter:c}}function E(){const{loading:e,facets:s}=h.useNostoAppState(t=>({loading:t.loading,facets:t.response?.products?.facets??[]}));return{loading:e,facets:s}}function j(e,s){const t=s-e;return!isNaN(t)&&t>0?new Array(s-e).fill(void 0).map((o,n)=>n+e):[]}function B(e){const{query:s,products:t}=h.useNostoAppState(o=>({query:o.query,products:o.response.products}));return l.useMemo(()=>{if(!t)return{totalPages:0,resultsFrom:0,resultsTo:0,pages:[]};const o=s.products?.from??0,n=e?.width??1/0,u=Math.max(Math.floor(n-1)/2,1),c=t.size>0?Math.floor(o/t.size)+1:1,a=t.size>0?Math.ceil(t.total/t.size):0,f=y=>y>=c-u&&y<=c+u,r=o+1,i=Math.min(o+t.total,t.total),d={from:o,page:c,current:!0},p=y=>({from:(y-1)*t.size,page:y,current:y===c}),S=c>1?p(c-1):void 0,v=c<a?p(c+1):void 0,m=c-u-1>1?p(1):void 0,g=c+u+1<a?p(a):void 0,b=j(1,a+1).filter(f).map(p);return!m&&b[0]?.page===2&&b.unshift(p(1)),!g&&b[b.length-1]?.page===a-1&&b.push(p(a)),{totalPages:a,resultsFrom:r,resultsTo:i,current:d,prev:S,next:v,first:m,last:g,pages:b}},[s,t,e?.width])}function V(){const[e,s]=l.useState([]),[t,o]=l.useState([]);return l.useEffect(()=>{q.s(async n=>{const{products:u,segments:c}=await n.getSearchSessionParams();s(c??[]),o(u?.personalizationBoost??[])})},[]),{segments:e,boost:t}}function D(){const{facets:e}=h.useNostoAppState(r=>({facets:r.response.products?.facets??[]})),{replaceFilter:s,toggleProductFilter:t}=A.useActions(),o=l.useCallback(r=>{const i=e?.find(d=>d.type==="stats"&&d.field===r);if(i&&"min"in i&&"max"in i)return i},[e]),n=l.useCallback(r=>e?.find(i=>i.field===r)?.name??r,[e]),u=l.useCallback(r=>"field"in r&&(r.value instanceof Array||r.range instanceof Array),[]),c=l.useCallback(r=>({...r,range:r.range?.map(i=>({gt:i.gt?Number(i.gt):i.gt,gte:i.gte?Number(i.gte):i.gte,lt:i.lt?Number(i.lt):i.lt,lte:i.lte?Number(i.lte):i.lte}))}),[]),a=l.useCallback(r=>(r.value??[]).map(d=>({value:d,field:r.field,name:n(r.field),filter:c(r),remove:()=>{t(r.field,d,!1)}})),[c,n,t]),f=l.useCallback(r=>(r.range??[]).map(d=>{const p=d.gte??d.gt??o(r.field)?.min,S=d.lte??d.lt??o(r.field)?.max;if(p!==void 0&&S!==void 0)return{value:`${p} - ${S}`,field:r.field,name:n(r.field),filter:c(r),remove:()=>{s(r.field,void 0)}}}).filter(Boolean),[c,o,n,s]);return{selectFilters:u,toValueFilter:a,toRangeFilter:f}}function L(){const{filter:e}=h.useNostoAppState(a=>({filter:a.query.products?.filter??[]})),{updateSearch:s}=A.useActions(),{selectFilters:t,toValueFilter:o,toRangeFilter:n}=D(),u=l.useMemo(()=>e?e.filter(t).flatMap(a=>"value"in a?o(a):"range"in a?n(a):[]).filter(Boolean):[],[e,t,n,o]),c=l.useCallback(()=>{s({products:{filter:[]}}),z.dispatchNostoEvent({event:"events/removeAllFilters",params:null})},[s]);return{filters:u,removeAll:c}}function T(e){const{replaceFilter:s}=A.useActions(),{query:t,products:o}=h.useNostoAppState(g=>({query:g.query,products:g.response.products})),n=o?.facets?.find(g=>g.id===e),u=t.products?.filter?.find(g=>g.field===n?.field),[c,a]=_(u),f=n&&"min"in n?Math.floor(n.min??0):0,r=n&&"max"in n?Math.ceil(n.max??0):0,i=l.useMemo(()=>[c??f,a??r],[c,a,f,r]),d=c!==void 0||a!==void 0,[p,S]=l.useState(d),v=l.useCallback(()=>{S(g=>!g)},[]),m=l.useCallback(([g,b])=>{if(!n)return;const y=$(g,b,f,r);s(n.field,y)},[f,r,s,n]);return R.useEventBusSubscribe({event:"events/removeAllFilters",callback:()=>{S(!1)}}),n?{min:f,max:r,range:i,updateRange:m,active:p,toggleActive:v}:H}const H={min:0,max:0,range:[0,0],active:!1,toggleActive:()=>{},updateRange:()=>{}};function _(e){const s=e?.range?.[0];return typeof s=="object"&&("gte"in s||"lte"in s)?[F.parseNumber(s.gte),F.parseNumber(s.lte)]:[void 0,void 0]}function $(e,s,t,o){const n=e!==void 0?Math.floor(e):void 0,u=s!==void 0?Math.ceil(s):void 0,c=n!==void 0,a=u!==void 0;if((t===n||!c)&&(o===u||!a))return;const f={};return c&&n!==t&&(f.gte=n.toString()),a&&u!==o&&(f.lte=u.toString()),Object.keys(f).length>0?f:void 0}function U(e,s){const{min:t,max:o,range:n,updateRange:u}=T(e),{filters:c}=L(),a=l.useMemo(()=>{const d=c.find(m=>m?.filter?.range);let p=null;if(d){const m=d.filter.range?.[0];p=[F.parseNumber(m?.gte),F.parseNumber(m?.lte)]}const S=[];let v=Math.floor(t/s)*s;for(;v<o;){const m=v+s,g=p&&p[0]===v&&p[1]===m;S.push({min:v,max:m,selected:g}),v=m}return S},[c,t,o,s]),f=l.useCallback(d=>{u([d,n[1]])},[n,u]),r=l.useCallback(d=>{u([n[0],d])},[n,u]),i=t!==n[0]||o!==n[1];return{min:t,max:o,range:n,updateRange:u,ranges:a,handleMinChange:f,handleMaxChange:r,isSelected:i}}function I(){const{products:e,keywords:s}=h.useNostoAppState(t=>({products:t.response.products??{hits:[],total:0},keywords:t.response.keywords??{hits:[],total:0}}));return{products:e,keywords:s}}function K(){const e=h.useNostoAppState(t=>t.query.products?.filter);return l.useMemo(()=>e?e.reduce((t,o)=>t+(Array.isArray(o.value)?o.value.length:1),0):0,[e])}const Z=5*60*1e3,N=new Map;function G(e){const[s,t]=l.useState({product:null,loading:!0,error:null});return l.useEffect(()=>{if(!e){t({product:null,loading:!1,error:"Product handle is required"});return}t(n=>({...n,loading:!0,error:null}));const o=Q(e);if(o){t({product:o,loading:!1,error:null});return}J(e).then(n=>{W(e,n),t({product:n,loading:!1,error:null})}).catch(n=>{t({product:null,loading:!1,error:n.message||"Failed to fetch product"})})},[e]),s}async function J(e){const s=await fetch(`/products/${e}.js`);if(!s.ok)throw new Error(`Failed to fetch product: ${s.status} ${s.statusText}`);return s.json()}function Q(e){const s=N.get(e);return s?Date.now()-s.created>Z?(N.delete(e),null):s.product:null}function W(e,s){N.set(e,{product:s,created:Date.now()})}function k(e){return e&&!Number.isNaN(e)?e:0}function Y(e,s){const{from:t,size:o,total:n}=h.useNostoAppState(r=>({from:k(r.query.products?.from??0),size:k(r.response?.products?.size??s),total:k(r.response?.products?.total??0)})),{updateSearch:u}=A.useActions(),c=t+o,a=l.useMemo(()=>[...e].reverse().filter(r=>r<n),[e,n]),f=l.useCallback(r=>{u({products:{size:F.parseNumber(r)}})},[u]);return{from:t,to:c,total:n,size:o,sizeOptions:a,handleSizeChange:f}}function ee(e,s){return e.length!==s.length?!1:e.every(t=>s.find(o=>t.field===o.field&&t.order===o.order))}function te(e){const s=h.useNostoAppState(u=>u.query),{updateSearch:t}=A.useActions(),o=e.find(u=>ee(u.value.sort,s.products?.sort||[]))?.id??e[0]?.id,n=l.useCallback(u=>{const c=e.find(a=>a.id===u);c&&t({products:{sort:c.value.sort}})},[e,t]);return{activeSort:o,setSort:n}}const w=window.SpeechRecognition||window.webkitSpeechRecognition,x=!!(w&&typeof w=="function");function se(){return{listening:!1,startListening:()=>{},stopListening:()=>{}}}function ne({language:e="en-US",interimResults:s=!1,onResult:t,onError:o}={}){const[n,u]=l.useState(!1),c=l.useRef(null),a=l.useCallback(()=>{const r=new w;r.lang=e,r.interimResults=s,r.onstart=()=>u(!0),t&&(r.onresult=i=>{const{transcript:d}=i.results?.[0]?.[0];t(d)}),o&&(r.onerror=i=>o(i.error)),r.onend=()=>u(!1),c.current=r,r.start()},[e,s,o,t]),f=l.useCallback(()=>{c.current?.stop()},[c]);return{listening:n,startListening:a,stopListening:f}}const oe=x?ne:se;function re(e,s){if(!e.length||!s.length)return[];const t=s.reduce((o,n)=>(o[n]={},o),{});return e.forEach(o=>{o.customFields?.forEach(({key:n,value:u})=>{const c=n.toLowerCase();s.includes(c)&&(t[c][u]=t[c][u]||[],t[c][u].push(o))})}),Object.entries(t).filter(o=>Object.keys(o[1]).length).map(([o,n])=>({field:o,options:Object.entries(n).map(([u,c])=>({value:u,skus:c,unavailable:!1,selected:!1}))}))}function ue(e,s){return e.length?e.map(({field:t,options:o})=>({field:t,options:o.map(n=>{const u=!n.skus?.some(a=>Object.entries(s).every(([f,r])=>f===t?!0:a.customFields?.find(d=>d.key.toLowerCase()===f)?.value===r)),c=s[t]===n.value;return{...n,unavailable:u,selected:c}})})):[]}const M=["4XS","3XS","2XS","XXS","XS","S","M","L","XL","XXL","2XL","XXXL","3XL","4XL"];function ce(e){if(M.includes(e))return 1e3+M.indexOf(e);const s=parseFloat(e);return isNaN(s)?e:s}function ie(e,s){return[...s].sort((t,o)=>{const[n,u]=[t.value,o.value].map(ce);return n<u?-1:1})}function ae(e=[],s=[]){const[t,o]=l.useState({}),n=l.useMemo(()=>re(e,s).map(({field:r,options:i})=>({field:r,options:ie(r,i)})),[e,s]),u=l.useMemo(()=>ue(n,t),[n,t]),c=l.useCallback((f,r)=>{o(i=>{const d={...i};return d[f]===r?delete d[f]:d[f]=r,d})},[]),a=l.useMemo(()=>Object.keys(t).filter(i=>t[i]).length===0?[]:u.filter(({field:i})=>t[i]).map(({field:i,options:d})=>{const p=t[i];return d.find(v=>v.value===p)?.skus??[]}).reduce((i,d)=>i.filter(p=>d.includes(p))),[u,t]);return{swatches:u,toggleOption:c,matchedSkus:a}}exports.useActions=A.useActions;exports.useLoadMore=h.useLoadMore;exports.useNostoAppState=h.useNostoAppState;exports.addToHistory=C.addToHistory;exports.getSavedHistory=C.getSavedHistory;exports.useHistory=C.useHistory;exports.speechToTextSupported=x;exports.useDecoratedSearchResults=O;exports.useFacet=X;exports.useFacets=E;exports.usePagination=B;exports.usePersonalization=V;exports.useProductFilters=L;exports.useRange=T;exports.useRangeSelector=U;exports.useResponse=I;exports.useSelectedFiltersCount=K;exports.useShopifyProduct=G;exports.useSizeOptions=Y;exports.useSort=te;exports.useSpeechToText=oe;exports.useSwatches=ae;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const A=require("../../useActions-CY9uts_o.cjs"),P=require("../../logger-Boh_C6Bz.cjs"),h=require("../../useLoadMore-CBshMpps.cjs"),R=require("../../eventBusSubscribe-oONOUGH8.cjs"),l=require("preact/hooks"),C=require("../../useHistory-rc2PvSkv.cjs"),q=require("../../index.es-Dp6Iaxz3.cjs"),z=require("../../eventBusDispatch-BKQcSHAB.cjs"),F=require("../../parseNumber-FsZ8w61u.cjs");function O(e){const s=h.useNostoAppState(t=>t.response);return e&&Array.isArray(e)||e&&P.isPlainObject(e)?e:s}function X(e,s){const t=e.data?.filter(f=>f.selected).length??0,{active:o}={active:t>0,...s},[n,c]=l.useState(o),{toggleProductFilter:u}=A.useActions(),a=l.useCallback(()=>{c(!n)},[n]);return R.useEventBusSubscribe({event:"events/removeAllFilters",callback:()=>{c(!1)}}),{active:n,selectedFiltersCount:t,toggleActive:a,toggleProductFilter:u}}function E(){const{loading:e,facets:s}=h.useNostoAppState(t=>({loading:t.loading,facets:t.response?.products?.facets??[]}));return{loading:e,facets:s}}function j(e,s){const t=s-e;return!isNaN(t)&&t>0?new Array(s-e).fill(void 0).map((o,n)=>n+e):[]}function B(e){const{query:s,products:t}=h.useNostoAppState(o=>({query:o.query,products:o.response.products}));return l.useMemo(()=>{if(!t)return{totalPages:0,resultsFrom:0,resultsTo:0,pages:[]};const o=s.products?.from??0,n=e?.width??1/0,c=Math.max(Math.floor(n-1)/2,1),u=t.size>0?Math.floor(o/t.size)+1:1,a=t.size>0?Math.ceil(t.total/t.size):0,f=y=>y>=u-c&&y<=u+c,r=o+1,i=Math.min(o+t.total,t.total),d={from:o,page:u,current:!0},p=y=>({from:(y-1)*t.size,page:y,current:y===u}),S=u>1?p(u-1):void 0,v=u<a?p(u+1):void 0,m=u-c-1>1?p(1):void 0,g=u+c+1<a?p(a):void 0,b=j(1,a+1).filter(f).map(p);return!m&&b[0]?.page===2&&b.unshift(p(1)),!g&&b[b.length-1]?.page===a-1&&b.push(p(a)),{totalPages:a,resultsFrom:r,resultsTo:i,current:d,prev:S,next:v,first:m,last:g,pages:b}},[s,t,e?.width])}function V(){const[e,s]=l.useState([]),[t,o]=l.useState([]);return l.useEffect(()=>{q.s(async n=>{const{products:c,segments:u}=await n.getSearchSessionParams();s(u??[]),o(c?.personalizationBoost??[])})},[]),{segments:e,boost:t}}function D(){const{facets:e}=h.useNostoAppState(r=>({facets:r.response.products?.facets??[]})),{replaceFilter:s,toggleProductFilter:t}=A.useActions(),o=l.useCallback(r=>{const i=e?.find(d=>d.type==="stats"&&d.field===r);if(i&&"min"in i&&"max"in i)return i},[e]),n=l.useCallback(r=>e?.find(i=>i.field===r)?.name??r,[e]),c=l.useCallback(r=>"field"in r&&(r.value instanceof Array||r.range instanceof Array),[]),u=l.useCallback(r=>({...r,range:r.range?.map(i=>({gt:i.gt?Number(i.gt):i.gt,gte:i.gte?Number(i.gte):i.gte,lt:i.lt?Number(i.lt):i.lt,lte:i.lte?Number(i.lte):i.lte}))}),[]),a=l.useCallback(r=>(r.value??[]).map(d=>({value:d,field:r.field,name:n(r.field),filter:u(r),remove:()=>{t(r.field,d,!1)}})),[u,n,t]),f=l.useCallback(r=>(r.range??[]).map(d=>{const p=d.gte??d.gt??o(r.field)?.min,S=d.lte??d.lt??o(r.field)?.max;if(p!==void 0&&S!==void 0)return{value:`${p} - ${S}`,field:r.field,name:n(r.field),filter:u(r),remove:()=>{s(r.field,void 0)}}}).filter(Boolean),[u,o,n,s]);return{selectFilters:c,toValueFilter:a,toRangeFilter:f}}function L(){const{filter:e}=h.useNostoAppState(a=>({filter:a.query.products?.filter??[]})),{updateSearch:s}=A.useActions(),{selectFilters:t,toValueFilter:o,toRangeFilter:n}=D(),c=l.useMemo(()=>e?e.filter(t).flatMap(a=>"value"in a?o(a):"range"in a?n(a):[]).filter(Boolean):[],[e,t,n,o]),u=l.useCallback(()=>{s({products:{filter:[]}}),z.dispatchNostoEvent({event:"events/removeAllFilters",params:null})},[s]);return{filters:c,removeAll:u}}function T(e){const{replaceFilter:s}=A.useActions(),{query:t,products:o}=h.useNostoAppState(g=>({query:g.query,products:g.response.products})),n=o?.facets?.find(g=>g.id===e),c=t.products?.filter?.find(g=>g.field===n?.field),[u,a]=H(c),f=n&&"min"in n?Math.floor(n.min??0):0,r=n&&"max"in n?Math.ceil(n.max??0):0,i=l.useMemo(()=>[u??f,a??r],[u,a,f,r]),d=u!==void 0||a!==void 0,[p,S]=l.useState(d),v=l.useCallback(()=>{S(g=>!g)},[]),m=l.useCallback(([g,b])=>{if(!n)return;const y=U(g,b,f,r);s(n.field,y)},[f,r,s,n]);return R.useEventBusSubscribe({event:"events/removeAllFilters",callback:()=>{S(!1)}}),n?{min:f,max:r,range:i,updateRange:m,active:p,toggleActive:v}:$}const $={min:0,max:0,range:[0,0],active:!1,toggleActive:()=>{},updateRange:()=>{}};function H(e){const s=e?.range?.[0];return typeof s=="object"&&("gte"in s||"lte"in s)?[F.parseNumber(s.gte),F.parseNumber(s.lte)]:[void 0,void 0]}function U(e,s,t,o){const n=e!==void 0?Math.floor(e):void 0,c=s!==void 0?Math.ceil(s):void 0,u=n!==void 0,a=c!==void 0;if((t===n||!u)&&(o===c||!a))return;const f={};return u&&n!==t&&(f.gte=n.toString()),a&&c!==o&&(f.lte=c.toString()),Object.keys(f).length>0?f:void 0}function _(e,s){const{min:t,max:o,range:n,updateRange:c}=T(e),{filters:u}=L(),a=l.useMemo(()=>{const d=u.find(m=>m?.filter?.range);let p=null;if(d){const m=d.filter.range?.[0];p=[F.parseNumber(m?.gte),F.parseNumber(m?.lte)]}const S=[];let v=Math.floor(t/s)*s;for(;v<o;){const m=v+s,g=p&&p[0]===v&&p[1]===m;S.push({min:v,max:m,selected:g}),v=m}return S},[u,t,o,s]),f=l.useCallback(d=>{c([d,n[1]])},[n,c]),r=l.useCallback(d=>{c([n[0],d])},[n,c]),i=t!==n[0]||o!==n[1];return{min:t,max:o,range:n,updateRange:c,ranges:a,handleMinChange:f,handleMaxChange:r,isSelected:i}}function I(){const{products:e,keywords:s}=h.useNostoAppState(t=>({products:t.response.products??{hits:[],total:0},keywords:t.response.keywords??{hits:[],total:0}}));return{products:e,keywords:s}}function K(){const e=h.useNostoAppState(t=>t.query.products?.filter);return l.useMemo(()=>e?e.reduce((t,o)=>t+(Array.isArray(o.value)?o.value.length:1),0):0,[e])}const Z=5*60*1e3,k=new Map;function G(e){const[s,t]=l.useState({product:null,loading:!0,error:null});return l.useEffect(()=>{if(!e){t({product:null,loading:!1,error:"Product handle is required"});return}t(n=>({...n,loading:!0,error:null}));const o=W(e);if(o){t({product:o,loading:!1,error:null});return}Q(e).then(n=>{Y(e,n),t({product:n,loading:!1,error:null})}).catch(n=>{t({product:null,loading:!1,error:n.message||"Failed to fetch product"})})},[e]),s}function J(e){const s=window.Shopify?.routes?.root;return s?new URL(`${s}products/${e}`,window.location.href):e}async function Q(e){const s=await fetch(J(`/products/${e}.js`));if(!s.ok)throw new Error(`Failed to fetch product: ${s.status} ${s.statusText}`);return s.json()}function W(e){const s=k.get(e);return s?Date.now()-s.created>Z?(k.delete(e),null):s.product:null}function Y(e,s){k.set(e,{product:s,created:Date.now()})}function w(e){return e&&!Number.isNaN(e)?e:0}function ee(e,s){const{from:t,size:o,total:n}=h.useNostoAppState(r=>({from:w(r.query.products?.from??0),size:w(r.response?.products?.size??s),total:w(r.response?.products?.total??0)})),{updateSearch:c}=A.useActions(),u=t+o,a=l.useMemo(()=>[...e].reverse().filter(r=>r<n),[e,n]),f=l.useCallback(r=>{c({products:{size:F.parseNumber(r)}})},[c]);return{from:t,to:u,total:n,size:o,sizeOptions:a,handleSizeChange:f}}function te(e,s){return e.length!==s.length?!1:e.every(t=>s.find(o=>t.field===o.field&&t.order===o.order))}function se(e){const s=h.useNostoAppState(c=>c.query),{updateSearch:t}=A.useActions(),o=e.find(c=>te(c.value.sort,s.products?.sort||[]))?.id??e[0]?.id,n=l.useCallback(c=>{const u=e.find(a=>a.id===c);u&&t({products:{sort:u.value.sort}})},[e,t]);return{activeSort:o,setSort:n}}const N=window.SpeechRecognition||window.webkitSpeechRecognition,x=!!(N&&typeof N=="function");function ne(){return{listening:!1,startListening:()=>{},stopListening:()=>{}}}function oe({language:e="en-US",interimResults:s=!1,onResult:t,onError:o}={}){const[n,c]=l.useState(!1),u=l.useRef(null),a=l.useCallback(()=>{const r=new N;r.lang=e,r.interimResults=s,r.onstart=()=>c(!0),t&&(r.onresult=i=>{const{transcript:d}=i.results?.[0]?.[0];t(d)}),o&&(r.onerror=i=>o(i.error)),r.onend=()=>c(!1),u.current=r,r.start()},[e,s,o,t]),f=l.useCallback(()=>{u.current?.stop()},[u]);return{listening:n,startListening:a,stopListening:f}}const re=x?oe:ne;function ce(e,s){if(!e.length||!s.length)return[];const t=s.reduce((o,n)=>(o[n]={},o),{});return e.forEach(o=>{o.customFields?.forEach(({key:n,value:c})=>{const u=n.toLowerCase();s.includes(u)&&(t[u][c]=t[u][c]||[],t[u][c].push(o))})}),Object.entries(t).filter(o=>Object.keys(o[1]).length).map(([o,n])=>({field:o,options:Object.entries(n).map(([c,u])=>({value:c,skus:u,unavailable:!1,selected:!1}))}))}function ue(e,s){return e.length?e.map(({field:t,options:o})=>({field:t,options:o.map(n=>{const c=!n.skus?.some(a=>Object.entries(s).every(([f,r])=>f===t?!0:a.customFields?.find(d=>d.key.toLowerCase()===f)?.value===r)),u=s[t]===n.value;return{...n,unavailable:c,selected:u}})})):[]}const M=["4XS","3XS","2XS","XXS","XS","S","M","L","XL","XXL","2XL","XXXL","3XL","4XL"];function ie(e){if(M.includes(e))return 1e3+M.indexOf(e);const s=parseFloat(e);return isNaN(s)?e:s}function ae(e,s){return[...s].sort((t,o)=>{const[n,c]=[t.value,o.value].map(ie);return n<c?-1:1})}function le(e=[],s=[]){const[t,o]=l.useState({}),n=l.useMemo(()=>ce(e,s).map(({field:r,options:i})=>({field:r,options:ae(r,i)})),[e,s]),c=l.useMemo(()=>ue(n,t),[n,t]),u=l.useCallback((f,r)=>{o(i=>{const d={...i};return d[f]===r?delete d[f]:d[f]=r,d})},[]),a=l.useMemo(()=>Object.keys(t).filter(i=>t[i]).length===0?[]:c.filter(({field:i})=>t[i]).map(({field:i,options:d})=>{const p=t[i];return d.find(v=>v.value===p)?.skus??[]}).reduce((i,d)=>i.filter(p=>d.includes(p))),[c,t]);return{swatches:c,toggleOption:u,matchedSkus:a}}exports.useActions=A.useActions;exports.useLoadMore=h.useLoadMore;exports.useNostoAppState=h.useNostoAppState;exports.addToHistory=C.addToHistory;exports.getSavedHistory=C.getSavedHistory;exports.useHistory=C.useHistory;exports.speechToTextSupported=x;exports.useDecoratedSearchResults=O;exports.useFacet=X;exports.useFacets=E;exports.usePagination=B;exports.usePersonalization=V;exports.useProductFilters=L;exports.useRange=T;exports.useRangeSelector=_;exports.useResponse=I;exports.useSelectedFiltersCount=K;exports.useShopifyProduct=G;exports.useSizeOptions=ee;exports.useSort=se;exports.useSpeechToText=re;exports.useSwatches=le;

package/dist/preact/hooks/hooks.es.js

@@ -1,18 +1,18 @@
 import { h as A } from "../../useActions-CSNwQtT1.js";
 import { a as k } from "../../logger-_fg_Za9y.js";
 import { a as S } from "../../useLoadMore-2OmOqicJ.js";
-import { u as Ae } from "../../useLoadMore-2OmOqicJ.js";
+import { u as Re } from "../../useLoadMore-2OmOqicJ.js";
 import { u as N } from "../../eventBusSubscribe-CzlS132j.js";
 import { useState as b, useCallback as g, useMemo as y, useEffect as P, useRef as X } from "preact/hooks";
-import { a as xe, g as Le, u as Me } from "../../useHistory-joVBx1r2.js";
+import { a as xe, g as Me, u as Te } from "../../useHistory-joVBx1r2.js";
 import { s as z } from "../../index.es-XNBESE3P.js";
 import { d as C } from "../../eventBusDispatch-DPR2Vwd4.js";
 import { p as R } from "../../parseNumber-QA48nJLp.js";
-function ae(e) {
+function ue(e) {
   const n = S((t) => t.response);
   return e && Array.isArray(e) || e && k(e) ? e : n;
 }
-function ue(e, n) {
+function le(e, n) {
   const t = e.data?.filter((d) => d.selected).length ?? 0, { active: o } = {
     active: t > 0,
     ...n
@@ -35,7 +35,7 @@ function ue(e, n) {
     toggleProductFilter: i
   };
 }
-function le() {
+function de() {
   const { loading: e, facets: n } = S((t) => ({
     loading: t.loading,
     facets: t.response?.products?.facets ?? []
@@ -51,7 +51,7 @@ function O(e, n) {
   const t = n - e;
   return !isNaN(t) && t > 0 ? new Array(n - e).fill(void 0).map((o, r) => r + e) : [];
 }
-function de(e) {
+function fe(e) {
   const { query: n, products: t } = S((o) => ({
     query: o.query,
     products: o.response.products
@@ -86,7 +86,7 @@ function de(e) {
     };
   }, [n, t, e?.width]);
 }
-function fe() {
+function ge() {
   const [e, n] = b([]), [t, o] = b([]);
   return P(() => {
     z(async (r) => {
@@ -176,13 +176,13 @@ function E(e) {
   const { replaceFilter: n } = A(), { query: t, products: o } = S((p) => ({
     query: p.query,
     products: p.response.products
-  })), r = o?.facets?.find((p) => p.id === e), c = t.products?.filter?.find((p) => p.field === r?.field), [i, u] = B(c), d = r && "min" in r ? Math.floor(r.min ?? 0) : 0, s = r && "max" in r ? Math.ceil(r.max ?? 0) : 0, a = y(() => [i ?? d, u ?? s], [i, u, d, s]), l = i !== void 0 || u !== void 0, [f, h] = b(l), v = g(() => {
+  })), r = o?.facets?.find((p) => p.id === e), c = t.products?.filter?.find((p) => p.field === r?.field), [i, u] = $(c), d = r && "min" in r ? Math.floor(r.min ?? 0) : 0, s = r && "max" in r ? Math.ceil(r.max ?? 0) : 0, a = y(() => [i ?? d, u ?? s], [i, u, d, s]), l = i !== void 0 || u !== void 0, [f, h] = b(l), v = g(() => {
     h((p) => !p);
   }, []), m = g(
     ([p, F]) => {
       if (!r)
         return;
-      const w = D(p, F, d, s);
+      const w = U(p, F, d, s);
       n(r.field, w);
     },
     [d, s, n, r]
@@ -217,18 +217,18 @@ const V = {
   updateRange: () => {
   }
 };
-function B(e) {
+function $(e) {
   const n = e?.range?.[0];
   return typeof n == "object" && ("gte" in n || "lte" in n) ? [R(n.gte), R(n.lte)] : [void 0, void 0];
 }
-function D(e, n, t, o) {
+function U(e, n, t, o) {
   const r = e !== void 0 ? Math.floor(e) : void 0, c = n !== void 0 ? Math.ceil(n) : void 0, i = r !== void 0, u = c !== void 0;
   if ((t === r || !i) && (o === c || !u))
     return;
   const d = {};
   return i && r !== t && (d.gte = r.toString()), u && c !== o && (d.lte = c.toString()), Object.keys(d).length > 0 ? d : void 0;
 }
-function ge(e, n) {
+function pe(e, n) {
   const { min: t, max: o, range: r, updateRange: c } = E(e), { filters: i } = q(), u = y(() => {
     const l = i.find((m) => m?.filter?.range);
     let f = null;
@@ -277,7 +277,7 @@ function ge(e, n) {
     isSelected: a
   };
 }
-function pe() {
+function me() {
   const { products: e, keywords: n } = S((t) => ({
     products: t.response.products ?? { hits: [], total: 0 },
     keywords: t.response.keywords ?? { hits: [], total: 0 }
@@ -289,12 +289,12 @@ function pe() {
     keywords: n
   };
 }
-function me() {
+function he() {
   const e = S((t) => t.query.products?.filter);
   return y(() => e ? e.reduce((t, o) => t + (Array.isArray(o.value) ? o.value.length : 1), 0) : 0, [e]);
 }
-const $ = 5 * 60 * 1e3, L = /* @__PURE__ */ new Map();
-function he(e) {
+const B = 5 * 60 * 1e3, x = /* @__PURE__ */ new Map();
+function ve(e) {
   const [n, t] = b({
     product: null,
     loading: !0,
@@ -314,7 +314,7 @@ function he(e) {
       loading: !0,
       error: null
     }));
-    const o = _(e);
+    const o = H(e);
     if (o) {
       t({
         product: o,
@@ -323,8 +323,8 @@ function he(e) {
       });
       return;
     }
-    U(e).then((r) => {
-      H(e, r), t({
+    _(e).then((r) => {
+      I(e, r), t({
         product: r,
         loading: !1,
         error: null
@@ -338,30 +338,34 @@ function he(e) {
     });
   }, [e]), n;
 }
-async function U(e) {
-  const n = await fetch(`/products/${e}.js`);
+function D(e) {
+  const n = window.Shopify?.routes?.root;
+  return n ? new URL(`${n}products/${e}`, window.location.href) : e;
+}
+async function _(e) {
+  const n = await fetch(D(`/products/${e}.js`));
   if (!n.ok)
     throw new Error(`Failed to fetch product: ${n.status} ${n.statusText}`);
   return n.json();
 }
-function _(e) {
-  const n = L.get(e);
-  return n ? Date.now() - n.created > $ ? (L.delete(e), null) : n.product : null;
+function H(e) {
+  const n = x.get(e);
+  return n ? Date.now() - n.created > B ? (x.delete(e), null) : n.product : null;
 }
-function H(e, n) {
-  L.set(e, {
+function I(e, n) {
+  x.set(e, {
     product: n,
     created: Date.now()
   });
 }
-function x(e) {
+function L(e) {
   return e && !Number.isNaN(e) ? e : 0;
 }
-function ve(e, n) {
+function Se(e, n) {
   const { from: t, size: o, total: r } = S((s) => ({
-    from: x(s.query.products?.from ?? 0),
-    size: x(s.response?.products?.size ?? n),
-    total: x(s.response?.products?.total ?? 0)
+    from: L(s.query.products?.from ?? 0),
+    size: L(s.response?.products?.size ?? n),
+    total: L(s.response?.products?.total ?? 0)
   })), { updateSearch: c } = A(), i = t + o, u = y(() => [...e].reverse().filter((s) => s < r), [e, r]), d = g(
     (s) => {
       c({
@@ -387,11 +391,11 @@ function ve(e, n) {
     handleSizeChange: d
   };
 }
-function I(e, n) {
+function K(e, n) {
   return e.length !== n.length ? !1 : e.every((t) => n.find((o) => t.field === o.field && t.order === o.order));
 }
-function Se(e) {
-  const n = S((c) => c.query), { updateSearch: t } = A(), o = e.find((c) => I(c.value.sort, n.products?.sort || []))?.id ?? e[0]?.id, r = g(
+function ye(e) {
+  const n = S((c) => c.query), { updateSearch: t } = A(), o = e.find((c) => K(c.value.sort, n.products?.sort || []))?.id ?? e[0]?.id, r = g(
     (c) => {
       const i = e.find((u) => u.id === c);
       i && t({
@@ -409,8 +413,8 @@ function Se(e) {
     setSort: r
   };
 }
-const M = window.SpeechRecognition || window.webkitSpeechRecognition, K = !!(M && typeof M == "function");
-function Z() {
+const M = window.SpeechRecognition || window.webkitSpeechRecognition, Z = !!(M && typeof M == "function");
+function G() {
   return {
     listening: !1,
     startListening: () => {
@@ -419,7 +423,7 @@ function Z() {
     }
   };
 }
-function G({
+function J({
   language: e = "en-US",
   interimResults: n = !1,
   onResult: t,
@@ -440,8 +444,8 @@ function G({
     stopListening: d
   };
 }
-const ye = K ? G : Z;
-function J(e, n) {
+const Fe = Z ? J : G;
+function Q(e, n) {
   if (!e.length || !n.length) return [];
   const t = n.reduce((o, r) => (o[r] = {}, o), {});
   return e.forEach((o) => {
@@ -459,7 +463,7 @@ function J(e, n) {
     }))
   }));
 }
-function Q(e, n) {
+function W(e, n) {
   return e.length ? e.map(({ field: t, options: o }) => ({
     field: t,
     options: o.map((r) => {
@@ -473,23 +477,23 @@ function Q(e, n) {
   })) : [];
 }
 const T = ["4XS", "3XS", "2XS", "XXS", "XS", "S", "M", "L", "XL", "XXL", "2XL", "XXXL", "3XL", "4XL"];
-function W(e) {
+function Y(e) {
   if (T.includes(e))
     return 1e3 + T.indexOf(e);
   const n = parseFloat(e);
   return isNaN(n) ? e : n;
 }
-function Y(e, n) {
+function ee(e, n) {
   return [...n].sort((t, o) => {
-    const [r, c] = [t.value, o.value].map(W);
+    const [r, c] = [t.value, o.value].map(Y);
     return r < c ? -1 : 1;
   });
 }
-function Fe(e = [], n = []) {
-  const [t, o] = b({}), r = y(() => J(e, n).map(({ field: s, options: a }) => ({
+function we(e = [], n = []) {
+  const [t, o] = b({}), r = y(() => Q(e, n).map(({ field: s, options: a }) => ({
     field: s,
-    options: Y(s, a)
-  })), [e, n]), c = y(() => Q(r, t), [r, t]), i = g((d, s) => {
+    options: ee(s, a)
+  })), [e, n]), c = y(() => W(r, t), [r, t]), i = g((d, s) => {
     o((a) => {
       const l = { ...a };
       return l[d] === s ? delete l[d] : l[d] = s, l;
@@ -502,25 +506,25 @@ function Fe(e = [], n = []) {
 }
 export {
   xe as addToHistory,
-  Le as getSavedHistory,
-  K as speechToTextSupported,
+  Me as getSavedHistory,
+  Z as speechToTextSupported,
   A as useActions,
-  ae as useDecoratedSearchResults,
-  ue as useFacet,
-  le as useFacets,
-  Me as useHistory,
-  Ae as useLoadMore,
+  ue as useDecoratedSearchResults,
+  le as useFacet,
+  de as useFacets,
+  Te as useHistory,
+  Re as useLoadMore,
   S as useNostoAppState,
-  de as usePagination,
-  fe as usePersonalization,
+  fe as usePagination,
+  ge as usePersonalization,
   q as useProductFilters,
   E as useRange,
-  ge as useRangeSelector,
-  pe as useResponse,
-  me as useSelectedFiltersCount,
-  he as useShopifyProduct,
-  ve as useSizeOptions,
-  Se as useSort,
-  ye as useSpeechToText,
-  Fe as useSwatches
+  pe as useRangeSelector,
+  me as useResponse,
+  he as useSelectedFiltersCount,
+  ve as useShopifyProduct,
+  Se as useSizeOptions,
+  ye as useSort,
+  Fe as useSpeechToText,
+  we as useSwatches
 };

package/dist/preact/hooks/src/useRange.d.ts

@@ -31,13 +31,6 @@ type RangeProps = [number | undefined, number | undefined];
  * ```
  */
 export declare function useRange(id: string): {
-    readonly min: 0;
-    readonly max: 0;
-    readonly range: readonly [0, 0];
-    readonly active: false;
-    readonly toggleActive: () => void;
-    readonly updateRange: () => void;
-} | {
     /** Min value */
     min: number;
     /** Max value */

package/dist/preact/hooks/src/useRangeSelector.d.ts

@@ -80,9 +80,9 @@ export declare function useRangeSelector(id: string, rangeSize: number): {
     /** Maximum value */
     max: number;
     /** Range value */
-    range: number[] | readonly [0, 0];
+    range: number[];
     /** Update range function */
-    updateRange: (([from, to]: [number | undefined, number | undefined]) => void) | (() => void);
+    updateRange: ([from, to]: [number | undefined, number | undefined]) => void;
     /** Ranges */
     ranges: {
         min: number;

package/dist/thumbnails/src/thumbnailDecorator.d.ts

@@ -5,5 +5,29 @@ export type Config = {
 /**
  * Replaces full size images with thumbnail sized versions.
  * Uses `shopifyThumbnailDecorator` and `nostoThumbnailDecorator` based on the platform.
+ *
+ * @param config - Configuration object specifying the desired thumbnail size.
+ * @returns A decorator function that transforms image URLs to thumbnail versions.
+ *
+ * @example
+ * ```ts
+ * import { search } from '@nosto/search-js'
+ * import { thumbnailDecorator } from '@nosto/search-js/thumbnails'
+ *
+ * // Use thumbnail decorator with search
+ * const results = await search(
+ *   { query: 'shoes' },
+ *   {
+ *     hitDecorators: [
+ *       thumbnailDecorator({ size: '200x200' })
+ *     ]
+ *   }
+ * )
+ * console.log(results.products.hits[0].thumb_url)
+ *
+ * // Available sizes: '100x100', '200x200', '400x400', '600x600', '800x800'
+ * const smallThumbs = thumbnailDecorator({ size: '100x100' })
+ * const largeThumbs = thumbnailDecorator({ size: '800x800' })
+ * ```
  */
 export declare function thumbnailDecorator({ size }: Config): (hit: import('@nosto/nosto-js/client').SearchProduct) => import('@nosto/nosto-js/client').SearchProduct;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nosto/search-js",
-  "version": "3.21.0",
+  "version": "3.21.2",
   "license": "ISC",
   "type": "module",
   "files": [
@@ -99,30 +99,30 @@
   "devDependencies": {
     "@commitlint/cli": "^20.1.0",
     "@commitlint/config-conventional": "^20.0.0",
-    "@nosto/nosto-js": "^2.8.0",
+    "@nosto/nosto-js": "^2.9.0",
     "@testing-library/dom": "^10.4.1",
     "@types/dom-speech-recognition": "^0.0.7",
     "@types/eslint-config-prettier": "^6.11.3",
-    "@types/node": "^24.7.0",
+    "@types/node": "^24.9.0",
     "@vitest/coverage-v8": "^3.2.4",
     "concurrently": "^9.2.1",
     "copyfiles": "^2.4.1",
-    "eslint": "^9.37.0",
+    "eslint": "^9.38.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-barrel-files": "^3.0.1",
     "eslint-plugin-prettier": "^5.5.4",
     "eslint-plugin-react": "^7.37.5",
-    "eslint-plugin-react-hooks": "^6.1.1",
+    "eslint-plugin-react-hooks": "^7.0.0",
     "eslint-plugin-simple-import-sort": "^12.1.1",
-    "eslint-plugin-unused-imports": "^4.2.0",
+    "eslint-plugin-unused-imports": "^4.3.0",
     "husky": "^9.1.7",
     "isbot": "^5.1.31",
-    "jsdom": "^27.0.0",
+    "jsdom": "^27.0.1",
     "prettier": "^3.6.2",
-    "typedoc": "^0.28.13",
+    "typedoc": "^0.28.14",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.46.0",
-    "vite": "^7.1.9",
+    "typescript-eslint": "^8.46.2",
+    "vite": "^7.1.11",
     "vite-plugin-dts": "^4.5.4",
     "vitest": "^3.1.3"
   },