@meeovi/layer-search 1.1.6 → 1.1.7

package/README.md

@@ -1,5 +1,5 @@
 <!-- packages/search/README.md -->
-# @meeovi/search
+# @meeovi/layer-search
 
 A modular, provider-agnostic search layer for the Alternate Framework. It provides a unified, typed search API with pluggable adapters (Meilisearch, OpenSearch, mock adapters), lightweight bridges for UI integrations (InstantSearch / Searchkit), a small CLI for indexing/warmup, and event hooks.
 
@@ -16,13 +16,13 @@ A modular, provider-agnostic search layer for the Alternate Framework. It provid
 Using npm:
 
 ```bash
-npm install @meeovi/search
+npm install @meeovi/layer-search
 ```
 
 Using pnpm:
 
 ```bash
-pnpm add @meeovi/search
+pnpm add @meeovi/layer-search
 ```
 
 ## Quick Usage
@@ -31,14 +31,14 @@ Register the module with an Alternate app:
 
 ```ts
 import { createAlternateApp } from '@meeovi/core'
-import searchModule from '@meeovi/search'
+import searchModule from '@meeovi/layer-search'
 
 const app = createAlternateApp({
   config: {
     search: {
-      defaultProvider: 'meilisearch',
+      defaultProvider: 'opensearch',
       providers: {
-        meilisearch: {
+        opensearch: {
           host: 'http://localhost:7700',
           index: 'products',
           apiKey: 'masterKey'
@@ -62,14 +62,14 @@ if (searchAdapter) {
 ## Adapters
 
 Adapters are intentionally provider-agnostic and may be supplied by external packages or by your application.
-The core `@meeovi/search` layer does not bundle provider implementations; instead provide an adapter instance at startup
+The core `@meeovi/layer-search` layer does not bundle provider implementations; instead provide an adapter instance at startup
 or register one at runtime so the search manager can be created.
 
 Example (external adapter package or custom implementation):
 
 ```ts
 // import from an external adapter package or your own implementation
-import { createMySearchAdapter } from 'my-search-adapter-package'
+import { createMySearchAdapter } from 'my-search-adapter-package' /* @meeovi/adapter-opensearch */
 
 const adapter = createMySearchAdapter({ /* provider config */ })
 ```
@@ -105,7 +105,7 @@ This layer includes bridges that let UI code use Algolia InstantSearch or Search
 Example (client):
 
 ```ts
-import { createInstantSearchBridge } from '@meeovi/search'
+import { createInstantSearchBridge } from '@meeovi/layer-search'
 // `manager` is the `SearchManager` instance available on the app context
 const bridge = createInstantSearchBridge(manager)
 
@@ -120,7 +120,7 @@ Example (server - Express):
 
 ```ts
 import express from 'express'
-import { createSearchkitGraphQLHandler } from '@meeovi/search'
+import { createSearchkitGraphQLHandler } from '@meeovi/layer-search'
 
 const app = express()
 app.use(express.json())
@@ -151,8 +151,8 @@ There are two common ways to register a search adapter so the search layer can u
 
 ```ts
 import { createAlternateApp } from '@meeovi/core'
