Medusa ПлагиныMeilisearch

Meilisearch

🔍 Powerful, lightning-fast search integration for MedusaJS using Meilisearch

Нужна доработка этого плагина?

Связаться с нами

npm install @vymalo/medusa-meilisearch

Категория

Создано

Community

Версия

1.0.17

Последнее обновление

7 месяцев назад

Звезды на Github

NPM Github

Medusa ПлагиныMeilisearch

MedusaJS Meilisearch Integration

🔍 Powerful, lightning-fast search integration for MedusaJS using Meilisearch

🌟 Features

Instant, typo-tolerant search capabilities
Highly configurable indexing
Real-time search updates
Advanced filtering and ranking
Seamless MedusaJS integration

🏗️ Search Architecture


graph TD
    A[MedusaJS Database] -->|Indexing| B[Meilisearch]
    B -->|Instant Search| C[Client Application]
    
    subgraph Search Configuration
    Config[Meilisearch Config]
    Indexes[Multiple Index Settings]
    Filters[Advanced Filtering]
    end

📦 Installation

Install the package using npm:


npm install @vymalo/medusa-meilisearch

Or using yarn:


yarn add @vymalo/medusa-meilisearch

🚀 Configuration Types

Core Configuration Interface


interface MeilisearchAddOnOptions {
    // Meilisearch client configuration
    config: Config;  // Meilisearch connection settings

    // Index-specific settings
    settings?: {
        [key: string]: SearchTypes.IndexSettings;
    };
}

Search Options


interface IndexSettings {
    // Provider-specific index configuration
    indexSettings: Record<string, unknown>;

    // Primary key for unique document identification
    primaryKey?: string;

    // Optional document transformer
    transformer?: (document: any) => any;
}

Configuration Breakdown

indexSettings: Allows provider-specific configuration
- e.g., ,
- Completely flexible key-value configuration
primaryKey:
- Ensures unique documents in the index
- Helps Meilisearch identify and manage documents
- Recommended for data integrity
transformer:
- Modify documents before indexing
- Allows data cleaning, restructuring
- Useful for complex data transformations

🚀 Usage Example


modules: [
    {
        resolve: '@vymalo/medusa-meilisearch',
        options: {
            // Meilisearch connection configuration
            config: {
                host: process.env.MEILISEARCH_HOST,
                apiKey: process.env.MEILISEARCH_API_KEY,
            },

            // Index-specific settings
            settings: {
                products: {
                    // Meilisearch-specific index settings
                    indexSettings: {
                        searchableAttributes: ['title', 'description'],
                        displayedAttributes: ['id', 'title', 'price'],
                        filterableAttributes: ['category', 'price']
                    },

                    // Specify primary key
                    primaryKey: 'id',

                    // Transform documents before indexing
                    transformer: (product) => ({
                        ...product,
                        // Add custom transformations
                        searchText: `${product.title} ${product.description}`,
                        // Normalize or clean data
                        price: Number(product.price).toFixed(2)
                    })
                }
            }
        },
    },
]