@rubixstudios/payload-typesense 1.2.3 → 1.3.0

package/README.md

@@ -1,10 +1,12 @@
 # PayloadCMS + Typesense Plugin
 
-This plugin is a fork of FrontTribe’s Typesense Search Plugin for Payload CMS.
+Forked from FrontTribe’s Typesense Search Plugin, Rubix Studios implementation has been substantially re-engineered to meet stricter production, deployment, and TypeScript standards. The codebase has been streamlined for improved maintainability, enhanced type safety, and predictable behaviour under load, while preserving full compatibility with Payload CMS and Typesense.
 
-It provides a production-ready integration between Payload CMS and Typesense, delivering fast, typo-tolerant search with real-time synchronization.
+The fork introduces meaningful architectural improvements, including more efficient caching strategies with race-condition mitigation, improved request handling, and deployment-safe defaults. The result is a lighter, more resilient integration.
 
-The Rubix Studios fork introduces targeted enhancements that improve stability, TypeScript precision, and deployment reliability (including full Vercel compatibility) while reducing overall code size by 67% for a lighter, more maintainable build.
+With a modular, tree-shakable structure and optional support for advanced search capabilities such as vector-based querying, the plugin is designed to scale from simple content search implementations to more complex, search-driven applications without unnecessary bloat.
+
+This project is actively maintained by Rubix Studios and is intended for production environments where performance, stability, and code quality are critical.
 
 [![install size](https://packagephobia.com/badge?p=@rubixstudios/payload-typesense)](https://packagephobia.com/result?p=@rubixstudios/payload-typesense)
 **PayloadCMS + Typesense Plugin**
@@ -31,7 +33,13 @@ export default buildConfig({
     typesenseSearch({
       typesense: {
         apiKey: 'xyz',
-        nodes: [{ host: 'localhost', port: 8108, protocol: 'http' }],
+        nodes: [
+          {
+            host: 'localhost',
+            port: 8108,
+            protocol: 'http',
+          },
+        ],
       },
       collections: {
         posts: {
@@ -40,9 +48,15 @@ export default buildConfig({
           facetFields: ['category', 'status'],
           displayName: 'Blog Posts',
           icon: '📝',
-          syncLimit: 500, // overrides default 1000 per page (optional)
+          syncLimit: 500, // Overrides the default per-page sync limit of 1000
         },
       },
+      // This feature is experimental
+      vectorSearch: {
+        enabled: true, // Enables vector-based semantic search
+        embedFrom: ['title', 'content'], // Omit to fall back to collection searchFields
+        embeddingModel: 'ts/all-MiniLM-L12-v2',
+      },
     }),
   ],
 })
@@ -51,27 +65,41 @@ export default buildConfig({
 ```tsx
 import { HeadlessSearchInput } from '@rubixstudios/payload-typesense'
 
-function SearchPage() {
+export function GlobalSearchPage() {
   return (
     <HeadlessSearchInput
       baseUrl="http://localhost:3000"
-      theme="modern" // choose from either modern or dark
+      theme="modern" // Available themes: "modern" | "dark"
       placeholder="Search everything..."
       onResultClick={(result) => {
-        console.log('Selected:', result.document)
+        console.log('Selected document:', result.document)
+      }}
+    />
+  )
+}
+
+export function CollectionSearch() {
+  return (
+    <HeadlessSearchInput
+      baseUrl="http://localhost:3000"
+      collections={['posts', 'products']}
+      placeholder="Search posts and products..."
+      onResultClick={(result) => {
+        console.log('Selected document:', result.document)
       }}
     />
   )
 }
 
-function CollectionSearch() {
+export function VectorSearch() {
   return (
     <HeadlessSearchInput
       baseUrl="http://localhost:3000"
+      vector={true} // Vector search enabled
       collections={['posts', 'products']}
-      placeholder="Search posts & products..."
+      placeholder="Search posts and products..."
       onResultClick={(result) => {
-        console.log('Selected:', result.document)
+        console.log('Selected document:', result.document)
       }}
     />
   )
@@ -80,15 +108,22 @@ function CollectionSearch() {
 
 ## Features
 
-- **Performance**: Sub-millisecond response times for search queries
-- **Flexible**: Single, multiple, or universal collection search with one component
-- **Modern**: Responsive design implemented with Tailwind CSS
-- **Optimized API**: Automatically routes requests to the most efficient endpoint
-- **Real-Time**: Continuous data sync with Payload CMS
-- **Caching**: In-memory cache with configurable time-to-live settings
-- **Production Ready**: Robust error handling and performance optimization
-- **Responsive**: Mobile-first architecture ensuring compatibility across devices
-- **Tree Shakable**: Modular structure for lightweight builds
+- **Performance**  
+  Sub-millisecond search responses with optimized request handling.
+- **Flexible Search**  
+  Single-collection, multi-collection, or universal search using one component.
+- **Vector Search**  
+  Optional semantic search using embeddings, with graceful fallback to keyword search.
+- **Modern UI**  
+  Headless, responsive implementation compatible with Tailwind CSS.
+- **Real-Time Synchronisation**  
+  Continuous indexing and sync with Payload CMS.
+- **Efficient Caching**  
+  In-memory caching with configurable TTL and race-condition safeguards.
+- **Production Ready**  
+  Robust error handling, deployment-safe defaults, and platform compatibility.
+- **Tree-Shakable Architecture**  
+  Modular design enabling smaller bundles and selective feature usage.
 
 ## Endpoints
 

package/dist/components/HeadlessSearchInput.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HeadlessSearchInput.d.ts","sourceRoot":"","sources":["../../src/components/HeadlessSearchInput.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAsC,MAAM,OAAO,CAAA;AAE1D,OAAO,EAAE,KAAK,wBAAwB,EAAE,MAAM,0BAA0B,CAAA;AAaxE,wBAAgB,mBAAmB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7D,KAAK,EAAE,wBAAwB,CAAC,CAAC,CAAC,GACjC,KAAK,CAAC,YAAY,CA8SpB;AAED,eAAe,mBAAmB,CAAA"}
+{"version":3,"file":"HeadlessSearchInput.d.ts","sourceRoot":"","sources":["../../src/components/HeadlessSearchInput.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAsC,MAAM,OAAO,CAAA;AAE1D,OAAO,EAAE,KAAK,wBAAwB,EAAE,MAAM,0BAA0B,CAAA;AAaxE,wBAAgB,mBAAmB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7D,KAAK,EAAE,wBAAwB,CAAC,CAAC,CAAC,GACjC,KAAK,CAAC,YAAY,CAgTpB;AAED,eAAe,mBAAmB,CAAA"}

package/dist/components/HeadlessSearchInput.js

@@ -6,7 +6,7 @@ import { useSearch } from '../utils/useSearch.js';
 import { RenderedHeader, RenderedNoResults, RenderedResult, RenderedResultError } from './render/index.js';
 import { useThemeConfig } from './themes/hooks.js';
 export function HeadlessSearchInput(props) {
-    const { baseUrl, className = '', collections, debounceMs = 300, enableSuggestions: _enableSuggestions = true, errorClassName = '', inputClassName = '', inputWrapperClassName = '', minQueryLength = 2, noResultsClassName = '', onResultClick, onResults, onSearch, perPage = 10, placeholder = 'Search...', renderDate = true, renderError, renderInput, renderNoResults, renderResult, renderResultsHeader, resultItemClassName = '', resultsClassName = '', resultsContainerClassName = '', resultsHeaderClassName = '', resultsListClassName = '', showLoading = true, showResultCount = true, theme = 'modern' } = props;
+    const { baseUrl, className = '', collections, debounceMs = 300, enableSuggestions: _enableSuggestions = true, errorClassName = '', inputClassName = '', inputWrapperClassName = '', minQueryLength = 2, noResultsClassName = '', onResultClick, onResults, onSearch, perPage = 10, placeholder = 'Search...', renderDate = true, renderError, renderInput, renderNoResults, renderResult, renderResultsHeader, resultItemClassName = '', resultsClassName = '', resultsContainerClassName = '', resultsHeaderClassName = '', resultsListClassName = '', showLoading = true, showResultCount = true, theme = 'modern', vector = false } = props;
     const [query, setQuery] = useState('');
     const [isOpen, setIsOpen] = useState(false);
     const inputRef = useRef(null);
@@ -22,7 +22,8 @@ export function HeadlessSearchInput(props) {
         minQueryLength,
         onResults,
         onSearch,
-        perPage
+        perPage,
+        vector
     });
     useEffect(()=>{
         if (debouncedQuery.length >= minQueryLength) {
@@ -178,7 +179,7 @@ export function HeadlessSearchInput(props) {
         errorClassName: errorClassName,
         themeConfig: themeConfig
     })), !error && results && /*#__PURE__*/ React.createElement(React.Fragment, null, showResultCount && (renderResultsHeader ? renderResultsHeader(results.found) : /*#__PURE__*/ React.createElement(RenderedHeader, {
-        found: results.hits.length,
+        found: results.found,
         resultsHeaderClassName: resultsHeaderClassName,
         themeConfig: themeConfig
     })), results.hits.length > 0 ? /*#__PURE__*/ React.createElement("div", {

package/dist/components/index.d.ts

@@ -1,6 +1,7 @@
 export { type HeadlessSearchInputProps } from '../lib/headlessSearch.js';
 export { type BaseSearchInputProps, type HealthCheckResponse, type SearchResponse, type SearchResult, type SearchResultProps, type TypesenseSearchConfig, } from '../types.js';
 export { default as HeadlessSearchInput } from './HeadlessSearchInput.js';
+export { RenderedHeader, RenderedNoResults, RenderedResult, RenderedResultError, } from './render/index.js';
 export { ThemeProvider } from './ThemeProvider.js';
 export * from './themes/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,wBAAwB,EAAE,MAAM,0BAA0B,CAAA;AACxE,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,GAC3B,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD,cAAc,mBAAmB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,wBAAwB,EAAE,MAAM,0BAA0B,CAAA;AACxE,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,GAC3B,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AACzE,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,mBAAmB,GACpB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,cAAc,mBAAmB,CAAA"}

package/dist/components/index.js

@@ -1,3 +1,4 @@
 export { default as HeadlessSearchInput } from './HeadlessSearchInput.js';
+export { RenderedHeader, RenderedNoResults, RenderedResult, RenderedResultError } from './render/index.js';
 export { ThemeProvider } from './ThemeProvider.js';
 export * from './themes/index.js';

package/dist/components/render/Header.d.ts

@@ -1,9 +1,10 @@
+import React from 'react';
 import { type ThemeContextValue } from '../themes/types.js';
 interface RenderedHeaderProps {
     found: number;
     resultsHeaderClassName?: string;
     themeConfig: ThemeContextValue;
 }
-export declare const RenderedHeader: ({ found, resultsHeaderClassName, themeConfig, }: RenderedHeaderProps) => import("react").JSX.Element;
+export declare const RenderedHeader: ({ found, resultsHeaderClassName, themeConfig, }: RenderedHeaderProps) => React.JSX.Element;
 export {};
 //# sourceMappingURL=Header.d.ts.map

package/dist/components/render/Header.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Header.d.ts","sourceRoot":"","sources":["../../../src/components/render/Header.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAE3D,UAAU,mBAAmB;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B,WAAW,EAAE,iBAAiB,CAAA;CAC/B;AAED,eAAO,MAAM,cAAc,GAAI,iDAI5B,mBAAmB,gCAuCrB,CAAA"}
+{"version":3,"file":"Header.d.ts","sourceRoot":"","sources":["../../../src/components/render/Header.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAE3D,UAAU,mBAAmB;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B,WAAW,EAAE,iBAAiB,CAAA;CAC/B;AAED,eAAO,MAAM,cAAc,GAAI,iDAI5B,mBAAmB,sBAuCrB,CAAA"}

package/dist/components/render/Header.js

@@ -1,3 +1,4 @@
+import React from 'react';
 export const RenderedHeader = ({ found, resultsHeaderClassName = '', themeConfig })=>/*#__PURE__*/ React.createElement("div", {
         className: resultsHeaderClassName,
         style: {

package/dist/components/render/NoResults.d.ts

@@ -1,9 +1,10 @@
+import React from 'react';
 import { type ThemeContextValue } from '../themes/types.js';
 interface RenderedNoResultsProps {
     noResultsClassName?: string;
     query: string;
     themeConfig: ThemeContextValue;
 }
-export declare const RenderedNoResults: ({ noResultsClassName, query: _query, themeConfig, }: RenderedNoResultsProps) => import("react").JSX.Element;
+export declare const RenderedNoResults: ({ noResultsClassName, query: _query, themeConfig, }: RenderedNoResultsProps) => React.JSX.Element;
 export {};
 //# sourceMappingURL=NoResults.d.ts.map

package/dist/components/render/NoResults.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NoResults.d.ts","sourceRoot":"","sources":["../../../src/components/render/NoResults.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAE3D,UAAU,sBAAsB;IAC9B,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,iBAAiB,CAAA;CAC/B;AAED,eAAO,MAAM,iBAAiB,GAAI,qDAI/B,sBAAsB,gCAoDxB,CAAA"}
+{"version":3,"file":"NoResults.d.ts","sourceRoot":"","sources":["../../../src/components/render/NoResults.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAE3D,UAAU,sBAAsB;IAC9B,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,iBAAiB,CAAA;CAC/B;AAED,eAAO,MAAM,iBAAiB,GAAI,qDAI/B,sBAAsB,sBAoDxB,CAAA"}

package/dist/components/render/NoResults.js

@@ -1,3 +1,4 @@
+import React from 'react';
 export const RenderedNoResults = ({ noResultsClassName = '', query: _query, themeConfig })=>/*#__PURE__*/ React.createElement("div", {
         className: noResultsClassName,
         style: {

package/dist/components/render/ResultError.d.ts

@@ -1,9 +1,10 @@
+import React from 'react';
 import { type ThemeContextValue } from '../themes/types.js';
 interface RenderedResultErrorProps {
     error: string;
     errorClassName?: string;
     themeConfig: ThemeContextValue;
 }
-export declare const RenderedResultError: ({ error, errorClassName, themeConfig, }: RenderedResultErrorProps) => import("react").JSX.Element;
+export declare const RenderedResultError: ({ error, errorClassName, themeConfig, }: RenderedResultErrorProps) => React.JSX.Element;
 export {};
 //# sourceMappingURL=ResultError.d.ts.map

package/dist/components/render/ResultError.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ResultError.d.ts","sourceRoot":"","sources":["../../../src/components/render/ResultError.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAE3D,UAAU,wBAAwB;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,WAAW,EAAE,iBAAiB,CAAA;CAC/B;AAED,eAAO,MAAM,mBAAmB,GAAI,yCAIjC,wBAAwB,gCA+C1B,CAAA"}
+{"version":3,"file":"ResultError.d.ts","sourceRoot":"","sources":["../../../src/components/render/ResultError.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAE3D,UAAU,wBAAwB;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,WAAW,EAAE,iBAAiB,CAAA;CAC/B;AAED,eAAO,MAAM,mBAAmB,GAAI,yCAIjC,wBAAwB,sBA+C1B,CAAA"}

package/dist/components/render/ResultError.js

@@ -1,3 +1,4 @@
+import React from 'react';
 export const RenderedResultError = ({ error, errorClassName = '', themeConfig })=>/*#__PURE__*/ React.createElement("div", {
         className: errorClassName,
         style: {

package/dist/components/render/Results.d.ts

@@ -1,3 +1,4 @@
+import React from 'react';
 import { type SearchResult } from '../../types.js';
 import { type ThemeContextValue } from '../themes/types.js';
 interface RenderedResultProps {
@@ -9,6 +10,6 @@ interface RenderedResultProps {
     resultsContainerClassName?: string;
     themeConfig: ThemeContextValue;
 }
-export declare function RenderedResult({ index, onResultClick, renderDate, result, resultItemClassName, resultsContainerClassName, themeConfig, }: RenderedResultProps): import("react").JSX.Element;
+export declare function RenderedResult({ index, onResultClick, renderDate, result, resultItemClassName, resultsContainerClassName, themeConfig, }: RenderedResultProps): React.JSX.Element;
 export {};
 //# sourceMappingURL=Results.d.ts.map

package/dist/components/render/Results.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Results.d.ts","sourceRoot":"","sources":["../../../src/components/render/Results.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAClD,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAE3D,UAAU,mBAAmB;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,aAAa,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAA;IAC7C,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,MAAM,EAAE,YAAY,CAAA;IACpB,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,yBAAyB,CAAC,EAAE,MAAM,CAAA;IAClC,WAAW,EAAE,iBAAiB,CAAA;CAC/B;AAED,wBAAgB,cAAc,CAAC,EAC7B,KAAK,EACL,aAAa,EACb,UAAiB,EACjB,MAAM,EACN,mBAAwB,EACxB,yBAA8B,EAC9B,WAAW,GACZ,EAAE,mBAAmB,+BA4JrB"}
+{"version":3,"file":"Results.d.ts","sourceRoot":"","sources":["../../../src/components/render/Results.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAClD,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAE3D,UAAU,mBAAmB;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,aAAa,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAA;IAC7C,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,MAAM,EAAE,YAAY,CAAA;IACpB,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,yBAAyB,CAAC,EAAE,MAAM,CAAA;IAClC,WAAW,EAAE,iBAAiB,CAAA;CAC/B;AAED,wBAAgB,cAAc,CAAC,EAC7B,KAAK,EACL,aAAa,EACb,UAAiB,EACjB,MAAM,EACN,mBAAwB,EACxB,yBAA8B,EAC9B,WAAW,GACZ,EAAE,mBAAmB,qBAmKrB"}

package/dist/components/render/Results.js

@@ -1,3 +1,4 @@
+import React from 'react';
 export function RenderedResult({ index, onResultClick, renderDate = true, result, resultItemClassName = '', resultsContainerClassName = '', themeConfig }) {
     return /*#__PURE__*/ React.createElement("div", {
         className: resultsContainerClassName,
@@ -5,7 +6,6 @@ export function RenderedResult({ index, onResultClick, renderDate = true, result
             backgroundColor: themeConfig.theme.colors.resultBackground,
             borderBottom: `1px solid ${themeConfig.theme.colors.resultBorder}`,
             cursor: 'pointer',
-            padding: themeConfig.theme.spacing.itemPadding,
             transition: themeConfig.config.enableAnimations !== false ? `all ${themeConfig.theme.animations.transitionFast} ${themeConfig.theme.animations.easeInOut}` : 'none'
         }
     }, /*#__PURE__*/ React.createElement("div", {
@@ -38,6 +38,7 @@ export function RenderedResult({ index, onResultClick, renderDate = true, result
             alignItems: 'flex-start',
             display: 'flex',
             gap: '12px',
+            overflow: 'hidden',
             padding: '6px'
         }
     }, /*#__PURE__*/ React.createElement("div", {
@@ -51,7 +52,7 @@ export function RenderedResult({ index, onResultClick, renderDate = true, result
             borderRadius: themeConfig.theme.spacing.inputBorderRadius,
             color: themeConfig.theme.colors.collectionBadgeText,
             display: 'flex',
-            fontSize: '14px',
+            fontSize: themeConfig.theme.typography.fontSizeBase,
             fontWeight: themeConfig.theme.typography.fontWeightMedium,
             height: '32px',
             justifyContent: 'center',

package/dist/components/themes/utils.js

@@ -123,7 +123,7 @@ export function generateThemeClasses(theme, config = {}) {
         padding: theme.spacing.headerPadding
     });
     const resultsListStyles = css({
-        padding: '4px'
+        padding: '2px'
     });
     const resultItemStyles = css({
         ':focus': {

package/dist/endpoints/handler/createSearch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createSearch.d.ts","sourceRoot":"","sources":["../../../src/endpoints/handler/createSearch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,WAAW,CAAA;AAEtC,OAAO,EAAE,KAAK,cAAc,EAAuB,MAAM,SAAS,CAAA;AAIlE,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAGrD,eAAO,MAAM,YAAY,GACvB,iBAAiB,SAAS,CAAC,MAAM,EACjC,eAAe,eAAe,KAC7B,cAoGF,CAAA"}
+{"version":3,"file":"createSearch.d.ts","sourceRoot":"","sources":["../../../src/endpoints/handler/createSearch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,WAAW,CAAA;AAEtC,OAAO,EAAE,KAAK,cAAc,EAAuB,MAAM,SAAS,CAAA;AAIlE,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAIrD,eAAO,MAAM,YAAY,GACvB,iBAAiB,SAAS,CAAC,MAAM,EACjC,eAAe,eAAe,KAC7B,cAmIF,CAAA"}

package/dist/endpoints/handler/createSearch.js

@@ -1,6 +1,7 @@
 import { searchCache } from '../../lib/cache.js';
 import { getValidationErrors, validateSearchParams } from '../../lib/validation.js';
 import { getAllCollections } from '../../utils/getAllCollections.js';
+import { performVectorSearch } from '../../utils/vectorSearch.js';
 export const createSearch = (typesenseClient, pluginOptions)=>{
     return async (request)=>{
         try {
@@ -19,7 +20,10 @@ export const createSearch = (typesenseClient, pluginOptions)=>{
             const q = url.searchParams.get('q') || '';
             const page = Number(url.searchParams.get('page') || 1);
             const per_page = Number(url.searchParams.get('per_page') || 10);
-            const sort_by = url.searchParams.get('sort_by') || undefined;
+            const collectionsParam = url.searchParams.get('collections');
+            const collections = collectionsParam ? collectionsParam.split(',').filter(Boolean) : undefined;
+            const vector = url.searchParams.get('vector') === 'true';
+            const sort_by = url.searchParams.has('sort_by') ? url.searchParams.get('sort_by') || '' : undefined;
             if (isNaN(page) || page < 1) {
                 return Response.json({
                     error: 'Invalid page parameter'
@@ -58,10 +62,12 @@ export const createSearch = (typesenseClient, pluginOptions)=>{
                     });
                 }
                 return getAllCollections(typesenseClient, pluginOptions, q, {
+                    collections,
                     filters: {},
                     page,
                     per_page,
-                    sort_by
+                    sort_by,
+                    vector
                 });
             }
             if (!pluginOptions.collections?.[collection]?.enabled) {
@@ -78,6 +84,23 @@ export const createSearch = (typesenseClient, pluginOptions)=>{
                     status: 400
                 });
             }
+            if (vector) {
+                try {
+                    const results = await performVectorSearch(typesenseClient, q, {
+                        collection,
+                        page,
+                        per_page
+                    });
+                    return Response.json(results);
+                } catch (vectorError) {
+                    return Response.json({
+                        details: vectorError instanceof Error ? vectorError.message : 'Unknown vector search error',
+                        error: 'Vector search failed'
+                    }, {
+                        status: 500
+                    });
+                }
+            }
             const fields = pluginOptions.collections?.[collection]?.searchFields?.join(',') || 'title,content';
             const searchParams = {
                 highlight_full_fields: fields,
@@ -92,20 +115,19 @@ export const createSearch = (typesenseClient, pluginOptions)=>{
                     sort_by
                 } : {}
             };
-            const cached = searchCache.get(q, collection, {
+            const cacheKey = {
+                fields,
                 page,
                 per_page,
-                sort_by
-            });
+                sort_by,
+                vector
+            };
+            const cached = searchCache.get(q, collection, cacheKey);
             if (cached) {
                 return Response.json(cached);
             }
             const results = await typesenseClient.collections(collection).documents().search(searchParams);
-            searchCache.set(q, results, collection, {
-                page,
-                per_page,
-                sort_by
-            });
+            searchCache.set(q, results, collection, cacheKey);
             return Response.json(results);
         } catch (error) {
             return Response.json({

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,SAAS,CAAA;AAMrC,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD,cAAc,uBAAuB,CAAA;AACrC,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD,eAAO,MAAM,eAAe,GACzB,eAAe,eAAe,MAC9B,QAAQ,MAAM,KAAG,MAiDjB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,SAAS,CAAA;AAMrC,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD,cAAc,uBAAuB,CAAA;AACrC,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD,eAAO,MAAM,eAAe,GACzB,eAAe,eAAe,MAC9B,QAAQ,MAAM,KAAG,MA6CjB,CAAA"}

package/dist/index.js

@@ -4,9 +4,7 @@ import { deleteDocumentFromTypesense, syncDocumentToTypesense } from './lib/hook
 import { initializeTypesense } from './lib/initialization.js';
 export * from './components/index.js';
 export const typesenseSearch = (pluginOptions)=>(config)=>{
-        if (pluginOptions.disabled) {
-            return config;
-        }
+        if (pluginOptions.disabled) return config;
         const client = createClient(pluginOptions.typesense);
         config.endpoints = [
             ...config.endpoints || [],
@@ -17,9 +15,7 @@ export const typesenseSearch = (pluginOptions)=>(config)=>{
         if (shouldAutoSync && hasCollections) {
             config.collections = (config.collections || []).map((collection)=>{
                 const colConfig = pluginOptions.collections?.[collection.slug];
-                if (!colConfig?.enabled) {
-                    return collection;
-                }
+                if (!colConfig?.enabled) return collection;
                 return {
                     ...collection,
                     hooks: {

package/dist/lib/cache.d.ts

@@ -3,13 +3,19 @@ export declare class SearchCache<T = unknown> {
     private cache;
     private readonly defaultTTL;
     private readonly maxSize;
+    private stats;
     constructor(options?: CacheOptions);
+    private evict;
     private generateKey;
+    private isExpired;
+    private lookup;
+    private normalize;
+    private serialize;
     cleanup(): void;
-    clear(pattern?: string): void;
+    clear(pattern?: RegExp | string): void;
     get(query: string, collection?: string, params?: Record<string, unknown>): null | T;
     getStats(): {
-        hitRate?: number;
+        hitRate: number;
         maxSize: number;
         size: number;
     };

package/dist/lib/cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/lib/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,aAAa,CAAA;AAEhE,qBAAa,WAAW,CAAC,CAAC,GAAG,OAAO;IAClC,OAAO,CAAC,KAAK,CAAmC;IAChD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;gBAEpB,OAAO,GAAE,YAAiB;IAKtC,OAAO,CAAC,WAAW;IAmBnB,OAAO,IAAI,IAAI;IASf,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAY7B,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC;IAgBnF,QAAQ,IAAI;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;IAO/D,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;IAIlF,GAAG,CACD,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,CAAC,EACP,UAAU,CAAC,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,GAAG,CAAC,EAAE,MAAM,GACX,IAAI;CAgBR;AAED,eAAO,MAAM,WAAW,sBAGtB,CAAA"}
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/lib/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,YAAY,EAAmB,MAAM,aAAa,CAAA;AAEjF,qBAAa,WAAW,CAAC,CAAC,GAAG,OAAO;IAClC,OAAO,CAAC,KAAK,CAAmC;IAChD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,KAAK,CAAqC;gBAEtC,OAAO,GAAE,YAAiB;IAKtC,OAAO,CAAC,KAAK;IAWb,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,MAAM;IAsBd,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,SAAS;IAWjB,OAAO,IAAI,IAAI;IAQf,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAkBtC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC;IAYnF,QAAQ,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;IAS9D,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;IAelF,GAAG,CACD,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,CAAC,EACP,UAAU,CAAC,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,GAAG,CAAC,EAAE,MAAM,GACX,IAAI;CAWR;AAED,eAAO,MAAM,WAAW,sBAGtB,CAAA"}

package/dist/lib/cache.js

@@ -2,22 +2,54 @@ export class SearchCache {
     cache = new Map();
     defaultTTL;
     maxSize;
+    stats = {
+        hits: 0,
+        misses: 0
+    };
     constructor(options = {}){
-        this.defaultTTL = options.ttl || 5 * 60 * 1000;
-        this.maxSize = options.maxSize || 1000;
+        this.defaultTTL = options.ttl ?? 5 * 60 * 1000;
+        this.maxSize = options.maxSize ?? 1000;
+    }
+    evict() {
+        this.cleanup();
+        if (this.cache.size < this.maxSize) return;
+        const oldestKey = this.cache.keys().next().value;
+        if (oldestKey) {
+            this.cache.delete(oldestKey);
+        }
     }
     generateKey(query, collection, params) {
-        const baseKey = `${collection || 'universal'}:${query}`;
-        if (params) {
-            const sortedParams = Object.keys(params).sort().map((key)=>`${key}=${String(params[key])}`).join('&');
-            return `${baseKey}:${sortedParams}`;
+        const base = `${this.normalize(collection)}:${query}`;
+        const serializedParams = this.serialize(params);
+        return serializedParams ? `${base}:${serializedParams}` : base;
+    }
+    isExpired(entry) {
+        return Date.now() - entry.timestamp > entry.ttl;
+    }
+    lookup(query, collection, params) {
+        const key = this.generateKey(query, collection, params);
+        const entry = this.cache.get(key);
+        if (!entry || this.isExpired(entry)) {
+            if (entry) {
+                this.cache.delete(key);
+            }
+            return null;
         }
-        return baseKey;
+        this.cache.delete(key);
+        this.cache.set(key, entry);
+        return entry;
+    }
+    normalize(collection) {
+        return collection ?? 'universal';
+    }
+    serialize(params) {
+        if (!params || Object.keys(params).length === 0) return '';
+        const sorted = Object.keys(params).sort().map((key)=>`${key}=${JSON.stringify(params[key])}`).join('&');
+        return sorted;
     }
     cleanup() {
-        const now = Date.now();
         for (const [key, entry] of this.cache.entries()){
-            if (now - entry.timestamp > entry.ttl) {
+            if (this.isExpired(entry)) {
                 this.cache.delete(key);
             }
         }
@@ -27,45 +59,48 @@ export class SearchCache {
             this.cache.clear();
             return;
         }
+        const matcher = typeof pattern === 'string' ? (key)=>key.includes(pattern) : (key)=>pattern.test(key);
         for (const key of this.cache.keys()){
-            if (key.includes(pattern)) {
+            if (matcher(key)) {
                 this.cache.delete(key);
             }
         }
     }
     get(query, collection, params) {
-        const key = this.generateKey(query, collection, params);
-        const entry = this.cache.get(key);
+        const entry = this.lookup(query, collection, params);
         if (!entry) {
+            this.stats.misses++;
             return null;
         }
-        if (Date.now() - entry.timestamp > entry.ttl) {
-            this.cache.delete(key);
-            return null;
-        }
+        this.stats.hits++;
         return entry.data;
     }
     getStats() {
+        const total = this.stats.hits + this.stats.misses;
         return {
+            hitRate: total === 0 ? 0 : this.stats.hits / total,
             maxSize: this.maxSize,
             size: this.cache.size
         };
     }
     has(query, collection, params) {
-        return this.get(query, collection, params) !== null;
-    }
-    set(query, data, collection, params, ttl) {
-        const key = this.generateKey(query, collection || '', params);
-        if (this.cache.size >= this.maxSize) {
-            const oldestKey = this.cache.keys().next().value;
-            if (oldestKey) {
-                this.cache.delete(oldestKey);
+        const key = this.generateKey(query, collection, params);
+        const entry = this.cache.get(key);
+        if (!entry || this.isExpired(entry)) {
+            if (entry) {
+                this.cache.delete(key);
             }
+            return false;
         }
+        return true;
+    }
+    set(query, data, collection, params, ttl) {
+        const key = this.generateKey(query, collection, params);
+        this.evict();
         this.cache.set(key, {
             data,
             timestamp: Date.now(),
-            ttl: ttl || this.defaultTTL
+            ttl: ttl ?? this.defaultTTL
         });
     }
 }
@@ -73,6 +108,3 @@ export const searchCache = new SearchCache({
     maxSize: 1000,
     ttl: 5 * 60 * 1000
 });
-setInterval(()=>{
-    searchCache.cleanup();
-}, 10 * 60 * 1000);

package/dist/lib/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/lib/client.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,WAAW,CAAA;AAEjC,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAA;AAiDlD,eAAO,MAAM,YAAY,GAAI,iBAAiB,eAAe,CAAC,WAAW,CAAC,KAAG,SAAS,CAAC,MAoBtF,CAAA"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/lib/client.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,WAAW,CAAA;AAEjC,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAA;AA4ClD,eAAO,MAAM,YAAY,GAAI,iBAAiB,eAAe,CAAC,WAAW,CAAC,KAAG,SAAS,CAAC,MAkBtF,CAAA"}