-import searchModule from '@meeovi/search'
-import { createMySearchAdapter } from 'my-search-adapter-package'
+import searchModule from '@meeovi/layer-search'
+import { createMySearchAdapter } from 'my-search-adapter-package' /* @meeovi/adapter-opensearch */
 
 const myProviderModule = {
   id: 'search-provider-my',
@@ -173,8 +173,8 @@ await app.start()
 
 ```ts
 import { createAlternateApp } from '@meeovi/core'
-import searchModule from '@meeovi/search'
-import { createMySearchAdapter } from 'my-search-adapter-package'
+import searchModule from '@meeovi/layer-search'
+import { createMySearchAdapter } from 'my-search-adapter-package' /* @meeovi/adapter-opensearch */
 
 const app = createAlternateApp({ modules: [searchModule] })
 
@@ -199,7 +199,7 @@ Included CLI commands:
 
 Environment variables supported (example for Meilisearch):
 
-- `SEARCH_PROVIDER=meilisearch`
+- `SEARCH_PROVIDER=opensearch`
 - `MEILI_HOST=http://localhost:7700`
 - `MEILI_INDEX=products`
 - `MEILI_KEY=masterKey`
@@ -238,7 +238,7 @@ Because every layer follows this `KEY` / `NUXT_PUBLIC_KEY` pattern, you can plac
 Use the mock adapter in tests to avoid external dependencies:
 
 ```ts
-import { createMockSearchAdapter } from '@meeovi/search'
+import { createMockSearchAdapter } from '@meeovi/layer-search'
 
 const mock = createMockSearchAdapter([{ id: '1', title: 'Test Product' }])
 const results = await mock.search({ term: 'test' })
@@ -249,13 +249,11 @@ const results = await mock.search({ term: 'test' })
 Typical layout:
 
 ```
-@meeovi/search
+@meeovi/layer-search
 ├─ src/
 │  ├─ index.ts
 │  ├─ module.ts
 │  ├─ adapter/
-│  │  ├─ opensearch.ts
-│  │  ├─ meilisearch.ts
 │  │  ├─ mock.ts
 │  │  └─ types.ts
 │  ├─ config/schema.ts

package/app/composables/bridges/instantsearch.ts

@@ -3,7 +3,7 @@ import type { MeeoviSearchItem } from '../adapter/types'
 
 export function createInstantSearchBridge(manager: SearchManager) {
   return {
-    searchFunction(helper: any) {
+    async searchFunction(helper: any) {
       manager.context.setQuery(helper.state.query || '')
       manager.context.setPage(helper.state.page || 1)
       // map filters if needed from helper.state

package/app/composables/bridges/searchkit-server.ts

@@ -1,6 +1,5 @@
 import { graphql, buildSchema } from 'graphql'
 import type { SearchManager } from '../core/SearchManager'
-import type { MeeoviSearchItem } from '../adapter/types'
 
 const schema = buildSchema(`
   type Hit { id: ID, title: String, description: String, price: Float }

package/app/composables/bridges/searchkit.ts

@@ -1,5 +1,4 @@
 import type { SearchManager } from '../core/SearchManager'
-import type { MeeoviSearchItem } from '../adapter/types'
 import type { BuiltSearchQuery } from '../core/QueryBuilder'
 
 type InstantSearchRequest = {

package/app/composables/bridges/vue.ts

@@ -1,7 +1,6 @@
 import { ref, computed } from 'vue'
 import { useAlternateContext } from '@meeovi/core'
 import type { SearchManager } from '../core/SearchManager'
-import type { MeeoviSearchItem } from '../adapter/types'
 
 export function useSearch() {
   const ctx = useAlternateContext() as any

package/app/composables/module.ts

@@ -7,7 +7,6 @@ import {
 import { validateSearchConfig, type SearchModuleConfig } from './config/schema'
 import type { SearchAdapter } from '@meeovi/core'
 import { SearchManager } from './core/SearchManager'
-import type { MeeoviSearchItem } from './adapter/types'
 
 declare module '@meeovi/core' {
   interface AlternateConfig {

package/app/utils/search/client.ts

@@ -1,6 +1,6 @@
 // Lightweight helper to obtain a search client and index name for InstantSearch
-// This is intentionally minimal — it throws when no configuration is present
-// so the caller can fall back gracefully.
+// This version NEVER throws — it returns null when search is not configured.
+
 import type { SearchClient } from 'instantsearch.js'
 import { getEnv } from '../env'
 
@@ -16,40 +16,38 @@ function buildHostFromParts(): string | null {
   const explicit = getEnv('SEARCHKIT_HOST')
   if (explicit) return explicit
 
-  // Allow composing host from protocol/hostname/port path
   const protocol = (getEnv('SEARCHKIT_PROTOCOL') || 'http').replace(/:\/\//, '')
   const hostname = getEnv('SEARCHKIT_HOSTNAME')
   const port = getEnv('SEARCHKIT_PORT')
+
   if (!hostname) return null
+
   return `${protocol}://${hostname}${port ? `:${port}` : ''}`
 }
 
-export function getSearchClient(): SearchClient {
+export function getSearchClient(): SearchClient | null {
   const host = buildHostFromParts()
   if (!host) {
-    throw new Error('Searchkit host not configured via SEARCHKIT_HOST, SEARCHKIT_HOSTNAME, or NUXT_PUBLIC_SEARCHKIT_HOST')
+    console.warn('[search] Searchkit host not configured — search disabled')
+    return null
   }
 
-  // Optionally pass an API key if configured
-  const apiKey = getEnv('SEARCHKIT_API_KEY')
-
-  // Defer importing heavy searchkit/instantsearch client until runtime.
-  // Consumers can replace this implementation with a provider-specific client.
-  // Here we attempt to use @searchkit/instantsearch-client if available.
-  // If not present, let the import fail so the plugin can fallback.
-  // eslint-disable-next-line @typescript-eslint/no-var-requires
-  const createClient = require('@searchkit/instantsearch-client')
-  if (!createClient) {
-    throw new Error('@searchkit/instantsearch-client is not installed')
+  let createClient: any
+  try {
+    createClient = require('@searchkit/instantsearch-client')
+  } catch {
+    console.warn('[search] @searchkit/instantsearch-client not installed — search disabled')
+    return null
   }
 
-  // Create a minimal client. The factory API may vary; adapt to your Searchkit config.
   try {
     const opts: any = { host }
+    const apiKey = getEnv('SEARCHKIT_API_KEY')
     if (apiKey) opts.apiKey = apiKey
+
     return createClient(opts)
   } catch (e: any) {
-    // rethrow with context
-    throw new Error('Failed to create Searchkit client: ' + (e?.message || e))
+    console.warn('[search] Failed to create Searchkit client:', e?.message || e)
+    return null
   }
-}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meeovi/layer-search",
-  "version": "1.1.6",
+  "version": "1.1.7",
   "description": "Powerful search module for the Alternate Framework.",
   "keywords": [
     "meeovi",