The complete open source platform to run your entire marketplace. Storefront, vendor panel, admin console, and integrations in one enterprise-grade platform you own.
TypeScript b2b-marketplacecomposable-commerceecommerceenterpriseheadless-commercemarketplacemedusamedusajsmulti-vendortypescript
feat(registry): add meilisearch search block for multi-vendor marketplace
kjedras2c36133de69b
diff --git a/bun.lock b/bun.lockindex 24eb9841d..b8c06c179 100644--- a/bun.lock+++ b/bun.lock@@ -26,6 +26,7 @@"@medusajs/medusa": "^2.13.4","@mercurjs/core-plugin": "*","jsonwebtoken": "^9.0.2",+ "meilisearch": "^0.47.0","scrypt-kdf": "^2.0.1",},"devDependencies": {@@ -319,6 +320,7 @@"@tanstack/react-table": "8.20.5","algoliasearch": "^5.40.0","jsonwebtoken": "9.0.2",+ "meilisearch": "^0.47.0","react-hook-form": "7.49.1","react-i18next": "13.5.0","react-jwt": "2.0.0",@@ -329,12 +331,16 @@"@medusajs/cli": "^2.13.4","@mercurjs/cli": "workspace:*","@mercurjs/types": "workspace:*",+ "@swc/core": "^1.7.28",+ "@swc/jest": "^0.2.36",+ "@types/jest": "^29.5.13","@types/jsonwebtoken": "^9.0.9","@types/multer": "^2.0.0","@types/node": "^22","@types/react": "^18.2.66","@types/react-dom": "^18.2.22","@types/unzipper": "^0.10.10",+ "jest": "^30.2.0",},},"packages/types": {@@ -2693,6 +2699,8 @@"media-typer": ["[email protected]", "", {}, "sha512-dq+qelQ9akHpcOl/gUVRTxVIOkAJ1wR3QAvb4RsVjS8oVoFjDGTc679wJYmUmknUF5HwMLOgb5O+a3KxfWapPQ=="],+ "meilisearch": ["[email protected]", "", {}, "sha512-Qq+hatuDJ0z5c+szVb0O/uI7Z2jfMUjj8eNB6xPyKp9Og7GVnrOZJRVoDPqGoVY484Iwh+F61y2UreIetda00w=="],+"merge-descriptors": ["[email protected]", "", {}, "sha512-gaNvAS7TZ897/rVaZ0nMtAyxNyi/pdbjbAwUpFQpN70GqnVfOiXpeUUMKRBmzXaSQ8DdTX4/0ms62r2K+hE6mQ=="],"merge-stream": ["[email protected]", "", {}, "sha512-abv/qOcuPfk3URPfDzmZU1LKmuw8kT+0nIHvKrKgFrwifol/doWcdA4ZqsWQ8ENrFKkd67Mfpo/LovbIUsbt3w=="],diff --git a/integration-tests/.env.meilisearch.test b/integration-tests/.env.meilisearch.testnew file mode 100644index 000000000..0b4fe5e47--- /dev/null+++ b/integration-tests/.env.meilisearch.test@@ -0,0 +1,2 @@+MEILISEARCH_HOST=http://localhost:7700+MEILISEARCH_API_KEY=masterKeydiff --git a/integration-tests/http/meilisearch/admin/meilisearch.spec.ts b/integration-tests/http/meilisearch/admin/meilisearch.spec.tsnew file mode 100644index 000000000..aa596d500--- /dev/null+++ b/integration-tests/http/meilisearch/admin/meilisearch.spec.ts@@ -0,0 +1,110 @@+/**+ * Integration tests for admin Meilisearch endpoints:+ * GET /admin/meilisearch — index status+ * POST /admin/meilisearch/sync — trigger full re-index+ *+ * Prerequisites (handled by test:integration:meilisearch script):+ * - MEILISEARCH_HOST env var must be set+ * - The meilisearch npm package is mocked below — no real Meilisearch instance needed+ */++import { medusaIntegrationTestRunner } from "@medusajs/test-utils"+import { MedusaContainer } from "@medusajs/framework/types"+import {+ adminHeaders,+ createAdminUser,+} from "../../../helpers/create-admin-user"+import { IndexType } from "../../../../packages/registry/src/meilisearch/modules/meilisearch/types"++jest.setTimeout(60000)++// ─── Mock meilisearch client ──────────────────────────────────────────────────++const mockGetStats = jest.fn().mockResolvedValue({ numberOfDocuments: 42 })+const mockIndexFn = jest.fn().mockReturnValue({+ search: jest.fn().mockResolvedValue({ hits: [], totalHits: 0 }),+ addDocuments: jest.fn().mockResolvedValue({}),+ deleteDocuments: jest.fn().mockResolvedValue({}),+ getStats: mockGetStats,+ updateSettings: jest.fn().mockResolvedValue({}),+})++jest.mock("meilisearch", () => ({+ MeiliSearch: jest.fn().mockImplementation(() => ({+ index: mockIndexFn,+ config: { host: "http://localhost:7700" },+ })),+}))++// ─── Test suite ───────────────────────────────────────────────────────────────++medusaIntegrationTestRunner({+ testSuite: ({ getContainer, api, dbConnection }) => {+ describe("Admin - Meilisearch", () => {+ let appContainer: MedusaContainer++ beforeAll(async () => {+ appContainer = getContainer()+ })++ beforeEach(async () => {+ jest.clearAllMocks()+ mockGetStats.mockResolvedValue({ numberOfDocuments: 42 })+ await createAdminUser(dbConnection, adminHeaders, appContainer)+ })++ describe("GET /admin/meilisearch", () => {+ it("returns 200 with host, index, documentCount, and isHealthy", async () => {+ const response = await api.get("/admin/meilisearch", adminHeaders)++ expect(response.status).toBe(200)+ expect(response.data).toMatchObject({+ host: expect.any(String),+ index: IndexType.PRODUCT,+ documentCount: 42,+ isHealthy: true,+ })+ })++ it("returns isHealthy:false when meilisearch is unreachable", async () => {+ mockGetStats.mockRejectedValueOnce(new Error("Connection refused"))++ const response = await api.get("/admin/meilisearch", adminHeaders)++ expect(response.status).toBe(200)+ expect(response.data.isHealthy).toBe(false)+ expect(response.data.documentCount).toBe(0)+ })++ it("requires admin authentication — returns 401 without token", async () => {+ const response = await api.get("/admin/meilisearch", {+ headers: {},+ })++ expect(response.status).toBe(401)+ })+ })++ describe("POST /admin/meilisearch", () => {+ it("returns 200 with sync in progress message", async () => {+ const response = await api.post(+ "/admin/meilisearch",+ {},+ adminHeaders+ )++ expect(response.status).toBe(200)+ expect(response.data).toMatchObject({ message: "Sync in progress" })+ })++ it("requires admin authentication — returns 401 without token", async () => {+ const response = await api.post("/admin/meilisearch", {}, {+ headers: {},+ })++ expect(response.status).toBe(401)+ })+ })+ })+ },+})diff --git a/integration-tests/http/meilisearch/store/meilisearch.spec.ts b/integration-tests/http/meilisearch/store/meilisearch.spec.tsnew file mode 100644index 000000000..dd8d01a7d--- /dev/null+++ b/integration-tests/http/meilisearch/store/meilisearch.spec.ts@@ -0,0 +1,297 @@+/**+ * Integration tests for POST /store/meilisearch/products/search+ *+ * Prerequisites (handled by test:integration:meilisearch script):+ * - MEILISEARCH_HOST env var must be set+ * - MEILISEARCH_API_KEY env var must be set+ * - The meilisearch npm package is mocked below — no real Meilisearch instance needed+ */++import { medusaIntegrationTestRunner } from "@medusajs/test-utils"+import { MedusaContainer } from "@medusajs/framework/types"+import {+ adminHeaders,+ createAdminUser,+ generatePublishableKey,+ generateStoreHeaders,+} from "../../../helpers/create-admin-user"+import { createSellerUser } from "../../../helpers/create-seller-user"++jest.setTimeout(60000)++// ─── Mock meilisearch client so no real network calls are made ────────────────++const mockSearchFn = jest.fn()+const mockIndexFn = jest.fn().mockReturnValue({+ search: mockSearchFn,+ addDocuments: jest.fn().mockResolvedValue({}),+ deleteDocuments: jest.fn().mockResolvedValue({}),+ getStats: jest.fn().mockResolvedValue({ numberOfDocuments: 0 }),+ updateSettings: jest.fn().mockResolvedValue({}),+})++jest.mock("meilisearch", () => ({+ MeiliSearch: jest.fn().mockImplementation(() => ({+ index: mockIndexFn,+ config: { host: "http://localhost:7700" },+ })),+}))++// ─── Test suite ───────────────────────────────────────────────────────────────++medusaIntegrationTestRunner({+ testSuite: ({ getContainer, api, dbConnection }) => {+ describe("Store - Meilisearch product search", () => {+ let appContainer: MedusaContainer+ let storeHeaders: ReturnType<typeof generateStoreHeaders>+ let sellerActive: any+ let sellerSuspended: any+ let productActiveId: string+ let productSuspendedId: string++ beforeAll(async () => {+ appContainer = getContainer()+ })++ beforeEach(async () => {+ jest.clearAllMocks()++ await createAdminUser(dbConnection, adminHeaders, appContainer)++ // Create two sellers+ const resultActive = await createSellerUser(appContainer, {+ email: "[email protected]",+ name: "Active Store",+ })+ sellerActive = resultActive.seller++ const resultSuspended = await createSellerUser(appContainer, {+ email: "[email protected]",+ name: "Suspended Store",+ })+ sellerSuspended = resultSuspended.seller++ // Approve both sellers+ await api.post(`/admin/sellers/${sellerActive.id}/approve`, {}, adminHeaders)+ await api.post(`/admin/sellers/${sellerSuspended.id}/approve`, {}, adminHeaders)++ // Create a product for each seller+ const productActiveRes = await api.post(+ `/vendor/products`,+ {+ title: "Active Seller Shoes",+ status: "published",+ options: [{ title: "Size", values: ["M"] }],+ variants: [+ {+ title: "M",+ options: { Size: "M" },+ prices: [{ currency_code: "usd", amount: 50 }],+ },+ ],+ },+ resultActive.headers+ )+ productActiveId = productActiveRes.data.product.id++ const productSuspendedRes = await api.post(+ `/vendor/products`,+ {+ title: "Suspended Seller Hat",+ status: "published",+ options: [{ title: "Size", values: ["M"] }],+ variants: [+ {+ title: "M",+ options: { Size: "M" },+ prices: [{ currency_code: "usd", amount: 30 }],+ },+ ],+ },+ resultSuspended.headers+ )+ productSuspendedId = productSuspendedRes.data.product.id++ // Suspend the second seller+ await api.post(`/admin/sellers/${sellerSuspended.id}/suspend`, {}, adminHeaders)++ // Generate store headers+ const publishableKey = await generatePublishableKey(appContainer)+ storeHeaders = generateStoreHeaders({ publishableKey })+ })++ describe("POST /store/meilisearch/products/search", () => {+ it("returns 200 with product list and metadata when meilisearch returns hits", async () => {+ // Meilisearch returns the active seller product ID+ mockSearchFn.mockResolvedValueOnce({+ hits: [{ id: productActiveId }],+ totalHits: 1,+ page: 1,+ totalPages: 1,+ hitsPerPage: 12,+ processingTimeMs: 5,+ query: "shoes",+ })++ const response = await api.post(+ `/store/meilisearch/products/search`,+ { query: "shoes" },+ storeHeaders+ )++ expect(response.status).toBe(200)+ expect(response.data.products).toHaveLength(1)+ expect(response.data.products[0].id).toBe(productActiveId)+ expect(response.data).toMatchObject({+ totalHits: 1,+ page: 1,+ query: expect.any(String),+ processingTimeMs: expect.any(Number),+ })+ })++ it("returns empty products array when meilisearch returns no hits", async () => {+ mockSearchFn.mockResolvedValueOnce({+ hits: [],+ totalHits: 0,+ page: 1,+ totalPages: 0,+ hitsPerPage: 12,+ processingTimeMs: 3,+ query: "xyz_notfound",+ })++ const response = await api.post(+ `/store/meilisearch/products/search`,+ { query: "xyz_notfound" },+ storeHeaders+ )++ expect(response.status).toBe(200)+ expect(response.data.products).toEqual([])+ expect(response.data.totalHits).toBe(0)+ })++ it("passes seller.status = 'active' filter to meilisearch (FR-003)", async () => {+ mockSearchFn.mockResolvedValueOnce({+ hits: [],+ totalHits: 0,+ page: 1,+ totalPages: 0,+ hitsPerPage: 12,+ processingTimeMs: 2,+ query: "",+ })++ await api.post(+ `/store/meilisearch/products/search`,+ { query: "" },+ storeHeaders+ )++ const searchOptions = mockSearchFn.mock.calls[0][1]+ expect(searchOptions.filter).toContain('seller.status = "active"')+ })++ it("includes category filter when provided", async () => {+ mockSearchFn.mockResolvedValueOnce({+ hits: [],+ totalHits: 0,+ page: 1,+ totalPages: 0,+ hitsPerPage: 12,+ processingTimeMs: 2,+ query: "",+ })++ await api.post(+ `/store/meilisearch/products/search`,+ { filters: { categories: ["cat_1"] } },+ storeHeaders+ )++ const filter = mockSearchFn.mock.calls[0][1].filter+ expect(filter).toContain("categories.id IN")+ expect(filter).toContain("cat_1")+ })++ it("includes price range filters when provided", async () => {+ mockSearchFn.mockResolvedValueOnce({+ hits: [],+ totalHits: 0,+ page: 1,+ totalPages: 0,+ hitsPerPage: 12,+ processingTimeMs: 2,+ query: "",+ })++ await api.post(+ `/store/meilisearch/products/search`,+ { filters: { price_min: 10, price_max: 100 } },+ storeHeaders+ )++ const filter = mockSearchFn.mock.calls[0][1].filter+ expect(filter).toContain("variants.prices.amount >= 10")+ expect(filter).toContain("variants.prices.amount <= 100")+ })++ it("returns 400 when request body is invalid", async () => {+ const response = await api.post(+ `/store/meilisearch/products/search`,+ { hitsPerPage: 9999 }, // exceeds max of 100+ storeHeaders+ )++ expect(response.status).toBe(400)+ })++ it("requires x-publishable-api-key header — returns 401 without it", async () => {+ mockSearchFn.mockResolvedValueOnce({+ hits: [],+ totalHits: 0,+ page: 1,+ totalPages: 0,+ hitsPerPage: 12,+ processingTimeMs: 2,+ query: "",+ })++ const response = await api.post(+ `/store/meilisearch/products/search`,+ { query: "test" },+ { headers: {} }+ )++ expect([400, 401]).toContain(response.status)+ })++ it("hydrates products from Medusa DB in meilisearch relevance order", async () => {+ // Simulate meilisearch returning prod_2 first (higher relevance)+ mockSearchFn.mockResolvedValueOnce({+ hits: [{ id: productActiveId }, { id: "some-other-id" }],+ totalHits: 2,+ page: 1,+ totalPages: 1,+ hitsPerPage: 12,+ processingTimeMs: 5,+ query: "shoe",+ })++ const response = await api.post(+ `/store/meilisearch/products/search`,+ { query: "shoe" },+ storeHeaders+ )++ // Only existing products are returned (the mock returns a non-existent ID too)+ expect(response.status).toBe(200)+ const ids = response.data.products.map((p: any) => p.id)+ // productActiveId should appear first (matches meilisearch hit order)+ expect(ids[0]).toBe(productActiveId)+ })+ })+ })+ },+})diff --git a/integration-tests/medusa-config.ts b/integration-tests/medusa-config.tsindex 8a86e1a7f..5f94141ea 100644--- a/integration-tests/medusa-config.ts+++ b/integration-tests/medusa-config.ts@@ -33,6 +33,14 @@ module.exports = defineConfig({disable: true}},+ // Meilisearch block — loaded only when env vars are present (e.g. meilisearch integration tests)+ ...(process.env.MEILISEARCH_HOST ? [{+ resolve: '../packages/registry/src/meilisearch/modules/meilisearch',+ options: {+ host: process.env.MEILISEARCH_HOST,+ apiKey: process.env.MEILISEARCH_API_KEY,+ },+ }] : []),],plugins: [{diff --git a/integration-tests/package.json b/integration-tests/package.jsonindex df0429ebb..31c4cc068 100644--- a/integration-tests/package.json+++ b/integration-tests/package.json@@ -3,7 +3,8 @@"version": "0.0.1","private": true,"scripts": {- "test:integration:http": "TEST_TYPE=integration:http NODE_OPTIONS=--experimental-vm-modules jest --silent=false --runInBand --forceExit"+ "test:integration:http": "TEST_TYPE=integration:http NODE_OPTIONS=--experimental-vm-modules jest --silent=false --runInBand --forceExit",+ "test:integration:meilisearch": "TEST_TYPE=integration:http MEILISEARCH_HOST=http://localhost:7700 MEILISEARCH_API_KEY=masterKey NODE_OPTIONS=--experimental-vm-modules jest --silent=false --runInBand --forceExit --testPathPattern=meilisearch"},"dependencies": {"@medusajs/framework": "^2.13.4",@@ -11,7 +12,8 @@"@mercurjs/core-plugin": "*","jsonwebtoken": "^9.0.2","scrypt-kdf": "^2.0.1",- "@medusajs/draft-order": "^2.13.4"+ "@medusajs/draft-order": "^2.13.4",+ "meilisearch": "^0.47.0"},"devDependencies": {"@medusajs/test-utils": "^2.13.4",@@ -23,4 +25,4 @@"typescript": "5.9.3","@medusajs/types": "2.13.4"}-}\ No newline at end of file+}diff --git a/integration-tests/src/api/admin/meilisearch/route.ts b/integration-tests/src/api/admin/meilisearch/route.tsnew file mode 100644index 000000000..13e17022c--- /dev/null+++ b/integration-tests/src/api/admin/meilisearch/route.ts@@ -0,0 +1 @@+export { GET, POST } from '../../../../../packages/registry/src/meilisearch/api/admin/meilisearch/route'diff --git a/integration-tests/src/api/middlewares.ts b/integration-tests/src/api/middlewares.tsnew file mode 100644index 000000000..1ec7c4a48--- /dev/null+++ b/integration-tests/src/api/middlewares.ts@@ -0,0 +1,6 @@+import { defineMiddlewares } from '@medusajs/medusa'+import { meilisearchStoreMiddlewares } from '../../../packages/registry/src/meilisearch/api/store/meilisearch/products/search/middlewares'++export default defineMiddlewares({+ routes: [...meilisearchStoreMiddlewares],+})diff --git a/integration-tests/src/api/store/meilisearch/products/search/route.ts b/integration-tests/src/api/store/meilisearch/products/search/route.tsnew file mode 100644index 000000000..11e476bee--- /dev/null+++ b/integration-tests/src/api/store/meilisearch/products/search/route.ts@@ -0,0 +1 @@+export { POST } from '../../../../../../../packages/registry/src/meilisearch/api/store/meilisearch/products/search/route'diff --git a/packages/registry/jest.config.cjs b/packages/registry/jest.config.cjsnew file mode 100644index 000000000..405b772f5--- /dev/null+++ b/packages/registry/jest.config.cjs@@ -0,0 +1,20 @@+module.exports = {+ transform: {+ "^.+\\.[jt]sx?$": [+ "@swc/jest",+ {+ jsc: {+ parser: { syntax: "typescript", decorators: true },+ target: "es2021",+ },+ },+ ],+ },+ testEnvironment: "node",+ moduleFileExtensions: ["js", "ts", "json"],+ testMatch: ["**/__tests__/**/*.unit.spec.[jt]s"],+ modulePathIgnorePatterns: ["dist/"],+ transformIgnorePatterns: [+ "node_modules/(?!(@medusajs)/)",+ ],+}diff --git a/packages/registry/package.json b/packages/registry/package.jsonindex b7141822d..0af394bbf 100644--- a/packages/registry/package.json+++ b/packages/registry/package.json@@ -7,7 +7,8 @@"build": "tsc","dev": "tsc --watch","build:registry": "bunx @mercurjs/cli@latest registry:build",- "codegen": "bunx @mercurjs/cli@latest registry:codegen"+ "codegen": "bunx @mercurjs/cli@latest registry:codegen",+ "test": "jest --config jest.config.cjs"},"dependencies": {"@medusajs/framework": "^2.13.4",@@ -30,6 +31,7 @@"jsonwebtoken": "9.0.2","react-jwt": "2.0.0","algoliasearch": "^5.40.0",+ "meilisearch": "^0.47.0","@talkjs/react": "^0.1.11"},"devDependencies": {@@ -41,6 +43,10 @@"@types/unzipper": "^0.10.10","@medusajs/cli": "^2.13.4","@types/multer": "^2.0.0",- "@types/jsonwebtoken": "^9.0.9"+ "@types/jsonwebtoken": "^9.0.9",+ "@swc/core": "^1.7.28",+ "@swc/jest": "^0.2.36",+ "@types/jest": "^29.5.13",+ "jest": "^30.2.0"}-}\ No newline at end of file+}diff --git a/packages/registry/r/meilisearch.json b/packages/registry/r/meilisearch.jsonnew file mode 100644index 000000000..98f263e4e--- /dev/null+++ b/packages/registry/r/meilisearch.json@@ -0,0 +1,95 @@+{+ "$schema": "https://registry.mercurjs.com/registry-item.json",+ "name": "meilisearch",+ "description": "Opt-in Meilisearch search block for multi-vendor marketplaces with real-time seller-aware indexing, seller lifecycle sync, and injection-safe smart filtering.",+ "dependencies": [+ "meilisearch"+ ],+ "registryDependencies": [],+ "docs": "## Prerequisites\n\nInstall and run a Meilisearch instance:\n\n```bash\ndocker run -d -p 7700:7700 getmeili/meilisearch\n```\n\n## Environment Variables\n\nAdd to your `.env` file:\n\n```env\nMEILISEARCH_HOST=http://localhost:7700\nMEILISEARCH_API_KEY=your_master_key_here\n```\n\n## Module Configuration\n\nAdd to your `medusa-config.ts`:\n\n```ts\nexport default defineConfig({\n modules: [\n {\n resolve: './modules/meilisearch',\n options: {\n host: process.env.MEILISEARCH_HOST,\n apiKey: process.env.MEILISEARCH_API_KEY,\n },\n },\n ],\n})\n```\n\n## Middlewares\n\nAdd to your `api/middlewares.ts`:\n\n```ts\nimport { defineMiddlewares } from \"@medusajs/medusa\";\nimport { allMeilisearchMiddlewares } from \"./meilisearch/api/middlewares\";\n\nexport default defineMiddlewares({\n routes: [...allMeilisearchMiddlewares],\n});\n```\n\n## Initial Sync\n\nAfter starting the server, trigger a full re-index:\n\n```bash\ncurl -X POST http://localhost:9000/admin/meilisearch/sync \\\n -H \"Authorization: Bearer YOUR_ADMIN_TOKEN\"\n```\n\n## Search\n\n```bash\ncurl -X POST http://localhost:9000/store/meilisearch/products \\\n -H \"Content-Type: application/json\" \\\n -H \"x-publishable-api-key: YOUR_KEY\" \\\n -d '{\"query\": \"shoes\", \"filters\": {\"price_min\": 50, \"price_max\": 200}}'\n```",+ "categories": [+ "search"+ ],+ "files": [+ {+ "path": "meilisearch/modules/meilisearch/index.ts",+ "content": "import { Module } from '@medusajs/framework/utils'\n\nimport MeilisearchModuleService from './service'\n\nexport const MEILISEARCH_MODULE = 'meilisearch'\nexport { MeilisearchModuleService }\n\nexport default Module(MEILISEARCH_MODULE, {\n service: MeilisearchModuleService,\n})\n",+ "type": "registry:api"+ },+ {+ "path": "meilisearch/modules/meilisearch/service.ts",+ "content": "import { MeiliSearch } from 'meilisearch'\n\nimport { IndexType, MeilisearchEntity, MeilisearchSearchResult } from './types'\n\ntype ModuleOptions = {\n host: string\n apiKey: string\n}\n\nconst SEARCHABLE_ATTRIBUTES = [\n 'title',\n 'subtitle',\n 'description',\n 'tags.value',\n 'type.value',\n 'categories.name',\n 'collection.title',\n 'variants.title',\n 'seller.name',\n 'seller.handle',\n]\n\nconst FILTERABLE_ATTRIBUTES = [\n 'seller.status',\n 'seller.handle',\n 'categories.id',\n 'categories.name',\n 'variants.prices.amount',\n 'status',\n]\n\nconst SORTABLE_ATTRIBUTES = ['title', 'variants.prices.amount']\n\nclass MeilisearchModuleService {\n private client_: MeiliSearch\n\n constructor(_: unknown, options: ModuleOptions) {\n if (!options?.host || !options?.apiKey) {\n const missing = [\n !options?.host && 'MEILISEARCH_HOST',\n !options?.apiKey && 'MEILISEARCH_API_KEY',\n ]\n .filter(Boolean)\n .join(', ')\n throw new Error(\n `[meilisearch block] Missing required environment variables: ${missing}`\n )\n }\n this.client_ = new MeiliSearch({\n host: options.host,\n apiKey: options.apiKey,\n })\n }\n\n getHost(): string {\n return (this.client_ as any).config?.host ?? ''\n }\n\n async getStatus(): Promise<{ documentCount: number; isHealthy: boolean }> {\n try {\n const index = this.client_.index(IndexType.PRODUCT)\n const stats = await index.getStats()\n return { documentCount: stats.numberOfDocuments, isHealthy: true }\n } catch {\n return { documentCount: 0, isHealthy: false }\n }\n }\n\n async batchUpsert(documents: MeilisearchEntity[]): Promise<void> {\n if (!documents.length) {\n return\n }\n const index = this.client_.index(IndexType.PRODUCT)\n await index.addDocuments(documents, { primaryKey: 'id' })\n }\n\n async batchDelete(ids: string[]): Promise<void> {\n if (!ids.length) {\n return\n }\n const index = this.client_.index(IndexType.PRODUCT)\n await index.deleteDocuments(ids)\n }\n\n async search(\n query: string,\n options: Record<string, unknown>\n ): Promise<MeilisearchSearchResult> {\n const index = this.client_.index(IndexType.PRODUCT)\n const result = await index.search(query, options)\n return {\n hits: (result.hits ?? []) as Array<{ id: string }>,\n totalHits: result.totalHits ?? result.estimatedTotalHits ?? 0,\n page: result.page ?? 0,\n totalPages: result.totalPages ?? 0,\n hitsPerPage: result.hitsPerPage ?? 0,\n processingTimeMs: result.processingTimeMs,\n query: result.query,\n facetDistribution: result.facetDistribution,\n }\n }\n\n async ensureSettings(): Promise<void> {\n const index = this.client_.index(IndexType.PRODUCT)\n await index.updateSettings({\n searchableAttributes: SEARCHABLE_ATTRIBUTES,\n filterableAttributes: FILTERABLE_ATTRIBUTES,\n sortableAttributes: SORTABLE_ATTRIBUTES,\n })\n }\n}\n\nexport default MeilisearchModuleService\n",+ "type": "registry:api"+ },+ {+ "path": "meilisearch/modules/meilisearch/types.ts",+ "content": "import { z } from 'zod'\n\nexport const MEILISEARCH_MODULE = 'meilisearch'\n\nexport enum IndexType {\n PRODUCT = 'products',\n}\n\nexport enum MeilisearchEvents {\n PRODUCTS_CHANGED = 'meilisearch.products.changed',\n PRODUCTS_DELETED = 'meilisearch.products.deleted',\n}\n\nexport const MeilisearchVariantValidator = z.object({\n id: z.string(),\n title: z.string().nullish(),\n sku: z.string().nullish(),\n barcode: z.string().nullish(),\n ean: z.string().nullish(),\n allow_backorder: z.boolean(),\n manage_inventory: z.boolean(),\n weight: z.number().nullish(),\n length: z.number().nullish(),\n height: z.number().nullish(),\n width: z.number().nullish(),\n variant_rank: z.number().nullish(),\n options: z.array(\n z.object({\n id: z.string(),\n value: z.string(),\n option: z.object({\n id: z.string(),\n title: z.string(),\n }),\n })\n ),\n prices: z.array(\n z.object({\n id: z.string(),\n currency_code: z.string(),\n amount: z.number(),\n min_quantity: z.number().nullish(),\n max_quantity: z.number().nullish(),\n rules_count: z.number(),\n })\n ),\n})\n\nexport const MeilisearchProductValidator = z.object({\n id: z.string(),\n title: z.string(),\n handle: z.string(),\n subtitle: z.string().nullable(),\n description: z.string().nullable(),\n thumbnail: z.string().nullable(),\n status: z.string(),\n categories: z\n .array(z.object({ id: z.string(), name: z.string() }))\n .optional(),\n tags: z.array(z.object({ value: z.string() })).optional(),\n collection: z.object({ title: z.string() }).nullable().optional(),\n type: z.object({ value: z.string() }).nullable().optional(),\n images: z\n .array(\n z.object({\n id: z.string(),\n url: z.string(),\n rank: z.number(),\n })\n )\n .optional(),\n options: z.array(z.record(z.string())).nullable().default(null),\n variants: z.array(MeilisearchVariantValidator).nullable().default(null),\n seller: z\n .object({\n id: z.string(),\n handle: z.string().nullish(),\n name: z.string().nullish(),\n status: z.string().nullish(),\n })\n .nullable(),\n})\n\nexport type MeilisearchProduct = z.infer<typeof MeilisearchProductValidator>\nexport type MeilisearchEntity = MeilisearchProduct\n\nexport type MeilisearchSearchResult = {\n hits: Array<{ id: string }>\n totalHits: number\n page: number\n totalPages: number\n hitsPerPage: number\n processingTimeMs: number\n query: string\n facetDistribution?: Record<string, Record<string, number>>\n}\n\nexport interface IMeilisearchModuleService {\n search(\n query: string,\n options: Record<string, unknown>\n ): Promise<MeilisearchSearchResult>\n}\n",+ "type": "registry:api"+ },+ {+ "path": "meilisearch/subscribers/utils/meilisearch-product.ts",+ "content": "import { z } from 'zod'\n\nimport { MedusaContainer } from '@medusajs/framework'\nimport { ContainerRegistrationKeys, arrayDifference } from '@medusajs/framework/utils'\n\nimport { MeilisearchProductValidator, MeilisearchVariantValidator } from '../../modules/meilisearch/types'\n\nexport async function filterProductsByStatus(\n container: MedusaContainer,\n ids: string[] = []\n) {\n const query = container.resolve(ContainerRegistrationKeys.QUERY)\n\n const { data: products } = await query.graph({\n entity: 'product',\n fields: ['id', 'status'],\n filters: { id: ids },\n })\n\n const published = products.filter((p) => p.status === 'published')\n const notPublished = arrayDifference(products, published)\n\n const existingIds = new Set(products.map((p) => p.id))\n const deletedIds = ids.filter((id) => !existingIds.has(id))\n\n return {\n published: published.map((p) => p.id),\n other: [...notPublished.map((p) => p.id), ...deletedIds],\n }\n}\n\nexport async function findAndTransformMeilisearchProducts(\n container: MedusaContainer,\n ids: string[] = []\n) {\n const query = container.resolve(ContainerRegistrationKeys.QUERY)\n\n const { data: products } = await query.graph({\n entity: 'product',\n fields: [\n '*',\n 'categories.name',\n 'categories.id',\n 'collection.title',\n 'tags.value',\n 'type.value',\n 'variants.*',\n 'variants.options.*',\n 'variants.options.prices.*',\n 'variants.prices.*',\n 'options.*',\n 'options.values.*',\n 'images.*',\n 'seller.id',\n 'seller.handle',\n 'seller.name',\n 'seller.status',\n ],\n filters: ids.length\n ? { id: ids, status: 'published' }\n : { status: 'published' },\n })\n\n for (const product of products as any[]) {\n product.options = (product.options ?? [])\n .filter((option: any) => option?.title && option?.values)\n .map((option: any) =>\n option.values.map((value: any) => {\n const entry: Record<string, string> = {}\n entry[option.title.toLowerCase()] = value.value\n return entry\n })\n )\n .flat()\n\n product.variants = z\n .array(MeilisearchVariantValidator)\n .parse(product.variants ?? [])\n\n product.variants = (product.variants ?? []).map((variant: any) =>\n (variant.options ?? []).reduce((entry: any, item: any) => {\n if (item?.option?.title) {\n entry[item.option.title.toLowerCase()] = item.value\n }\n return entry\n }, variant)\n )\n }\n\n return z.array(MeilisearchProductValidator).parse(products)\n}\n",+ "type": "registry:api"+ },+ {+ "path": "meilisearch/subscribers/meilisearch-product-events-bridge.ts",+ "content": "import { SubscriberArgs, SubscriberConfig } from '@medusajs/framework'\nimport { IEventBusModuleService } from '@medusajs/framework/types'\nimport { ContainerRegistrationKeys, Modules } from '@medusajs/framework/utils'\n\nimport { MeilisearchEvents } from '../modules/meilisearch/types'\n\nexport default async function meilisearchProductEventsBridgeHandler({\n event,\n container,\n}: SubscriberArgs<{ id: string }>) {\n const logger = container.resolve(ContainerRegistrationKeys.LOGGER)\n const eventBus = container.resolve<IEventBusModuleService>(Modules.EVENT_BUS)\n\n try {\n const isDelete =\n event.name === 'product.product.deleted' ||\n event.name === 'product.deleted'\n\n await eventBus.emit({\n name: isDelete\n ? MeilisearchEvents.PRODUCTS_DELETED\n : MeilisearchEvents.PRODUCTS_CHANGED,\n data: { ids: [event.data.id] },\n })\n } catch (error: unknown) {\n logger.error(\n `Meilisearch bridge: failed to forward event ${event.name} for product ${event.data.id}:`,\n error as Error\n )\n throw error\n }\n}\n\nexport const config: SubscriberConfig = {\n event: [\n 'product.created',\n 'product.updated',\n 'product.deleted',\n 'product.product.created',\n 'product.product.updated',\n 'product.product.deleted',\n ],\n context: {\n subscriberId: 'meilisearch-product-events-bridge',\n },\n}\n",+ "type": "registry:api"+ },+ {+ "path": "meilisearch/subscribers/meilisearch-products-changed.ts",+ "content": "import { SubscriberArgs, SubscriberConfig } from '@medusajs/framework'\nimport { ContainerRegistrationKeys } from '@medusajs/framework/utils'\n\nimport { MEILISEARCH_MODULE, MeilisearchModuleService } from '../modules/meilisearch'\nimport { MeilisearchEvents } from '../modules/meilisearch/types'\nimport {\n filterProductsByStatus,\n findAndTransformMeilisearchProducts,\n} from './utils/meilisearch-product'\n\nexport default async function meilisearchProductsChangedHandler({\n event,\n container,\n}: SubscriberArgs<{ ids: string[] }>) {\n const logger = container.resolve(ContainerRegistrationKeys.LOGGER)\n\n try {\n const meilisearch =\n container.resolve<MeilisearchModuleService>(MEILISEARCH_MODULE)\n\n const { published, other } = await filterProductsByStatus(\n container,\n event.data.ids\n )\n\n logger.debug(\n `Meilisearch sync: Processing ${event.data.ids.length} products — ${published.length} to upsert, ${other.length} to delete`\n )\n\n const documentsToUpsert = published.length\n ? await findAndTransformMeilisearchProducts(container, published)\n : []\n\n if (documentsToUpsert.length) {\n await meilisearch.batchUpsert(documentsToUpsert)\n }\n if (other.length) {\n await meilisearch.batchDelete(other)\n }\n\n logger.debug(\n `Meilisearch sync: Successfully synced ${documentsToUpsert.length} products`\n )\n } catch (error: unknown) {\n logger.error(\n `Meilisearch sync failed for products [${event.data.ids.join(', ')}]:`,\n error as Error\n )\n throw error\n }\n}\n\nexport const config: SubscriberConfig = {\n event: MeilisearchEvents.PRODUCTS_CHANGED,\n context: {\n subscriberId: 'meilisearch-products-changed-handler',\n },\n}\n",+ "type": "registry:api"+ },+ {+ "path": "meilisearch/subscribers/meilisearch-products-deleted.ts",+ "content": "import { SubscriberArgs, SubscriberConfig } from '@medusajs/framework'\nimport { ContainerRegistrationKeys } from '@medusajs/framework/utils'\n\nimport { MEILISEARCH_MODULE, MeilisearchModuleService } from '../modules/meilisearch'\nimport { MeilisearchEvents } from '../modules/meilisearch/types'\n\nexport default async function meilisearchProductsDeletedHandler({\n event,\n container,\n}: SubscriberArgs<{ ids: string[] }>) {\n const logger = container.resolve(ContainerRegistrationKeys.LOGGER)\n\n try {\n const meilisearch =\n container.resolve<MeilisearchModuleService>(MEILISEARCH_MODULE)\n\n logger.debug(\n `Meilisearch delete: Removing ${event.data.ids.length} products from index`\n )\n\n await meilisearch.batchDelete(event.data.ids)\n\n logger.debug(\n `Meilisearch delete: Successfully removed ${event.data.ids.length} products`\n )\n } catch (error: unknown) {\n logger.error(\n `Meilisearch delete failed for products [${event.data.ids.join(', ')}]:`,\n error as Error\n )\n throw error\n }\n}\n\nexport const config: SubscriberConfig = {\n event: MeilisearchEvents.PRODUCTS_DELETED,\n context: {\n subscriberId: 'meilisearch-products-deleted-handler',\n },\n}\n",+ "type": "registry:api"+ },+ {+ "path": "meilisearch/subscribers/meilisearch-seller-suspended.ts",+ "content": "import { SubscriberArgs, SubscriberConfig } from '@medusajs/framework'\nimport { IEventBusModuleService } from '@medusajs/framework/types'\nimport { ContainerRegistrationKeys, Modules } from '@medusajs/framework/utils'\n\nimport { MeilisearchEvents } from '../modules/meilisearch/types'\n\nconst CHUNK_SIZE = 100\n\nexport default async function meilisearchSellerSuspendedHandler({\n event,\n container,\n}: SubscriberArgs<{ id: string }>) {\n const logger = container.resolve(ContainerRegistrationKeys.LOGGER)\n const query = container.resolve(ContainerRegistrationKeys.QUERY)\n const eventBus = container.resolve<IEventBusModuleService>(Modules.EVENT_BUS)\n\n try {\n const sellerId = event.data.id\n\n // Query seller with linked products to get product IDs (bidirectional link)\n const { data: sellers } = await query.graph({\n entity: 'seller',\n fields: ['products.id'],\n filters: { id: sellerId },\n })\n\n const productIds: string[] =\n (sellers[0] as any)?.products?.map((p: any) => p.id) ?? []\n\n if (!productIds.length) {\n return\n }\n\n logger.debug(\n `Meilisearch: Seller ${sellerId} suspended — re-indexing ${productIds.length} products`\n )\n\n // Emit in chunks so products-changed subscriber processes them in manageable batches\n for (let i = 0; i < productIds.length; i += CHUNK_SIZE) {\n const chunk = productIds.slice(i, i + CHUNK_SIZE)\n await eventBus.emit({\n name: MeilisearchEvents.PRODUCTS_CHANGED,\n data: { ids: chunk },\n })\n }\n } catch (error: unknown) {\n logger.error(\n `Meilisearch: Failed to process seller.suspended for seller ${event.data.id}:`,\n error as Error\n )\n throw error\n }\n}\n\nexport const config: SubscriberConfig = {\n event: 'seller.suspended',\n context: {\n subscriberId: 'meilisearch-seller-suspended-handler',\n },\n}\n",+ "type": "registry:api"+ },+ {+ "path": "meilisearch/subscribers/meilisearch-seller-unsuspended.ts",+ "content": "import { SubscriberArgs, SubscriberConfig } from '@medusajs/framework'\nimport { IEventBusModuleService } from '@medusajs/framework/types'\nimport { ContainerRegistrationKeys, Modules } from '@medusajs/framework/utils'\n\nimport { MeilisearchEvents } from '../modules/meilisearch/types'\n\nconst CHUNK_SIZE = 100\n\nexport default async function meilisearchSellerUnsuspendedHandler({\n event,\n container,\n}: SubscriberArgs<{ id: string }>) {\n const logger = container.resolve(ContainerRegistrationKeys.LOGGER)\n const query = container.resolve(ContainerRegistrationKeys.QUERY)\n const eventBus = container.resolve<IEventBusModuleService>(Modules.EVENT_BUS)\n\n try {\n const sellerId = event.data.id\n\n // Query seller with linked products to get product IDs (bidirectional link)\n const { data: sellers } = await query.graph({\n entity: 'seller',\n fields: ['products.id'],\n filters: { id: sellerId },\n })\n\n const productIds: string[] =\n (sellers[0] as any)?.products?.map((p: any) => p.id) ?? []\n\n if (!productIds.length) {\n return\n }\n\n logger.debug(\n `Meilisearch: Seller ${sellerId} unsuspended — re-indexing ${productIds.length} products`\n )\n\n for (let i = 0; i < productIds.length; i += CHUNK_SIZE) {\n const chunk = productIds.slice(i, i + CHUNK_SIZE)\n await eventBus.emit({\n name: MeilisearchEvents.PRODUCTS_CHANGED,\n data: { ids: chunk },\n })\n }\n } catch (error: unknown) {\n logger.error(\n `Meilisearch: Failed to process seller.unsuspended for seller ${event.data.id}:`,\n error as Error\n )\n throw error\n }\n}\n\nexport const config: SubscriberConfig = {\n event: 'seller.unsuspended',\n context: {\n subscriberId: 'meilisearch-seller-unsuspended-handler',\n },\n}\n",+ "type": "registry:api"+ },+ {+ "path": "meilisearch/workflows/meilisearch/steps/sync-meilisearch-products.ts",+ "content": "import { IEventBusModuleService, RemoteQueryFunction } from '@medusajs/framework/types'\nimport { ContainerRegistrationKeys, Modules } from '@medusajs/framework/utils'\nimport { StepResponse, createStep } from '@medusajs/framework/workflows-sdk'\n\nimport { MEILISEARCH_MODULE, MeilisearchModuleService } from '../../../modules/meilisearch'\nimport { MeilisearchEvents } from '../../../modules/meilisearch/types'\n\nconst CHUNK_SIZE = 100\n\nexport const syncMeilisearchProductsStep = createStep(\n 'sync-meilisearch-products',\n async (_: void, { container }) => {\n const query = container.resolve<RemoteQueryFunction>(\n ContainerRegistrationKeys.QUERY\n )\n const meilisearch =\n container.resolve<MeilisearchModuleService>(MEILISEARCH_MODULE)\n const eventBus = container.resolve<IEventBusModuleService>(Modules.EVENT_BUS)\n\n // Delete products that are not published or have been soft-deleted\n const { data: productsToDelete } = await query.graph({\n entity: 'product',\n filters: {\n status: { $ne: 'published' },\n },\n fields: ['id'],\n })\n\n if (productsToDelete.length) {\n await meilisearch.batchDelete(productsToDelete.map((p) => p.id))\n }\n\n // Fetch all published product IDs and process in chunks\n const { data: publishedProducts } = await query.graph({\n entity: 'product',\n filters: { status: 'published' },\n fields: ['id'],\n })\n\n const productIds = publishedProducts.map((p) => p.id)\n\n for (let i = 0; i < productIds.length; i += CHUNK_SIZE) {\n const chunk = productIds.slice(i, i + CHUNK_SIZE)\n await eventBus.emit({\n name: MeilisearchEvents.PRODUCTS_CHANGED,\n data: { ids: chunk },\n })\n }\n\n return new StepResponse()\n }\n)\n",+ "type": "registry:api"+ },+ {+ "path": "meilisearch/workflows/meilisearch/workflows/sync-meilisearch.ts",+ "content": "import { createWorkflow, WorkflowResponse } from '@medusajs/framework/workflows-sdk'\n\nimport { syncMeilisearchProductsStep } from '../steps/sync-meilisearch-products'\n\nexport const syncMeilisearchWorkflow = createWorkflow(\n 'sync-meilisearch-workflow',\n function () {\n return new WorkflowResponse(syncMeilisearchProductsStep())\n }\n)\n",+ "type": "registry:api"+ },+ {+ "path": "meilisearch/api/middlewares.ts",+ "content": "import { meilisearchStoreMiddlewares } from './store/meilisearch/products/search/middlewares'\n\nexport const allMeilisearchMiddlewares = [...meilisearchStoreMiddlewares]\n",+ "type": "registry:api"+ },+ {+ "path": "meilisearch/api/admin/meilisearch/route.ts",+ "content": "import { AuthenticatedMedusaRequest, MedusaResponse } from '@medusajs/framework'\n\nimport { MEILISEARCH_MODULE, MeilisearchModuleService } from '../../../modules/meilisearch'\nimport { IndexType } from '../../../modules/meilisearch/types'\nimport { syncMeilisearchWorkflow } from '../../../workflows/meilisearch/workflows/sync-meilisearch'\n\nexport const POST = async (\n req: AuthenticatedMedusaRequest,\n res: MedusaResponse\n) => {\n await syncMeilisearchWorkflow.run({\n container: req.scope,\n })\n\n res.status(200).json({ message: 'Sync in progress' })\n}\n\nexport const GET = async (\n req: AuthenticatedMedusaRequest,\n res: MedusaResponse\n) => {\n const meilisearch =\n req.scope.resolve<MeilisearchModuleService>(MEILISEARCH_MODULE)\n\n const host = meilisearch.getHost()\n const { documentCount, isHealthy } = await meilisearch.getStatus()\n\n res.status(200).json({\n host,\n index: IndexType.PRODUCT,\n documentCount,\n isHealthy,\n })\n}\n",+ "type": "registry:api"+ },+ {+ "path": "meilisearch/api/store/meilisearch/products/search/validators.ts",+ "content": "import { z } from 'zod'\n\nexport const StoreMeilisearchFiltersSchema = z.object({\n categories: z.array(z.string().min(1)).optional(),\n price_min: z.number().min(0).optional(),\n price_max: z.number().min(0).optional(),\n seller_handle: z.string().min(1).optional(),\n})\n\nexport const StoreMeilisearchSearchSchema = z.object({\n query: z.string().default(''),\n page: z.coerce.number().int().min(0).default(0),\n hitsPerPage: z.coerce.number().int().min(1).max(100).default(12),\n filters: StoreMeilisearchFiltersSchema.optional(),\n currency_code: z.string().length(3).optional(),\n region_id: z.string().optional(),\n customer_id: z.string().optional(),\n customer_group_id: z.array(z.string()).optional(),\n})\n\nexport type StoreMeilisearchSearchType = z.infer<typeof StoreMeilisearchSearchSchema>\n",+ "type": "registry:api"+ },+ {+ "path": "meilisearch/api/store/meilisearch/products/search/middlewares.ts",+ "content": "import { MiddlewareRoute, validateAndTransformBody } from '@medusajs/framework'\n\nimport { StoreMeilisearchSearchSchema } from './validators'\n\nexport const meilisearchStoreMiddlewares: MiddlewareRoute[] = [\n {\n methods: ['POST'],\n matcher: '/store/meilisearch/products/search',\n middlewares: [validateAndTransformBody(StoreMeilisearchSearchSchema)],\n },\n]\n",+ "type": "registry:api"+ },+ {+ "path": "meilisearch/api/store/meilisearch/products/search/route.ts",+ "content": "import { MedusaRequest, MedusaResponse } from '@medusajs/framework'\nimport { ContainerRegistrationKeys, QueryContext } from '@medusajs/framework/utils'\n\nimport { MEILISEARCH_MODULE, MeilisearchModuleService } from '../../../../../modules/meilisearch'\nimport { IndexType } from '../../../../../modules/meilisearch/types'\nimport { StoreMeilisearchSearchType } from './validators'\n\nexport const POST = async (\n req: MedusaRequest<StoreMeilisearchSearchType>,\n res: MedusaResponse\n) => {\n const meilisearchService =\n req.scope.resolve<MeilisearchModuleService>(MEILISEARCH_MODULE)\n const query = req.scope.resolve(ContainerRegistrationKeys.QUERY)\n\n const {\n query: searchQuery,\n page,\n hitsPerPage,\n filters,\n currency_code,\n region_id,\n customer_id,\n customer_group_id,\n } = req.validatedBody\n\n // Build filter string server-side — seller.status = \"active\" is always enforced (FR-003)\n const filterParts: string[] = ['seller.status = \"active\"']\n\n if (filters?.categories?.length) {\n const ids = filters.categories.map((c) => `\"${c}\"`).join(', ')\n filterParts.push(`categories.id IN [${ids}]`)\n }\n if (filters?.price_min !== undefined) {\n filterParts.push(`variants.prices.amount >= ${filters.price_min}`)\n }\n if (filters?.price_max !== undefined) {\n filterParts.push(`variants.prices.amount <= ${filters.price_max}`)\n }\n if (filters?.seller_handle) {\n filterParts.push(`seller.handle = \"${filters.seller_handle}\"`)\n }\n\n const filter = filterParts.join(' AND ')\n\n const searchResult = await meilisearchService.search(searchQuery, {\n filter,\n page,\n hitsPerPage,\n attributesToRetrieve: ['id'],\n })\n\n const productIds = searchResult.hits.map((hit) => hit.id)\n\n if (!productIds.length) {\n return res.json({\n products: [],\n totalHits: searchResult.totalHits,\n page: searchResult.page,\n totalPages: searchResult.totalPages,\n hitsPerPage: searchResult.hitsPerPage,\n processingTimeMs: searchResult.processingTimeMs,\n query: searchResult.query,\n })\n }\n\n const hasPricingContext =\n currency_code || region_id || customer_id || customer_group_id\n\n const contextParams: Record<string, unknown> = {}\n if (hasPricingContext) {\n contextParams.variants = {\n calculated_price: QueryContext({\n ...(currency_code && { currency_code }),\n ...(region_id && { region_id }),\n ...(customer_id && { customer_id }),\n ...(customer_group_id && { customer_group_id }),\n }),\n }\n }\n\n const { data: products } = await query.graph({\n entity: 'product',\n fields: [\n '*',\n 'images.*',\n 'options.*',\n 'options.values.*',\n 'variants.*',\n 'variants.options.*',\n 'variants.prices.*',\n ...(hasPricingContext ? ['variants.calculated_price.*'] : []),\n 'categories.*',\n 'collection.*',\n 'type.*',\n 'tags.*',\n 'seller.*',\n ],\n filters: { id: productIds },\n ...(Object.keys(contextParams).length > 0 && { context: contextParams }),\n })\n\n const productMap = new Map(products.map((p) => [p.id, p]))\n const orderedProducts = productIds.map((id) => productMap.get(id)).filter(Boolean)\n\n return res.json({\n products: orderedProducts,\n totalHits: searchResult.totalHits,\n page: searchResult.page,\n totalPages: searchResult.totalPages,\n hitsPerPage: searchResult.hitsPerPage,\n processingTimeMs: searchResult.processingTimeMs,\n query: searchResult.query,\n facetDistribution: searchResult.facetDistribution,\n })\n}\n",+ "type": "registry:api"+ }+ ]+}\ No newline at end of filediff --git a/packages/registry/r/registry.json b/packages/registry/r/registry.jsonindex 9647bd30b..991a14c0d 100644--- a/packages/registry/r/registry.json+++ b/packages/registry/r/registry.json@@ -228,7 +228,7 @@"@medusajs/core-flows"],"registryDependencies": [],- "docs": "## Product Import/Export Block\n\n### Dependencies\n\nInstall dependencies in the **API workspace** (not the project root):\n\n```bash\ncd packages/api\nbun add @medusajs/core-flows multer @types/multer\n```\n\n### Configuration\n\nNo additional modules needed — uses built-in Medusa product CSV steps.\n\n### Middleware Setup\n\nAdd the import middleware to your `api/middlewares.ts`:\n\n```ts\nimport { defineMiddlewares } from '@medusajs/medusa'\nimport { productImportExportMiddlewares } from './vendor/products/middlewares'\n\nexport default defineMiddlewares({\n routes: [...productImportExportMiddlewares],\n})\n```\n\n### Run codegen\n\nAfter installing the block, regenerate SDK types:\n\n```bash\nnpx @mercurjs/cli@latest codegen\n```\n\n### Vendor Navigation\n\nThe block includes a `products/page.tsx` that overrides the default product list page, adding Import and Export buttons in the header. The buttons open drawer routes at `/products/import` and `/products/export`.",+ "docs": "## Product Import/Export Block\n\n### Dependencies\n\nInstall dependencies in the **API workspace** (not the project root):\n\n```bash\ncd packages/api\nbun add @medusajs/core-flows multer @types/multer\n```\n\n### Configuration\n\nNo additional modules needed \u2014 uses built-in Medusa product CSV steps.\n\n### Middleware Setup\n\nAdd the import middleware to your `api/middlewares.ts`:\n\n```ts\nimport { defineMiddlewares } from '@medusajs/medusa'\nimport { productImportExportMiddlewares } from './vendor/products/middlewares'\n\nexport default defineMiddlewares({\n routes: [...productImportExportMiddlewares],\n})\n```\n\n### Run codegen\n\nAfter installing the block, regenerate SDK types:\n\n```bash\nnpx @mercurjs/cli@latest codegen\n```\n\n### Vendor Navigation\n\nThe block includes a `products/page.tsx` that overrides the default product list page, adding Import and Export buttons in the header. The buttons open drawer routes at `/products/import` and `/products/export`.","files": [{"path": "product-import-export/workflows/steps/get-seller-products.ts",@@ -697,7 +697,7 @@"description": "Admin approval system powered by the Custom Fields module. Admins can list, review, accept or reject entity requests.","dependencies": [],"registryDependencies": [],- "docs": "## Prerequisites\n\nThis block requires the **Custom Fields module** (`@mercurjs/core-plugin/modules/custom-fields`). Make sure it is registered in your `medusa-config.ts`.\n\n## Configuration\n\nAdd request-related custom fields to the entities you want to support approval workflows for. Product already has a built-in `status` field, so you only need to configure custom fields for other entities.\n\nAdd these fields to your Custom Fields module options in `medusa-config.ts`:\n\n```ts\n{\n resolve: \"@mercurjs/core-plugin/modules/custom-fields\",\n options: {\n customFields: {\n ProductCollection: {\n request_status: {\n type: \"enum\",\n enum: [\"draft\", \"pending\", \"accepted\", \"rejected\"],\n defaultValue: \"draft\",\n },\n submitter_id: { type: \"string\", nullable: true },\n reviewer_id: { type: \"string\", nullable: true },\n reviewer_note: { type: \"text\", nullable: true },\n },\n // Add the same fields to other entities as needed:\n // ProductCategory, ProductType, ProductTag\n },\n },\n}\n```\n\n## Middlewares\n\nAdd the request middlewares to your `api/middlewares.ts`:\n\n```ts\nimport { defineMiddlewares } from \"@medusajs/medusa\";\nimport { adminRequestsMiddlewares } from \"./admin/requests/middlewares\";\nimport { vendorProductCollectionRequestsMiddlewares } from \"./vendor/requests/product-collections/middlewares\";\nimport { vendorProductCategoryRequestsMiddlewares } from \"./vendor/requests/product-categories/middlewares\";\nimport { vendorProductTypeRequestsMiddlewares } from \"./vendor/requests/product-types/middlewares\";\nimport { vendorProductTagRequestsMiddlewares } from \"./vendor/requests/product-tags/middlewares\";\n\nexport default defineMiddlewares({\n routes: [\n ...adminRequestsMiddlewares,\n ...vendorProductCollectionRequestsMiddlewares,\n ...vendorProductCategoryRequestsMiddlewares,\n ...vendorProductTypeRequestsMiddlewares,\n ...vendorProductTagRequestsMiddlewares,\n ],\n});\n```\n\nIf you already have a `middlewares.ts` file, merge the middleware imports and spread them into your existing `routes` array.\n\n## Database Migrations\n\nAfter updating the custom fields configuration, run migrations:\n\n```bash\nnpx medusa db:migrate\n```\n\n## Run codegen\n\nAfter installing the block, regenerate SDK types:\n\n```bash\nnpx @mercurjs/cli@latest codegen\n```\n\n## API Endpoints\n\n### Admin\n\n- `GET /admin/requests/:type` — List entities with request custom fields (filterable by `request_status`, `submitter_id`)\n- `GET /admin/requests/:type/:id` — Retrieve entity with request custom fields\n- `POST /admin/requests/:type/:id/accept` — Accept a request\n- `POST /admin/requests/:type/:id/reject` — Reject a request\n\nSupported `:type` values: `product_collection`, `product_category`, `product_type`, `product_tag`\n\n### Vendor\n\n- `GET /vendor/requests/product-collections` — List vendor's collection requests\n- `POST /vendor/requests/product-collections` — Create a collection request\n- `GET /vendor/requests/product-categories` — List vendor's category requests\n- `POST /vendor/requests/product-categories` — Create a category request\n- `GET /vendor/requests/product-types` — List vendor's type requests\n- `POST /vendor/requests/product-types` — Create a type request\n- `GET /vendor/requests/product-tags` — List vendor's tag requests\n- `POST /vendor/requests/product-tags` — Create a tag request",+ "docs": "## Prerequisites\n\nThis block requires the **Custom Fields module** (`@mercurjs/core-plugin/modules/custom-fields`). Make sure it is registered in your `medusa-config.ts`.\n\n## Configuration\n\nAdd request-related custom fields to the entities you want to support approval workflows for. Product already has a built-in `status` field, so you only need to configure custom fields for other entities.\n\nAdd these fields to your Custom Fields module options in `medusa-config.ts`:\n\n```ts\n{\n resolve: \"@mercurjs/core-plugin/modules/custom-fields\",\n options: {\n customFields: {\n ProductCollection: {\n request_status: {\n type: \"enum\",\n enum: [\"draft\", \"pending\", \"accepted\", \"rejected\"],\n defaultValue: \"draft\",\n },\n submitter_id: { type: \"string\", nullable: true },\n reviewer_id: { type: \"string\", nullable: true },\n reviewer_note: { type: \"text\", nullable: true },\n },\n // Add the same fields to other entities as needed:\n // ProductCategory, ProductType, ProductTag\n },\n },\n}\n```\n\n## Middlewares\n\nAdd the request middlewares to your `api/middlewares.ts`:\n\n```ts\nimport { defineMiddlewares } from \"@medusajs/medusa\";\nimport { adminRequestsMiddlewares } from \"./admin/requests/middlewares\";\nimport { vendorProductCollectionRequestsMiddlewares } from \"./vendor/requests/product-collections/middlewares\";\nimport { vendorProductCategoryRequestsMiddlewares } from \"./vendor/requests/product-categories/middlewares\";\nimport { vendorProductTypeRequestsMiddlewares } from \"./vendor/requests/product-types/middlewares\";\nimport { vendorProductTagRequestsMiddlewares } from \"./vendor/requests/product-tags/middlewares\";\n\nexport default defineMiddlewares({\n routes: [\n ...adminRequestsMiddlewares,\n ...vendorProductCollectionRequestsMiddlewares,\n ...vendorProductCategoryRequestsMiddlewares,\n ...vendorProductTypeRequestsMiddlewares,\n ...vendorProductTagRequestsMiddlewares,\n ],\n});\n```\n\nIf you already have a `middlewares.ts` file, merge the middleware imports and spread them into your existing `routes` array.\n\n## Database Migrations\n\nAfter updating the custom fields configuration, run migrations:\n\n```bash\nnpx medusa db:migrate\n```\n\n## Run codegen\n\nAfter installing the block, regenerate SDK types:\n\n```bash\nnpx @mercurjs/cli@latest codegen\n```\n\n## API Endpoints\n\n### Admin\n\n- `GET /admin/requests/:type` \u2014 List entities with request custom fields (filterable by `request_status`, `submitter_id`)\n- `GET /admin/requests/:type/:id` \u2014 Retrieve entity with request custom fields\n- `POST /admin/requests/:type/:id/accept` \u2014 Accept a request\n- `POST /admin/requests/:type/:id/reject` \u2014 Reject a request\n\nSupported `:type` values: `product_collection`, `product_category`, `product_type`, `product_tag`\n\n### Vendor\n\n- `GET /vendor/requests/product-collections` \u2014 List vendor's collection requests\n- `POST /vendor/requests/product-collections` \u2014 Create a collection request\n- `GET /vendor/requests/product-categories` \u2014 List vendor's category requests\n- `POST /vendor/requests/product-categories` \u2014 Create a category request\n- `GET /vendor/requests/product-types` \u2014 List vendor's type requests\n- `POST /vendor/requests/product-types` \u2014 Create a type request\n- `GET /vendor/requests/product-tags` \u2014 List vendor's tag requests\n- `POST /vendor/requests/product-tags` \u2014 Create a tag request","files": [{"path": "requests/types/index.ts",@@ -979,6 +979,84 @@"api","vendor"]+ },+ {+ "name": "meilisearch",+ "description": "Opt-in Meilisearch search block for multi-vendor marketplaces with real-time seller-aware indexing, seller lifecycle sync, and injection-safe smart filtering.",+ "dependencies": [+ "meilisearch"+ ],+ "registryDependencies": [],+ "docs": "## Prerequisites\n\nInstall and run a Meilisearch instance:\n\n```bash\ndocker run -d -p 7700:7700 getmeili/meilisearch\n```\n\n## Environment Variables\n\nAdd to your `.env` file:\n\n```env\nMEILISEARCH_HOST=http://localhost:7700\nMEILISEARCH_API_KEY=your_master_key_here\n```\n\n## Module Configuration\n\nAdd to your `medusa-config.ts`:\n\n```ts\nexport default defineConfig({\n modules: [\n {\n resolve: './modules/meilisearch',\n options: {\n host: process.env.MEILISEARCH_HOST,\n apiKey: process.env.MEILISEARCH_API_KEY,\n },\n },\n ],\n})\n```\n\n## Middlewares\n\nAdd to your `api/middlewares.ts`:\n\n```ts\nimport { defineMiddlewares } from \"@medusajs/medusa\";\nimport { allMeilisearchMiddlewares } from \"./meilisearch/api/middlewares\";\n\nexport default defineMiddlewares({\n routes: [...allMeilisearchMiddlewares],\n});\n```\n\n## Initial Sync\n\nAfter starting the server, trigger a full re-index:\n\n```bash\ncurl -X POST http://localhost:9000/admin/meilisearch/sync \\\n -H \"Authorization: Bearer YOUR_ADMIN_TOKEN\"\n```\n\n## Search\n\n```bash\ncurl -X POST http://localhost:9000/store/meilisearch/products \\\n -H \"Content-Type: application/json\" \\\n -H \"x-publishable-api-key: YOUR_KEY\" \\\n -d '{\"query\": \"shoes\", \"filters\": {\"price_min\": 50, \"price_max\": 200}}'\n```",+ "files": [+ {+ "path": "meilisearch/modules/meilisearch/index.ts",+ "type": "registry:api"+ },+ {+ "path": "meilisearch/modules/meilisearch/service.ts",+ "type": "registry:api"+ },+ {+ "path": "meilisearch/modules/meilisearch/types.ts",+ "type": "registry:api"+ },+ {+ "path": "meilisearch/subscribers/utils/meilisearch-product.ts",+ "type": "registry:api"+ },+ {+ "path": "meilisearch/subscribers/meilisearch-product-events-bridge.ts",+ "type": "registry:api"+ },+ {+ "path": "meilisearch/subscribers/meilisearch-products-changed.ts",+ "type": "registry:api"+ },+ {+ "path": "meilisearch/subscribers/meilisearch-products-deleted.ts",+ "type": "registry:api"+ },+ {+ "path": "meilisearch/subscribers/meilisearch-seller-suspended.ts",+ "type": "registry:api"+ },+ {+ "path": "meilisearch/subscribers/meilisearch-seller-unsuspended.ts",+ "type": "registry:api"+ },+ {+ "path": "meilisearch/workflows/meilisearch/steps/sync-meilisearch-products.ts",+ "type": "registry:api"+ },+ {+ "path": "meilisearch/workflows/meilisearch/workflows/sync-meilisearch.ts",+ "type": "registry:api"+ },+ {+ "path": "meilisearch/api/middlewares.ts",+ "type": "registry:api"+ },+ {+ "path": "meilisearch/api/admin/meilisearch/route.ts",+ "type": "registry:api"+ },+ {+ "path": "meilisearch/api/store/meilisearch/products/search/validators.ts",+ "type": "registry:api"+ },+ {+ "path": "meilisearch/api/store/meilisearch/products/search/middlewares.ts",+ "type": "registry:api"+ },+ {+ "path": "meilisearch/api/store/meilisearch/products/search/route.ts",+ "type": "registry:api"+ }+ ],+ "categories": [+ "search"+ ]}]}\ No newline at end of filediff --git a/packages/registry/registry.json b/packages/registry/registry.jsonindex 9647bd30b..991a14c0d 100644--- a/packages/registry/registry.json+++ b/packages/registry/registry.json@@ -228,7 +228,7 @@"@medusajs/core-flows"],"registryDependencies": [],- "docs": "## Product Import/Export Block\n\n### Dependencies\n\nInstall dependencies in the **API workspace** (not the project root):\n\n```bash\ncd packages/api\nbun add @medusajs/core-flows multer @types/multer\n```\n\n### Configuration\n\nNo additional modules needed — uses built-in Medusa product CSV steps.\n\n### Middleware Setup\n\nAdd the import middleware to your `api/middlewares.ts`:\n\n```ts\nimport { defineMiddlewares } from '@medusajs/medusa'\nimport { productImportExportMiddlewares } from './vendor/products/middlewares'\n\nexport default defineMiddlewares({\n routes: [...productImportExportMiddlewares],\n})\n```\n\n### Run codegen\n\nAfter installing the block, regenerate SDK types:\n\n```bash\nnpx @mercurjs/cli@latest codegen\n```\n\n### Vendor Navigation\n\nThe block includes a `products/page.tsx` that overrides the default product list page, adding Import and Export buttons in the header. The buttons open drawer routes at `/products/import` and `/products/export`.",+ "docs": "## Product Import/Export Block\n\n### Dependencies\n\nInstall dependencies in the **API workspace** (not the project root):\n\n```bash\ncd packages/api\nbun add @medusajs/core-flows multer @types/multer\n```\n\n### Configuration\n\nNo additional modules needed \u2014 uses built-in Medusa product CSV steps.\n\n### Middleware Setup\n\nAdd the import middleware to your `api/middlewares.ts`:\n\n```ts\nimport { defineMiddlewares } from '@medusajs/medusa'\nimport { productImportExportMiddlewares } from './vendor/products/middlewares'\n\nexport default defineMiddlewares({\n routes: [...productImportExportMiddlewares],\n})\n```\n\n### Run codegen\n\nAfter installing the block, regenerate SDK types:\n\n```bash\nnpx @mercurjs/cli@latest codegen\n```\n\n### Vendor Navigation\n\nThe block includes a `products/page.tsx` that overrides the default product list page, adding Import and Export buttons in the header. The buttons open drawer routes at `/products/import` and `/products/export`.","files": [{"path": "product-import-export/workflows/steps/get-seller-products.ts",@@ -697,7 +697,7 @@"description": "Admin approval system powered by the Custom Fields module. Admins can list, review, accept or reject entity requests.","dependencies": [],"registryDependencies": [],- "docs": "## Prerequisites\n\nThis block requires the **Custom Fields module** (`@mercurjs/core-plugin/modules/custom-fields`). Make sure it is registered in your `medusa-config.ts`.\n\n## Configuration\n\nAdd request-related custom fields to the entities you want to support approval workflows for. Product already has a built-in `status` field, so you only need to configure custom fields for other entities.\n\nAdd these fields to your Custom Fields module options in `medusa-config.ts`:\n\n```ts\n{\n resolve: \"@mercurjs/core-plugin/modules/custom-fields\",\n options: {\n customFields: {\n ProductCollection: {\n request_status: {\n type: \"enum\",\n enum: [\"draft\", \"pending\", \"accepted\", \"rejected\"],\n defaultValue: \"draft\",\n },\n submitter_id: { type: \"string\", nullable: true },\n reviewer_id: { type: \"string\", nullable: true },\n reviewer_note: { type: \"text\", nullable: true },\n },\n // Add the same fields to other entities as needed:\n // ProductCategory, ProductType, ProductTag\n },\n },\n}\n```\n\n## Middlewares\n\nAdd the request middlewares to your `api/middlewares.ts`:\n\n```ts\nimport { defineMiddlewares } from \"@medusajs/medusa\";\nimport { adminRequestsMiddlewares } from \"./admin/requests/middlewares\";\nimport { vendorProductCollectionRequestsMiddlewares } from \"./vendor/requests/product-collections/middlewares\";\nimport { vendorProductCategoryRequestsMiddlewares } from \"./vendor/requests/product-categories/middlewares\";\nimport { vendorProductTypeRequestsMiddlewares } from \"./vendor/requests/product-types/middlewares\";\nimport { vendorProductTagRequestsMiddlewares } from \"./vendor/requests/product-tags/middlewares\";\n\nexport default defineMiddlewares({\n routes: [\n ...adminRequestsMiddlewares,\n ...vendorProductCollectionRequestsMiddlewares,\n ...vendorProductCategoryRequestsMiddlewares,\n ...vendorProductTypeRequestsMiddlewares,\n ...vendorProductTagRequestsMiddlewares,\n ],\n});\n```\n\nIf you already have a `middlewares.ts` file, merge the middleware imports and spread them into your existing `routes` array.\n\n## Database Migrations\n\nAfter updating the custom fields configuration, run migrations:\n\n```bash\nnpx medusa db:migrate\n```\n\n## Run codegen\n\nAfter installing the block, regenerate SDK types:\n\n```bash\nnpx @mercurjs/cli@latest codegen\n```\n\n## API Endpoints\n\n### Admin\n\n- `GET /admin/requests/:type` — List entities with request custom fields (filterable by `request_status`, `submitter_id`)\n- `GET /admin/requests/:type/:id` — Retrieve entity with request custom fields\n- `POST /admin/requests/:type/:id/accept` — Accept a request\n- `POST /admin/requests/:type/:id/reject` — Reject a request\n\nSupported `:type` values: `product_collection`, `product_category`, `product_type`, `product_tag`\n\n### Vendor\n\n- `GET /vendor/requests/product-collections` — List vendor's collection requests\n- `POST /vendor/requests/product-collections` — Create a collection request\n- `GET /vendor/requests/product-categories` — List vendor's category requests\n- `POST /vendor/requests/product-categories` — Create a category request\n- `GET /vendor/requests/product-types` — List vendor's type requests\n- `POST /vendor/requests/product-types` — Create a type request\n- `GET /vendor/requests/product-tags` — List vendor's tag requests\n- `POST /vendor/requests/product-tags` — Create a tag request",+ "docs": "## Prerequisites\n\nThis block requires the **Custom Fields module** (`@mercurjs/core-plugin/modules/custom-fields`). Make sure it is registered in your `medusa-config.ts`.\n\n## Configuration\n\nAdd request-related custom fields to the entities you want to support approval workflows for. Product already has a built-in `status` field, so you only need to configure custom fields for other entities.\n\nAdd these fields to your Custom Fields module options in `medusa-config.ts`:\n\n```ts\n{\n resolve: \"@mercurjs/core-plugin/modules/custom-fields\",\n options: {\n customFields: {\n ProductCollection: {\n request_status: {\n type: \"enum\",\n enum: [\"draft\", \"pending\", \"accepted\", \"rejected\"],\n defaultValue: \"draft\",\n },\n submitter_id: { type: \"string\", nullable: true },\n reviewer_id: { type: \"string\", nullable: true },\n reviewer_note: { type: \"text\", nullable: true },\n },\n // Add the same fields to other entities as needed:\n // ProductCategory, ProductType, ProductTag\n },\n },\n}\n```\n\n## Middlewares\n\nAdd the request middlewares to your `api/middlewares.ts`:\n\n```ts\nimport { defineMiddlewares } from \"@medusajs/medusa\";\nimport { adminRequestsMiddlewares } from \"./admin/requests/middlewares\";\nimport { vendorProductCollectionRequestsMiddlewares } from \"./vendor/requests/product-collections/middlewares\";\nimport { vendorProductCategoryRequestsMiddlewares } from \"./vendor/requests/product-categories/middlewares\";\nimport { vendorProductTypeRequestsMiddlewares } from \"./vendor/requests/product-types/middlewares\";\nimport { vendorProductTagRequestsMiddlewares } from \"./vendor/requests/product-tags/middlewares\";\n\nexport default defineMiddlewares({\n routes: [\n ...adminRequestsMiddlewares,\n ...vendorProductCollectionRequestsMiddlewares,\n ...vendorProductCategoryRequestsMiddlewares,\n ...vendorProductTypeRequestsMiddlewares,\n ...vendorProductTagRequestsMiddlewares,\n ],\n});\n```\n\nIf you already have a `middlewares.ts` file, merge the middleware imports and spread them into your existing `routes` array.\n\n## Database Migrations\n\nAfter updating the custom fields configuration, run migrations:\n\n```bash\nnpx medusa db:migrate\n```\n\n## Run codegen\n\nAfter installing the block, regenerate SDK types:\n\n```bash\nnpx @mercurjs/cli@latest codegen\n```\n\n## API Endpoints\n\n### Admin\n\n- `GET /admin/requests/:type` \u2014 List entities with request custom fields (filterable by `request_status`, `submitter_id`)\n- `GET /admin/requests/:type/:id` \u2014 Retrieve entity with request custom fields\n- `POST /admin/requests/:type/:id/accept` \u2014 Accept a request\n- `POST /admin/requests/:type/:id/reject` \u2014 Reject a request\n\nSupported `:type` values: `product_collection`, `product_category`, `product_type`, `product_tag`\n\n### Vendor\n\n- `GET /vendor/requests/product-collections` \u2014 List vendor's collection requests\n- `POST /vendor/requests/product-collections` \u2014 Create a collection request\n- `GET /vendor/requests/product-categories` \u2014 List vendor's category requests\n- `POST /vendor/requests/product-categories` \u2014 Create a category request\n- `GET /vendor/requests/product-types` \u2014 List vendor's type requests\n- `POST /vendor/requests/product-types` \u2014 Create a type request\n- `GET /vendor/requests/product-tags` \u2014 List vendor's tag requests\n- `POST /vendor/requests/product-tags` \u2014 Create a tag request","files": [{"path": "requests/types/index.ts",@@ -979,6 +979,84 @@"api","vendor"]+ },+ {+ "name": "meilisearch",+ "description": "Opt-in Meilisearch search block for multi-vendor marketplaces with real-time seller-aware indexing, seller lifecycle sync, and injection-safe smart filtering.",+ "dependencies": [+ "meilisearch"+ ],+ "registryDependencies": [],+ "docs": "## Prerequisites\n\nInstall and run a Meilisearch instance:\n\n```bash\ndocker run -d -p 7700:7700 getmeili/meilisearch\n```\n\n## Environment Variables\n\nAdd to your `.env` file:\n\n```env\nMEILISEARCH_HOST=http://localhost:7700\nMEILISEARCH_API_KEY=your_master_key_here\n```\n\n## Module Configuration\n\nAdd to your `medusa-config.ts`:\n\n```ts\nexport default defineConfig({\n modules: [\n {\n resolve: './modules/meilisearch',\n options: {\n host: process.env.MEILISEARCH_HOST,\n apiKey: process.env.MEILISEARCH_API_KEY,\n },\n },\n ],\n})\n```\n\n## Middlewares\n\nAdd to your `api/middlewares.ts`:\n\n```ts\nimport { defineMiddlewares } from \"@medusajs/medusa\";\nimport { allMeilisearchMiddlewares } from \"./meilisearch/api/middlewares\";\n\nexport default defineMiddlewares({\n routes: [...allMeilisearchMiddlewares],\n});\n```\n\n## Initial Sync\n\nAfter starting the server, trigger a full re-index:\n\n```bash\ncurl -X POST http://localhost:9000/admin/meilisearch/sync \\\n -H \"Authorization: Bearer YOUR_ADMIN_TOKEN\"\n```\n\n## Search\n\n```bash\ncurl -X POST http://localhost:9000/store/meilisearch/products \\\n -H \"Content-Type: application/json\" \\\n -H \"x-publishable-api-key: YOUR_KEY\" \\\n -d '{\"query\": \"shoes\", \"filters\": {\"price_min\": 50, \"price_max\": 200}}'\n```",+ "files": [+ {+ "path": "meilisearch/modules/meilisearch/index.ts",+ "type": "registry:api"+ },+ {+ "path": "meilisearch/modules/meilisearch/service.ts",+ "type": "registry:api"+ },+ {+ "path": "meilisearch/modules/meilisearch/types.ts",+ "type": "registry:api"+ },+ {+ "path": "meilisearch/subscribers/utils/meilisearch-product.ts",+ "type": "registry:api"+ },+ {+ "path": "meilisearch/subscribers/meilisearch-product-events-bridge.ts",+ "type": "registry:api"+ },+ {+ "path": "meilisearch/subscribers/meilisearch-products-changed.ts",+ "type": "registry:api"+ },+ {+ "path": "meilisearch/subscribers/meilisearch-products-deleted.ts",+ "type": "registry:api"+ },+ {+ "path": "meilisearch/subscribers/meilisearch-seller-suspended.ts",+ "type": "registry:api"+ },+ {+ "path": "meilisearch/subscribers/meilisearch-seller-unsuspended.ts",+ "type": "registry:api"+ },+ {+ "path": "meilisearch/workflows/meilisearch/steps/sync-meilisearch-products.ts",+ "type": "registry:api"+ },+ {+ "path": "meilisearch/workflows/meilisearch/workflows/sync-meilisearch.ts",+ "type": "registry:api"+ },+ {+ "path": "meilisearch/api/middlewares.ts",+ "type": "registry:api"+ },+ {+ "path": "meilisearch/api/admin/meilisearch/route.ts",+ "type": "registry:api"+ },+ {+ "path": "meilisearch/api/store/meilisearch/products/search/validators.ts",+ "type": "registry:api"+ },+ {+ "path": "meilisearch/api/store/meilisearch/products/search/middlewares.ts",+ "type": "registry:api"+ },+ {+ "path": "meilisearch/api/store/meilisearch/products/search/route.ts",+ "type": "registry:api"+ }+ ],+ "categories": [+ "search"+ ]}]}\ No newline at end of filediff --git a/packages/registry/src/meilisearch/PLUGIN.md b/packages/registry/src/meilisearch/PLUGIN.mdnew file mode 100644index 000000000..2098e2b6e--- /dev/null+++ b/packages/registry/src/meilisearch/PLUGIN.md@@ -0,0 +1,297 @@+# Meilisearch Search Block for Mercur++## What It Does++The Meilisearch Search block adds fast, full-text product search to your Mercur marketplace. Shoppers can find products instantly by typing keywords, filtering by category, price range, or seller — all with results appearing in milliseconds.++This is an **opt-in block**: it only activates when you install it and connect a Meilisearch instance. Your marketplace works normally without it.++## Key Features++### Instant Product Search+Shoppers type a query and see matching products immediately. Results are ranked by relevance — the best matches appear first. Typos are handled gracefully ("runnig shoes" still finds "running shoes").++### Smart Filtering+Shoppers can narrow results by:+- **Category** — browse within a specific product category+- **Price range** — set minimum and/or maximum price+- **Seller** — view products from a specific store++Filters combine naturally: "shoes under $100 from ACME Store" works as expected.++### Seller Moderation Built In+When a marketplace admin suspends a seller, that seller's products are **automatically hidden** from search results. No manual cleanup required. When the seller is reinstated, their products reappear in search automatically.++### Real-Time Product Updates+The search index stays in sync with your product catalog:+- New products appear in search within seconds of being published+- Updated product details (title, price, description) are reflected immediately+- Deleted or unpublished products are removed from search automatically+- Seller status changes (suspension/reinstatement) trigger automatic re-indexing++### Admin Dashboard Tools+Marketplace administrators get two tools:+- **Health check** — see whether the search engine is running and how many products are indexed+- **Manual re-sync** — trigger a full re-index of all products if the index ever gets out of sync++## How Shoppers Experience It++1. A shopper visits your storefront and types a search query+2. Results appear ranked by relevance, showing product title, image, price, and seller+3. The shopper can apply filters to narrow results (category, price, seller)+4. Pagination lets them browse through large result sets+5. Only products from active, approved sellers appear — suspended seller products are never shown++## What You Need++### Meilisearch Instance+Meilisearch is an open-source search engine. You need a running instance accessible from your Mercur server.++**Options:**+- **Meilisearch Cloud** (meilisearch.com) — managed hosting, easiest setup+- **Self-hosted** — run Meilisearch on your own infrastructure (Docker, VPS, etc.)++You will need:+- The Meilisearch **host URL** (e.g., `https://search.yourmarketplace.com`)+- A Meilisearch **API key** (the master key or an admin key)++### Mercur Marketplace+A running Mercur marketplace with products and sellers already configured.++---++## Integration Guide++### Step 1: Install the Block++From your Mercur project root, run:++```bash+npx @mercurjs/cli add meilisearch+```++This copies the block source files into your project:+- `src/modules/meilisearch/` — module service, types, and index configuration+- `src/subscribers/` — event handlers for product/seller sync+- `src/api/store/meilisearch/` — store search endpoint+- `src/api/admin/meilisearch/` — admin status and sync endpoints+- `src/workflows/meilisearch/` — full re-index workflow++The CLI also installs the `meilisearch` npm package as a dependency.++### Step 2: Register the Module++Open your `medusa-config.ts` and add the meilisearch module to the `modules` array. Use a conditional so the module only loads when environment variables are set:++```typescript+modules: [+ // ... existing modules+ ...(process.env.MEILISEARCH_HOST ? [{+ resolve: './modules/meilisearch',+ options: {+ host: process.env.MEILISEARCH_HOST,+ apiKey: process.env.MEILISEARCH_API_KEY,+ },+ }] : []),+]+```++### Step 3: Register Middlewares++Open your `src/api/middlewares.ts` and add the meilisearch store middlewares:++```typescript+import { defineMiddlewares } from "@medusajs/medusa"+import { meilisearchStoreMiddlewares } from './store/meilisearch/products/search/middlewares'++export default defineMiddlewares({+ routes: [+ // ... existing routes+ ...meilisearchStoreMiddlewares,+ ],+})+```++### Step 4: Set Environment Variables++Add these to your `.env` file:++```env+MEILISEARCH_HOST=http://localhost:7700+MEILISEARCH_API_KEY=your_master_key_here+```++For **local development** with Docker, you can start a Meilisearch instance:++```bash+docker run -d \+ --name meilisearch \+ -p 7700:7700 \+ -e MEILI_MASTER_KEY=your_master_key_here \+ -e MEILI_ENV=development \+ -v meilisearch_data:/meili_data \+ getmeili/meilisearch:v1.12+```++### Step 5: Restart and Sync++1. Restart your Medusa server:+ ```bash+ npm run dev+ ```++2. Trigger an initial sync to populate the search index. Use the admin endpoint:+ ```bash+ curl -X POST http://localhost:9000/admin/meilisearch \+ -H "Authorization: Bearer YOUR_ADMIN_TOKEN"+ ```++ Or use the admin dashboard if available.++After the initial sync, the index stays up to date automatically via event subscribers.++---++## API Reference++### Store Endpoints++#### `POST /store/meilisearch/products/search`++Search products. Requires `x-publishable-api-key` header.++**Request body:**++| Field | Type | Default | Description |+|-------|------|---------|-------------|+| `query` | string | `""` | Search query text |+| `page` | number | `1` | Page number (1-based) |+| `hitsPerPage` | number | `12` | Results per page (1-100) |+| `filters.categories` | string[] | — | Filter by category IDs |+| `filters.price_min` | number | — | Minimum price |+| `filters.price_max` | number | — | Maximum price |+| `filters.seller_handle` | string | — | Filter by seller handle |+| `currency_code` | string | — | 3-letter currency for calculated prices |+| `region_id` | string | — | Region ID for calculated prices |++**Response:**++```json+{+ "products": [+ {+ "id": "prod_123",+ "title": "Running Shoes",+ "handle": "running-shoes",+ "description": "Great shoes",+ "thumbnail": "https://...",+ "status": "published",+ "variants": [...],+ "categories": [...],+ "seller": { "id": "slr_1", "name": "ACME", "handle": "acme", "status": "active" }+ }+ ],+ "totalHits": 42,+ "page": 1,+ "totalPages": 4,+ "hitsPerPage": 12,+ "processingTimeMs": 5,+ "query": "shoes"+}+```++**Important:** The `seller.status = "active"` filter is always enforced server-side (FR-003). Suspended seller products never appear in results regardless of what filters the client sends.++**Pagination:** Meilisearch uses 1-based page numbering. Page 1 is the first page of results.++### Admin Endpoints++Both require admin authentication.++#### `GET /admin/meilisearch`++Returns index health and document count.++```json+{+ "host": "http://localhost:7700",+ "index": "products",+ "documentCount": 42,+ "isHealthy": true+}+```++#### `POST /admin/meilisearch`++Triggers a full re-index of all published products.++```json+{+ "message": "Sync in progress"+}+```++---++## Storefront Integration++Your storefront should call the search endpoint using the Medusa JS SDK:++```typescript+import Medusa from "@medusajs/js-sdk"++const sdk = new Medusa({+ baseUrl: "http://localhost:9000",+ publishableKey: "pk_your_key_here",+})++// Search products+const results = await sdk.client.fetch("/store/meilisearch/products/search", {+ method: "POST",+ body: {+ query: "shoes",+ page: 1,+ hitsPerPage: 12,+ filters: {+ price_max: 100,+ },+ },+})+```++**Do not use raw `fetch()`** — the SDK automatically includes the required `x-publishable-api-key` header.++For autocomplete/typeahead, use a debounced version of the same endpoint with a smaller `hitsPerPage` (e.g., 5).++---++## Security and Privacy++- Search results **never** include products from suspended sellers — this is enforced server-side and cannot be bypassed by the storefront+- Filter values are validated and sanitized — shoppers cannot inject malicious search filters+- The store search endpoint requires a publishable API key+- Admin endpoints require admin authentication+- The Meilisearch API key is stored server-side and never exposed to shoppers++## Frequently Asked Questions++**Does this replace the default Medusa product listing?**+No. The default product listing continues to work. Meilisearch provides an additional, faster search experience. You can use both.++**What happens if Meilisearch goes down?**+Search queries will return errors, but the rest of your marketplace (checkout, orders, admin) continues working normally. The admin health check endpoint lets you monitor availability.++**How many products can it handle?**+Meilisearch is designed for millions of documents. Performance depends on your Meilisearch instance size, but typical marketplaces with thousands of products will see sub-100ms search times.++**Does it support multiple languages?**+Yes. Meilisearch has built-in support for many languages and handles accents, diacritics, and CJK characters.++**What data is sent to Meilisearch?**+Product titles, descriptions, handles, categories, tags, variant details, prices, and seller information (name, handle, status). No customer data or order data is indexed.++**Can I customize which fields are searchable?**+The block configures sensible defaults (title, description, handle, categories, tags, seller name are searchable; price and category ID are filterable). You can adjust the settings in `src/modules/meilisearch/service.ts` in the `ensureSettings()` method.++**Is there a cost?**+Meilisearch itself is open source and free to self-host. Meilisearch Cloud offers managed hosting with paid plans. The Mercur block is free.diff --git a/packages/registry/src/meilisearch/TESTING.md b/packages/registry/src/meilisearch/TESTING.mdnew file mode 100644index 000000000..f2d88e459--- /dev/null+++ b/packages/registry/src/meilisearch/TESTING.md@@ -0,0 +1,237 @@+# Meilisearch Block — Testing Guide++## Overview++The Meilisearch block provides full-text product search for multi-vendor Mercur marketplaces. This document covers the test suite architecture, how to run tests, and how to extend coverage.++## Test Architecture++Tests are organized into two tiers:++### Unit Tests (`packages/registry/src/meilisearch/__tests__/`)++Unit tests run in isolation with mocked dependencies. No Meilisearch instance or database required.++| File | Coverage |+|------|----------|+| `service.unit.spec.ts` | `MeilisearchModuleService` — constructor validation, `batchUpsert`, `batchDelete`, `search`, `getStatus`, `ensureSettings` |+| `meilisearch-product.unit.spec.ts` | `filterProductsByStatus` — published/draft/deleted splitting; `findAndTransformMeilisearchProducts` — N+1 prevention (single `query.graph` call), seller field inclusion, Zod validation, options flattening |+| `store-route.unit.spec.ts` | `POST /store/meilisearch/products/search` route handler — **FR-003** seller status filter enforcement, all filter types, response shape, pagination, relevance ordering |+| `subscribers.unit.spec.ts` | All 5 subscribers — event routing, error handling (FR-012), seller suspension/unsuspension product re-indexing, chunking for >100 products |++### Integration Tests (`integration-tests/http/meilisearch/`)++Integration tests use `medusaIntegrationTestRunner` from `@medusajs/test-utils` to spin up a full Medusa server with a real database. The `meilisearch` npm package is mocked via `jest.mock()` so no running Meilisearch instance is needed.++| File | Coverage |+|------|----------|+| `store/meilisearch.spec.ts` | End-to-end store search — product hydration from DB, seller status filtering, category/price/seller filters, validation errors, publishable API key requirement |+| `admin/meilisearch.spec.ts` | Admin endpoints — `GET /admin/meilisearch` status, `POST /admin/meilisearch` sync trigger, authentication enforcement |++## Prerequisites++### Unit Tests++```bash+cd packages/registry+bun install # installs jest, @swc/jest, meilisearch+```++### Integration Tests++```bash+cd integration-tests+bun install # installs meilisearch + test-utils++# Requires a running PostgreSQL database+# DATABASE_URL must be set (see integration-tests/.env or .env.test)+```++## Running Tests++### Unit Tests++```bash+# Run all meilisearch unit tests+cd packages/registry+bun test++# Run a specific test file+bun test -- --testPathPattern=service++# Run with verbose output+bun test -- --verbose+```++### Integration Tests++```bash+cd integration-tests++# Run only meilisearch integration tests (sets env vars automatically)+bun run test:integration:meilisearch++# Or manually:+TEST_TYPE=integration:http \+ MEILISEARCH_HOST=http://localhost:7700 \+ MEILISEARCH_API_KEY=masterKey \+ bun jest --runInBand --forceExit --testPathPattern=meilisearch+```++The `MEILISEARCH_HOST` env var activates the meilisearch module in `medusa-config.ts`. No real Meilisearch instance is needed since the client is mocked.++## Integration Test Infrastructure++The integration tests simulate the block being "installed" in a Medusa project via pass-through files:++```+integration-tests/+ src/+ api/+ middlewares.ts # registers body validation+ store/meilisearch/products/search/route.ts # re-exports POST handler+ admin/meilisearch/route.ts # re-exports GET + POST handlers+ medusa-config.ts # conditionally loads meilisearch module+```++These pass-through files import directly from `packages/registry/src/meilisearch/` using relative paths. This approach avoids duplicating code while simulating a real installation.++## Critical Test Scenarios++### FR-003: Suspended Seller Exclusion++The store search route **always** prepends `seller.status = "active"` to the Meilisearch filter string. This is the single enforcement point that prevents suspended-seller products from appearing in search results.++Tested in:+- `store-route.unit.spec.ts` — verifies the filter string construction directly+- `store/meilisearch.spec.ts` — verifies via HTTP integration with real middleware++### FR-012: Error Handling++All 5 subscriber handlers wrap their bodies in `try/catch`, log errors with `logger.error` including relevant entity IDs, and re-throw. Every handler has a dedicated `(FR-012)` test.++### N+1 Prevention++`findAndTransformMeilisearchProducts` includes `seller.id`, `seller.handle`, `seller.name`, `seller.status` in its initial `query.graph` call. Tested with a `toHaveBeenCalledTimes(1)` assertion to guarantee no secondary per-product seller query.++## Mocking Strategy++### Unit Tests++- **`meilisearch` npm package**: Mocked via `jest.mock('meilisearch')` at module level. Returns a mock `MeiliSearch` class whose `.index()` method returns mock `addDocuments`, `deleteDocuments`, `search`, `getStats`, `updateSettings` functions.+- **Medusa container**: Constructed via `makeContainer()` factories that return mock `resolve()` functions mapping service keys to mock objects.+- **`meilisearch-product` utilities**: Mocked in `subscribers.unit.spec.ts` to isolate subscriber logic from transformer logic.++### Integration Tests++- **`meilisearch` npm package**: Same `jest.mock('meilisearch')` approach. Since jest hoists mock declarations before imports, the mock is in place when `MeilisearchModuleService` is instantiated during Medusa server startup.+- **Database**: Real PostgreSQL via `medusaIntegrationTestRunner`. Products, sellers, and users are created in `beforeEach` hooks.++## File Structure++```+packages/registry/+ jest.config.cjs # Jest config for unit tests+ src/meilisearch/+ __tests__/+ service.unit.spec.ts # MeilisearchModuleService tests+ meilisearch-product.unit.spec.ts # Transformer utility tests+ store-route.unit.spec.ts # Store route handler tests+ subscribers.unit.spec.ts # All subscriber tests+ modules/meilisearch/+ service.ts # MeilisearchModuleService (under test)+ types.ts # Types, Zod validators, events enum+ index.ts # Module registration+ api/+ admin/meilisearch/route.ts # Admin GET + POST handlers+ store/meilisearch/products/search/+ route.ts # Store POST handler+ validators.ts # Zod request schema+ middlewares.ts # Body validation middleware+ middlewares.ts # Middleware re-export+ subscribers/+ meilisearch-product-events-bridge.ts # Routes product events to internal events+ meilisearch-products-changed.ts # Upserts/deletes products on change+ meilisearch-products-deleted.ts # Deletes products from index+ meilisearch-seller-suspended.ts # Re-indexes seller's products on suspend+ meilisearch-seller-unsuspended.ts # Re-indexes seller's products on unsuspend+ utils/meilisearch-product.ts # Product transformer + status filter+ workflows/meilisearch/+ steps/sync-meilisearch-products.ts # Full re-index step+ workflows/sync-meilisearch.ts # Sync workflow composition++integration-tests/+ http/meilisearch/+ store/meilisearch.spec.ts # Store search integration tests+ admin/meilisearch.spec.ts # Admin endpoint integration tests+ src/api/ # Pass-through route files+ medusa-config.ts # Updated with conditional meilisearch module+```++## Adding New Tests++### Adding a Unit Test++1. Create the file in `packages/registry/src/meilisearch/__tests__/` with the `.unit.spec.ts` suffix+2. Mock external dependencies (`meilisearch`, Medusa container) at module level+3. Import the module under test using relative paths+4. Run with `cd packages/registry && bun test`++### Adding an Integration Test++1. Create the file in `integration-tests/http/meilisearch/` matching the `**/http/**/*.spec.ts` pattern+2. Add `jest.mock('meilisearch', ...)` at the top of the file (hoisted before server startup)+3. Use `medusaIntegrationTestRunner` with `{ testSuite: ({ getContainer, api, dbConnection }) => { ... } }`+4. Create test data (sellers, products) in `beforeEach` using the helpers in `integration-tests/helpers/`+5. Run with `cd integration-tests && bun run test:integration:meilisearch`++### If You Add a New Subscriber or Route++- Add the subscriber pass-through file in `integration-tests/src/subscribers/` (re-export from registry)+- Add the route pass-through file in `integration-tests/src/api/` (re-export from registry)+- Ensure corresponding unit tests cover error handling (FR-012)++## CI Integration++Add these jobs to your CI pipeline:++```yaml+# Unit tests (fast, no database)+meilisearch-unit:+ runs-on: ubuntu-latest+ steps:+ - uses: actions/checkout@v4+ - uses: oven-sh/setup-bun@v2+ - run: bun install+ - run: cd packages/registry && bun test++# Integration tests (requires PostgreSQL)+meilisearch-integration:+ runs-on: ubuntu-latest+ services:+ postgres:+ image: postgres:16+ env:+ POSTGRES_PASSWORD: postgres+ POSTGRES_DB: medusa_test+ ports: ['5432:5432']+ steps:+ - uses: actions/checkout@v4+ - uses: oven-sh/setup-bun@v2+ - run: bun install+ - run: cd integration-tests && bun run test:integration:meilisearch+ env:+ DATABASE_URL: postgres://postgres:postgres@localhost:5432/medusa_test+ MEILISEARCH_HOST: http://localhost:7700+ MEILISEARCH_API_KEY: masterKey+```++## Troubleshooting++| Symptom | Cause | Fix |+|---------|-------|-----|+| `Cannot find module 'meilisearch'` | Dependencies not installed | Run `bun install` in `packages/registry` |+| `Cannot find module '@medusajs/framework'` | Registry dependencies not linked | Run `bun install` from monorepo root |+| Integration tests hang | Database not available | Ensure PostgreSQL is running and `DATABASE_URL` is set |+| `MEILISEARCH_MODULE not found in container` | Env vars not set for integration tests | Use `bun run test:integration:meilisearch` or set `MEILISEARCH_HOST` manually |+| Tests pass locally but fail in CI | Missing `--forceExit` flag | Use `--runInBand --forceExit` flags |diff --git a/packages/registry/src/meilisearch/TEST_RESULTS.md b/packages/registry/src/meilisearch/TEST_RESULTS.mdnew file mode 100644index 000000000..fa532d773--- /dev/null+++ b/packages/registry/src/meilisearch/TEST_RESULTS.md@@ -0,0 +1,169 @@+# Meilisearch Block — Test Results++**Date:** 2026-03-25+**Environment:** macOS, Meilisearch v1.12, Medusa v2.13.4, bun 1.3.11++---++## Unit Tests++**Command:** `cd packages/registry && npx jest --config jest.config.cjs`+**Result:** 4 suites, 57 tests, all passing++### service.unit.spec.ts (7 tests)++| # | Test | Status |+|---|------|--------|+| 1 | Constructor throws when host is missing | PASS |+| 2 | Constructor throws when apiKey is missing | PASS |+| 3 | Constructor throws listing both when both are missing | PASS |+| 4 | Constructor creates service when both options are provided | PASS |+| 5 | getHost returns the configured host string | PASS |+| 6 | batchUpsert calls addDocuments on the products index | PASS |+| 7 | batchUpsert is a no-op for an empty array | PASS |+| 8 | batchDelete calls deleteDocuments on the products index | PASS |+| 9 | batchDelete is a no-op for an empty array | PASS |+| 10 | search returns structured result from meilisearch hit list | PASS |+| 11 | search falls back to estimatedTotalHits when totalHits is absent | PASS |+| 12 | getStatus returns documentCount and isHealthy:true on success | PASS |+| 13 | getStatus returns isHealthy:false when meilisearch is unreachable | PASS |+| 14 | ensureSettings applies searchable, filterable, and sortable attributes | PASS |++### store-route.unit.spec.ts (10 tests)++| # | Test | Status |+|---|------|--------|+| 1 | Always sends seller.status = "active" in the filter string (FR-003) | PASS |+| 2 | Cannot bypass seller filter even when no other filters are provided | PASS |+| 3 | Appends category filter after the mandatory seller filter | PASS |+| 4 | Appends price_min filter | PASS |+| 5 | Appends price_max filter | PASS |+| 6 | Appends seller_handle filter | PASS |+| 7 | Combines all filters with AND | PASS |+| 8 | Returns empty products array when meilisearch returns no hits | PASS |+| 9 | Hydrates products from DB and returns them in hit order | PASS |+| 10 | Passes pagination params to meilisearch | PASS |+| 11 | Passes attributesToRetrieve: ["id"] to avoid over-fetching | PASS |+| 12 | Does not call query.graph when meilisearch returns empty hits | PASS |++### meilisearch-product.unit.spec.ts (9 tests)++| # | Test | Status |+|---|------|--------|+| 1 | filterProductsByStatus splits ids into published and other (draft) | PASS |+| 2 | filterProductsByStatus puts proposed and rejected in other | PASS |+| 3 | filterProductsByStatus includes missing DB ids in other (soft-deleted) | PASS |+| 4 | filterProductsByStatus returns empty arrays for empty id list | PASS |+| 5 | filterProductsByStatus resolves the QUERY key from the container | PASS |+| 6 | findAndTransformMeilisearchProducts makes exactly ONE query.graph call (no N+1) | PASS |+| 7 | findAndTransformMeilisearchProducts includes seller fields in query.graph | PASS |+| 8 | findAndTransformMeilisearchProducts returns valid MeilisearchProduct-shaped docs | PASS |+| 9 | findAndTransformMeilisearchProducts flattens options into key/value records | PASS |+| 10 | findAndTransformMeilisearchProducts adds variant option key/values onto variant | PASS |+| 11 | findAndTransformMeilisearchProducts throws Zod error when required field missing | PASS |+| 12 | findAndTransformMeilisearchProducts applies status:published filter | PASS |++### subscribers.unit.spec.ts (17 tests)++| # | Test | Status |+|---|------|--------|+| 1 | Bridge emits PRODUCTS_CHANGED for product.created | PASS |+| 2 | Bridge emits PRODUCTS_CHANGED for product.updated | PASS |+| 3 | Bridge emits PRODUCTS_DELETED for product.deleted | PASS |+| 4 | Bridge emits PRODUCTS_CHANGED for product.product.created | PASS |+| 5 | Bridge emits PRODUCTS_CHANGED for product.product.updated | PASS |+| 6 | Bridge emits PRODUCTS_DELETED for product.product.deleted | PASS |+| 7 | Bridge logs error and rethrows when eventBus.emit fails (FR-012) | PASS |+| 8 | ProductsChanged calls batchUpsert for published products | PASS |+| 9 | ProductsChanged calls batchDelete for non-published products | PASS |+| 10 | ProductsChanged logs error and rethrows on failure (FR-012) | PASS |+| 11 | ProductsChanged skips batchUpsert when no published products | PASS |+| 12 | ProductsDeleted calls batchDelete with provided ids | PASS |+| 13 | ProductsDeleted logs error and rethrows on failure (FR-012) | PASS |+| 14 | SellerSuspended queries seller products and emits PRODUCTS_CHANGED | PASS |+| 15 | SellerSuspended emits in chunks of 100 for many products | PASS |+| 16 | SellerSuspended does nothing when seller has no products | PASS |+| 17 | SellerSuspended logs error and rethrows on failure (FR-012) | PASS |+| 18 | SellerUnsuspended emits PRODUCTS_CHANGED for seller products | PASS |+| 19 | SellerUnsuspended logs error and rethrows on failure (FR-012) | PASS |++---++## Manual Endpoint Tests++**Server:** `http://localhost:9000` (mercur backend with meilisearch block installed)+**Meilisearch:** `http://localhost:7700` (Docker, 31 indexed products, 13 active sellers)+**All 30 tests passed.**++### Search — Basic++| # | Test | Input | Result | Status |+|---|------|-------|--------|--------|+| 1 | Empty query (browse all) | `query: ""` | 31 totalHits, 3 products (hitsPerPage: 3) | PASS |+| 2 | Keyword search | `query: "glass"` | 1 hit: "Ball Glass" | PASS |+| 3 | Typo tolerance | `query: "glas"` | 1 hit: "Ball Glass" | PASS |+| 28 | Relevance ordering | `query: "jacket"` | 5 hits, jacket titles ranked first | PASS |+| 30 | Query + filter combined | `query: "stag", seller_handle: red` | 2 hits | PASS |++### Pagination++| # | Test | Input | Result | Status |+|---|------|-------|--------|--------|+| 4 | Page 1 | `page: 1, hitsPerPage: 5` | 5 products, page 1 of 7 | PASS |+| 5 | Page 2 | `page: 2, hitsPerPage: 5` | 5 products, page 2 of 7 | PASS |+| 6 | Last page | `page: 7, hitsPerPage: 5` | 1 product, page 7 of 7 | PASS |+| 7 | Beyond last page | `page: 99` | 0 products, page 99 | PASS |+| 24 | Empty body (defaults) | `{}` | 12 products, page 1, hitsPerPage 12 | PASS |+| 29 | Max hitsPerPage (100) | `hitsPerPage: 100` | 31 products, 1 page | PASS |++### Price Range Filters++| # | Test | Input | Result | Status |+|---|------|-------|--------|--------|+| 8 | Min price only | `price_min: 5000` | 15 products | PASS |+| 9 | Max price only | `price_max: 1000` | 0 products | PASS |+| 10 | Min + max price | `price_min: 2000, price_max: 5000` | 15 products | PASS |+| 11 | No results range | `price_min: 999999` | 0 products | PASS |++### Category Filters++| # | Test | Input | Result | Status |+|---|------|-------|--------|--------|+| 14 | Single category | `categories: ["pcat_...Clothing"]` | 9 products | PASS |+| 15 | Non-existent category | `categories: ["pcat_nonexistent"]` | 0 products | PASS |+| 26 | Multiple categories | `categories: ["...Clothing", "...Kitchen & Dining"]` | 13 products (both categories) | PASS |++### Seller Handle Filter++| # | Test | Input | Result | Status |+|---|------|-------|--------|--------|+| 12 | Valid seller | `seller_handle: "red"` | 8 products, all from that seller | PASS |+| 13 | Non-existent seller | `seller_handle: "does-not-exist"` | 0 products | PASS |++### Combined Filters++| # | Test | Input | Result | Status |+|---|------|-------|--------|--------|+| 16 | Category + price range | `categories + price_min + price_max` | 6 products | PASS |+| 17 | Query + seller + price | `query: "jacket", seller + price_max` | 1 product: "Waterproof Jacket" | PASS |+| 18 | All filters at once | `category + price_min + price_max + seller` | 1 product | PASS |++### Validation & Security++| # | Test | Input | Expected | Status |+|---|------|-------|----------|--------|+| 19 | hitsPerPage exceeds max | `hitsPerPage: 9999` | HTTP 400 | PASS |+| 20 | Negative price | `price_min: -5` | HTTP 400 | PASS |+| 21 | Page below min | `page: 0` | HTTP 400 | PASS |+| 22 | Missing publishable API key | No header | HTTP 400 | PASS |+| 23 | Invalid publishable API key | `pk_invalid_key` | HTTP 400 | PASS |++### Product Hydration++| # | Test | Verification | Status |+|---|------|-------------|--------|+| 25 | Seller data present | seller.id, seller.name, seller.handle, seller.status all populated | PASS |+| 25 | Variants with prices | variants array non-empty, prices present | PASS |+| 25 | Categories present | categories array non-empty | PASS |+| 25 | Images present | images array non-empty | PASS |+diff --git a/packages/registry/src/meilisearch/__tests__/meilisearch-product.unit.spec.ts b/packages/registry/src/meilisearch/__tests__/meilisearch-product.unit.spec.tsnew file mode 100644index 000000000..c811ddea5--- /dev/null+++ b/packages/registry/src/meilisearch/__tests__/meilisearch-product.unit.spec.ts@@ -0,0 +1,207 @@+import {+ filterProductsByStatus,+ findAndTransformMeilisearchProducts,+} from '../subscribers/utils/meilisearch-product'+import { ContainerRegistrationKeys } from '@medusajs/framework/utils'++// ─── Container factory ────────────────────────────────────────────────────────++function makeContainer(queryGraphResult: any[]) {+ // Deep clone to prevent test pollution — findAndTransformMeilisearchProducts mutates in-place+ const cloned = JSON.parse(JSON.stringify(queryGraphResult))+ const mockGraph = jest.fn().mockResolvedValue({ data: cloned })+ return {+ resolve: jest.fn().mockReturnValue({ graph: mockGraph }),+ _graph: mockGraph,+ }+}++// ─── filterProductsByStatus ───────────────────────────────────────────────────++describe('filterProductsByStatus', () => {+ it('splits ids into published and other (draft)', async () => {+ const container = makeContainer([+ { id: 'prod_1', status: 'published' },+ { id: 'prod_2', status: 'draft' },+ ]) as any++ const result = await filterProductsByStatus(container, ['prod_1', 'prod_2'])++ expect(result.published).toEqual(['prod_1'])+ expect(result.other).toContain('prod_2')+ })++ it('puts proposed and rejected statuses in other', async () => {+ const container = makeContainer([+ { id: 'prod_1', status: 'proposed' },+ { id: 'prod_2', status: 'rejected' },+ ]) as any++ const result = await filterProductsByStatus(container, ['prod_1', 'prod_2'])++ expect(result.published).toHaveLength(0)+ expect(result.other).toEqual(expect.arrayContaining(['prod_1', 'prod_2']))+ })++ it('includes ids not found in DB in other (soft-deleted / removed)', async () => {+ const container = makeContainer([+ { id: 'prod_1', status: 'published' },+ // prod_ghost is missing from DB response+ ]) as any++ const result = await filterProductsByStatus(container, ['prod_1', 'prod_ghost'])++ expect(result.published).toEqual(['prod_1'])+ expect(result.other).toContain('prod_ghost')+ })++ it('returns empty arrays when given an empty id list', async () => {+ const container = makeContainer([]) as any+ const result = await filterProductsByStatus(container, [])++ expect(result.published).toHaveLength(0)+ expect(result.other).toHaveLength(0)+ })++ it('resolves the QUERY key from the container', async () => {+ const container = makeContainer([]) as any+ await filterProductsByStatus(container, [])++ expect(container.resolve).toHaveBeenCalledWith(ContainerRegistrationKeys.QUERY)+ })+})++// ─── findAndTransformMeilisearchProducts ─────────────────────────────────────++const baseVariant = {+ id: 'var_1',+ title: 'Default',+ sku: null,+ barcode: null,+ ean: null,+ allow_backorder: false,+ manage_inventory: true,+ weight: null,+ length: null,+ height: null,+ width: null,+ variant_rank: 0,+ options: [+ {+ id: 'opt_val_1',+ value: 'S',+ option: { id: 'opt_1', title: 'Size' },+ },+ ],+ prices: [+ {+ id: 'price_1',+ currency_code: 'usd',+ amount: 49.99,+ min_quantity: null,+ max_quantity: null,+ rules_count: 0,+ },+ ],+}++const baseProduct = {+ id: 'prod_1',+ title: 'Running Shoes',+ handle: 'running-shoes',+ subtitle: null,+ description: 'Great shoes',+ thumbnail: null,+ status: 'published',+ categories: [{ id: 'cat_1', name: 'Footwear' }],+ tags: [{ value: 'sports' }],+ collection: null,+ type: null,+ images: [],+ options: [+ {+ title: 'Size',+ values: [{ value: 'S' }, { value: 'M' }],+ },+ ],+ variants: [baseVariant],+ seller: {+ id: 'sel_1',+ handle: 'acme-store',+ name: 'ACME',+ status: 'active',+ },+}++describe('findAndTransformMeilisearchProducts', () => {+ it('makes exactly ONE query.graph call (no N+1)', async () => {+ const container = makeContainer([baseProduct]) as any++ await findAndTransformMeilisearchProducts(container, ['prod_1'])++ expect(container._graph).toHaveBeenCalledTimes(1)+ })++ it('includes seller fields in the single query.graph call', async () => {+ const container = makeContainer([baseProduct]) as any++ await findAndTransformMeilisearchProducts(container, ['prod_1'])++ const callArgs = container._graph.mock.calls[0][0]+ expect(callArgs.fields).toEqual(+ expect.arrayContaining(['seller.id', 'seller.handle', 'seller.name', 'seller.status'])+ )+ })++ it('returns valid MeilisearchProduct-shaped documents', async () => {+ const container = makeContainer([baseProduct]) as any++ const result = await findAndTransformMeilisearchProducts(container, ['prod_1'])++ expect(result).toHaveLength(1)+ const doc = result[0]!+ expect(doc.id).toBe('prod_1')+ expect(doc.title).toBe('Running Shoes')+ expect(doc.seller).toMatchObject({ id: 'sel_1', handle: 'acme-store', status: 'active' })+ })++ it('flattens options into key/value records', async () => {+ const container = makeContainer([{ ...baseProduct }]) as any++ const result = await findAndTransformMeilisearchProducts(container, ['prod_1'])+ const doc = result[0]!++ expect(Array.isArray(doc.options)).toBe(true)+ // Each option entry is a record like { size: "S" }+ const optionValues = (doc.options as any[]).map((o: any) => Object.values(o)[0])+ expect(optionValues).toContain('S')+ expect(optionValues).toContain('M')+ })++ it('adds variant option key/values onto the variant object', async () => {+ const container = makeContainer([{ ...baseProduct }]) as any++ const result = await findAndTransformMeilisearchProducts(container, ['prod_1'])+ const variant = result[0]!.variants![0] as any++ expect(variant['size']).toBe('S')+ })++ it('throws Zod error when a required product field is missing', async () => {+ const bad = { ...baseProduct, title: undefined }+ const container = makeContainer([bad]) as any++ await expect(+ findAndTransformMeilisearchProducts(container, ['prod_1'])+ ).rejects.toThrow()+ })++ it('applies status:published filter in the query', async () => {+ const container = makeContainer([]) as any++ await findAndTransformMeilisearchProducts(container, ['prod_1'])++ const callArgs = container._graph.mock.calls[0][0]+ expect(callArgs.filters).toMatchObject({ status: 'published' })+ })+})diff --git a/packages/registry/src/meilisearch/__tests__/service.unit.spec.ts b/packages/registry/src/meilisearch/__tests__/service.unit.spec.tsnew file mode 100644index 000000000..6f635a96b--- /dev/null+++ b/packages/registry/src/meilisearch/__tests__/service.unit.spec.ts@@ -0,0 +1,202 @@+import MeilisearchModuleService from '../modules/meilisearch/service'+import { IndexType } from '../modules/meilisearch/types'++// ─── Mock the meilisearch npm client ────────────────────────────────────────++const mockAddDocuments = jest.fn().mockResolvedValue({ taskUid: 1 })+const mockDeleteDocuments = jest.fn().mockResolvedValue({ taskUid: 2 })+const mockSearch = jest.fn()+const mockGetStats = jest.fn()+const mockUpdateSettings = jest.fn().mockResolvedValue({ taskUid: 3 })+const mockIndex = jest.fn().mockReturnValue({+ addDocuments: mockAddDocuments,+ deleteDocuments: mockDeleteDocuments,+ search: mockSearch,+ getStats: mockGetStats,+ updateSettings: mockUpdateSettings,+})++jest.mock('meilisearch', () => ({+ MeiliSearch: jest.fn().mockImplementation(() => ({+ index: mockIndex,+ config: { host: 'http://localhost:7700' },+ })),+}))++// ─── Helpers ─────────────────────────────────────────────────────────────────++function makeService(options: { host?: string; apiKey?: string } = {}) {+ return new MeilisearchModuleService(null, {+ host: options.host ?? 'http://localhost:7700',+ apiKey: options.apiKey ?? 'masterKey',+ })+}++// ─── Tests ───────────────────────────────────────────────────────────────────++describe('MeilisearchModuleService', () => {+ beforeEach(() => {+ jest.clearAllMocks()+ mockSearch.mockResolvedValue({+ hits: [{ id: 'prod_1' }],+ totalHits: 1,+ page: 1,+ totalPages: 1,+ hitsPerPage: 10,+ processingTimeMs: 5,+ query: 'shoes',+ })+ mockGetStats.mockResolvedValue({ numberOfDocuments: 42 })+ })++ // ─── Constructor ───────────────────────────────────────────────────────────++ describe('constructor', () => {+ it('throws when host is missing', () => {+ expect(() =>+ new MeilisearchModuleService(null, { host: '', apiKey: 'key' } as any)+ ).toThrow('[meilisearch block] Missing required environment variables: MEILISEARCH_HOST')+ })++ it('throws when apiKey is missing', () => {+ expect(() =>+ new MeilisearchModuleService(null, { host: 'http://localhost:7700', apiKey: '' } as any)+ ).toThrow('[meilisearch block] Missing required environment variables: MEILISEARCH_API_KEY')+ })++ it('throws listing both when both are missing', () => {+ expect(() =>+ new MeilisearchModuleService(null, {} as any)+ ).toThrow('MEILISEARCH_HOST, MEILISEARCH_API_KEY')+ })++ it('creates service when both options are provided', () => {+ expect(() => makeService()).not.toThrow()+ })+ })++ // ─── getHost ───────────────────────────────────────────────────────────────++ describe('getHost', () => {+ it('returns the configured host string', () => {+ const service = makeService()+ expect(service.getHost()).toBe('http://localhost:7700')+ })+ })++ // ─── batchUpsert ──────────────────────────────────────────────────────────++ describe('batchUpsert', () => {+ it('calls addDocuments on the products index', async () => {+ const service = makeService()+ const docs = [{ id: 'prod_1', title: 'Shoes' }] as any[]+ await service.batchUpsert(docs)++ expect(mockIndex).toHaveBeenCalledWith(IndexType.PRODUCT)+ expect(mockAddDocuments).toHaveBeenCalledWith(docs, { primaryKey: 'id' })+ })++ it('is a no-op for an empty array', async () => {+ const service = makeService()+ await service.batchUpsert([])++ expect(mockIndex).not.toHaveBeenCalled()+ expect(mockAddDocuments).not.toHaveBeenCalled()+ })+ })++ // ─── batchDelete ──────────────────────────────────────────────────────────++ describe('batchDelete', () => {+ it('calls deleteDocuments on the products index', async () => {+ const service = makeService()+ await service.batchDelete(['prod_1', 'prod_2'])++ expect(mockIndex).toHaveBeenCalledWith(IndexType.PRODUCT)+ expect(mockDeleteDocuments).toHaveBeenCalledWith(['prod_1', 'prod_2'])+ })++ it('is a no-op for an empty array', async () => {+ const service = makeService()+ await service.batchDelete([])++ expect(mockIndex).not.toHaveBeenCalled()+ expect(mockDeleteDocuments).not.toHaveBeenCalled()+ })+ })++ // ─── search ───────────────────────────────────────────────────────────────++ describe('search', () => {+ it('returns structured result from meilisearch hit list', async () => {+ const service = makeService()+ const result = await service.search('shoes', { filter: 'seller.status = "active"' })++ expect(mockIndex).toHaveBeenCalledWith(IndexType.PRODUCT)+ expect(mockSearch).toHaveBeenCalledWith('shoes', { filter: 'seller.status = "active"' })+ expect(result).toEqual({+ hits: [{ id: 'prod_1' }],+ totalHits: 1,+ page: 1,+ totalPages: 1,+ hitsPerPage: 10,+ processingTimeMs: 5,+ query: 'shoes',+ facetDistribution: undefined,+ })+ })++ it('falls back to estimatedTotalHits when totalHits is absent', async () => {+ const service = makeService()+ mockSearch.mockResolvedValueOnce({+ hits: [],+ estimatedTotalHits: 99,+ page: 1,+ totalPages: 0,+ hitsPerPage: 10,+ processingTimeMs: 3,+ query: 'test',+ })++ const result = await service.search('test', {})+ expect(result.totalHits).toBe(99)+ })+ })++ // ─── getStatus ────────────────────────────────────────────────────────────++ describe('getStatus', () => {+ it('returns documentCount and isHealthy:true on success', async () => {+ const service = makeService()+ const status = await service.getStatus()++ expect(status).toEqual({ documentCount: 42, isHealthy: true })+ })++ it('returns isHealthy:false when meilisearch is unreachable', async () => {+ const service = makeService()+ mockGetStats.mockRejectedValueOnce(new Error('Connection refused'))++ const status = await service.getStatus()+ expect(status).toEqual({ documentCount: 0, isHealthy: false })+ })+ })++ // ─── ensureSettings ───────────────────────────────────────────────────────++ describe('ensureSettings', () => {+ it('applies searchable, filterable, and sortable attributes to the index', async () => {+ const service = makeService()+ await service.ensureSettings()++ expect(mockIndex).toHaveBeenCalledWith(IndexType.PRODUCT)+ expect(mockUpdateSettings).toHaveBeenCalledWith(+ expect.objectContaining({+ searchableAttributes: expect.arrayContaining(['title', 'seller.name', 'seller.handle']),+ filterableAttributes: expect.arrayContaining(['seller.status', 'seller.handle', 'categories.id']),+ sortableAttributes: expect.arrayContaining(['title']),+ })+ )+ })+ })+})diff --git a/packages/registry/src/meilisearch/__tests__/store-route.unit.spec.ts b/packages/registry/src/meilisearch/__tests__/store-route.unit.spec.tsnew file mode 100644index 000000000..c857fa89e--- /dev/null+++ b/packages/registry/src/meilisearch/__tests__/store-route.unit.spec.ts@@ -0,0 +1,201 @@+import { POST } from '../api/store/meilisearch/products/search/route'+import { MEILISEARCH_MODULE } from '../modules/meilisearch'+import { ContainerRegistrationKeys } from '@medusajs/framework/utils'++// ─── Mock helpers ─────────────────────────────────────────────────────────────++function makeSearchResult(hitIds: string[] = []) {+ return {+ hits: hitIds.map((id) => ({ id })),+ totalHits: hitIds.length,+ page: 1,+ totalPages: hitIds.length ? 1 : 0,+ hitsPerPage: 12,+ processingTimeMs: 5,+ query: 'test',+ facetDistribution: undefined,+ }+}++function makeRequest(body: Record<string, any> = {}, products: any[] = []) {+ const mockSearch = jest.fn().mockResolvedValue(makeSearchResult(products.map((p) => p.id)))+ const mockGraph = jest.fn().mockResolvedValue({ data: products })++ const scope = {+ resolve: jest.fn((key: string) => {+ if (key === MEILISEARCH_MODULE) return { search: mockSearch }+ if (key === ContainerRegistrationKeys.QUERY) return { graph: mockGraph }+ return {}+ }),+ }++ const req = {+ scope,+ validatedBody: {+ query: '',+ page: 1,+ hitsPerPage: 12,+ ...body,+ },+ } as any++ const res = {+ _data: null as any,+ json(data: any) {+ this._data = data+ },+ }++ return { req, res, mockSearch, mockGraph }+}++// ─── FR-003: seller.status = "active" is always enforced ─────────────────────++describe('POST /store/meilisearch/products/search — filter enforcement', () => {+ it('always sends seller.status = "active" in the filter string (FR-003)', async () => {+ const { req, res, mockSearch } = makeRequest({ query: 'shoes' })++ await POST(req, res as any)++ const searchOptions = mockSearch.mock.calls[0][1] as Record<string, unknown>+ expect(searchOptions.filter).toContain('seller.status = "active"')+ })++ it('cannot be bypassed even when no other filters are provided', async () => {+ const { req, res, mockSearch } = makeRequest({})++ await POST(req, res as any)++ const filter = mockSearch.mock.calls[0][1].filter as string+ expect(filter).toBe('seller.status = "active"')+ })++ it('appends category filter after the mandatory seller filter', async () => {+ const { req, res, mockSearch } = makeRequest({+ filters: { categories: ['cat_1', 'cat_2'] },+ })++ await POST(req, res as any)++ const filter = mockSearch.mock.calls[0][1].filter as string+ expect(filter).toMatch(/^seller\.status = "active"/)+ expect(filter).toContain('categories.id IN ["cat_1", "cat_2"]')+ })++ it('appends price_min filter', async () => {+ const { req, res, mockSearch } = makeRequest({+ filters: { price_min: 50 },+ })++ await POST(req, res as any)++ const filter = mockSearch.mock.calls[0][1].filter as string+ expect(filter).toContain('variants.prices.amount >= 50')+ })++ it('appends price_max filter', async () => {+ const { req, res, mockSearch } = makeRequest({+ filters: { price_max: 200 },+ })++ await POST(req, res as any)++ const filter = mockSearch.mock.calls[0][1].filter as string+ expect(filter).toContain('variants.prices.amount <= 200')+ })++ it('appends seller_handle filter', async () => {+ const { req, res, mockSearch } = makeRequest({+ filters: { seller_handle: 'acme-store' },+ })++ await POST(req, res as any)++ const filter = mockSearch.mock.calls[0][1].filter as string+ expect(filter).toContain('seller.handle = "acme-store"')+ })++ it('combines all filters with AND', async () => {+ const { req, res, mockSearch } = makeRequest({+ filters: {+ categories: ['cat_1'],+ price_min: 10,+ price_max: 100,+ seller_handle: 'acme',+ },+ })++ await POST(req, res as any)++ const filter = mockSearch.mock.calls[0][1].filter as string+ const parts = filter.split(' AND ')+ expect(parts.length).toBe(5) // seller.status + categories + price_min + price_max + seller_handle+ })+})++// ─── Response shape ───────────────────────────────────────────────────────────++describe('POST /store/meilisearch/products/search — response', () => {+ it('returns empty products array when meilisearch returns no hits', async () => {+ const { req, res } = makeRequest({ query: 'xyz_notfound' }, [])++ await POST(req, res as any)++ expect(res._data.products).toEqual([])+ expect(res._data.totalHits).toBe(0)+ expect(res._data).toHaveProperty('query')+ expect(res._data).toHaveProperty('processingTimeMs')+ })++ it('hydrates products from DB and returns them in hit order', async () => {+ // meilisearch hits come back in order prod_1, prod_2 (relevance order)+ const { req, res, mockSearch, mockGraph } = makeRequest({}, [+ { id: 'prod_1', title: 'A' },+ { id: 'prod_2', title: 'B' },+ ])+ mockSearch.mockResolvedValueOnce(makeSearchResult(['prod_1', 'prod_2']))+ mockGraph.mockResolvedValueOnce({+ data: [+ { id: 'prod_2', title: 'B' }, // DB may return in any order+ { id: 'prod_1', title: 'A' },+ ],+ })++ await POST(req, res as any)++ // Should be ordered by meilisearch relevance (prod_1 first)+ expect(res._data.products[0].id).toBe('prod_1')+ expect(res._data.products[1].id).toBe('prod_2')+ })++ it('passes pagination params to meilisearch', async () => {+ const { req, res, mockSearch } = makeRequest({ page: 2, hitsPerPage: 5 }, [])++ await POST(req, res as any)++ expect(mockSearch).toHaveBeenCalledWith(+ '',+ expect.objectContaining({ page: 2, hitsPerPage: 5 })+ )+ })++ it('passes attributesToRetrieve: ["id"] to avoid over-fetching from meilisearch', async () => {+ const { req, res, mockSearch } = makeRequest({}, [])++ await POST(req, res as any)++ expect(mockSearch).toHaveBeenCalledWith(+ '',+ expect.objectContaining({ attributesToRetrieve: ['id'] })+ )+ })++ it('does not call query.graph when meilisearch returns empty hits', async () => {+ const { req, res, mockSearch, mockGraph } = makeRequest({}, [])+ mockSearch.mockResolvedValueOnce(makeSearchResult([]))++ await POST(req, res as any)++ expect(mockGraph).not.toHaveBeenCalled()+ })+})diff --git a/packages/registry/src/meilisearch/__tests__/subscribers.unit.spec.ts b/packages/registry/src/meilisearch/__tests__/subscribers.unit.spec.tsnew file mode 100644index 000000000..e2bd4fb49--- /dev/null+++ b/packages/registry/src/meilisearch/__tests__/subscribers.unit.spec.ts@@ -0,0 +1,397 @@+import meilisearchProductEventsBridgeHandler from '../subscribers/meilisearch-product-events-bridge'+import meilisearchProductsChangedHandler from '../subscribers/meilisearch-products-changed'+import meilisearchProductsDeletedHandler from '../subscribers/meilisearch-products-deleted'+import meilisearchSellerSuspendedHandler from '../subscribers/meilisearch-seller-suspended'+import meilisearchSellerUnsuspendedHandler from '../subscribers/meilisearch-seller-unsuspended'+import { MeilisearchEvents } from '../modules/meilisearch/types'+import { ContainerRegistrationKeys, Modules } from '@medusajs/framework/utils'++// ─── Container mock factory ───────────────────────────────────────────────────++type MockServices = {+ logger?: Partial<{ debug: jest.Mock; error: jest.Mock }>+ eventBus?: Partial<{ emit: jest.Mock }>+ meilisearch?: Partial<{ batchUpsert: jest.Mock; batchDelete: jest.Mock }>+ query?: Partial<{ graph: jest.Mock }>+}++function makeContainer(services: MockServices = {}) {+ const logger = {+ debug: jest.fn(),+ error: jest.fn(),+ ...services.logger,+ }+ const eventBus = {+ emit: jest.fn().mockResolvedValue(undefined),+ ...services.eventBus,+ }+ const meilisearch = {+ batchUpsert: jest.fn().mockResolvedValue(undefined),+ batchDelete: jest.fn().mockResolvedValue(undefined),+ ...services.meilisearch,+ }+ const query = {+ graph: jest.fn().mockResolvedValue({ data: [] }),+ ...services.query,+ }++ const serviceMap: Record<string, any> = {+ [ContainerRegistrationKeys.LOGGER]: logger,+ [ContainerRegistrationKeys.QUERY]: query,+ [Modules.EVENT_BUS]: eventBus,+ meilisearch,+ }++ return {+ resolve: (key: string) => serviceMap[key],+ logger,+ eventBus,+ meilisearch,+ query,+ }+}++// ─── meilisearch-product-events-bridge ───────────────────────────────────────++describe('meilisearchProductEventsBridgeHandler', () => {+ it('emits PRODUCTS_CHANGED for product.created', async () => {+ const container = makeContainer()+ await meilisearchProductEventsBridgeHandler({+ event: { name: 'product.created', data: { id: 'prod_1' } },+ container,+ } as any)++ expect(container.eventBus.emit).toHaveBeenCalledWith({+ name: MeilisearchEvents.PRODUCTS_CHANGED,+ data: { ids: ['prod_1'] },+ })+ })++ it('emits PRODUCTS_CHANGED for product.updated', async () => {+ const container = makeContainer()+ await meilisearchProductEventsBridgeHandler({+ event: { name: 'product.updated', data: { id: 'prod_1' } },+ container,+ } as any)++ expect(container.eventBus.emit).toHaveBeenCalledWith(+ expect.objectContaining({ name: MeilisearchEvents.PRODUCTS_CHANGED })+ )+ })++ it('emits PRODUCTS_DELETED for product.deleted', async () => {+ const container = makeContainer()+ await meilisearchProductEventsBridgeHandler({+ event: { name: 'product.deleted', data: { id: 'prod_1' } },+ container,+ } as any)++ expect(container.eventBus.emit).toHaveBeenCalledWith({+ name: MeilisearchEvents.PRODUCTS_DELETED,+ data: { ids: ['prod_1'] },+ })+ })++ it('emits PRODUCTS_CHANGED for product.product.created', async () => {+ const container = makeContainer()+ await meilisearchProductEventsBridgeHandler({+ event: { name: 'product.product.created', data: { id: 'prod_1' } },+ container,+ } as any)++ expect(container.eventBus.emit).toHaveBeenCalledWith(+ expect.objectContaining({ name: MeilisearchEvents.PRODUCTS_CHANGED })+ )+ })++ it('emits PRODUCTS_CHANGED for product.product.updated', async () => {+ const container = makeContainer()+ await meilisearchProductEventsBridgeHandler({+ event: { name: 'product.product.updated', data: { id: 'prod_1' } },+ container,+ } as any)++ expect(container.eventBus.emit).toHaveBeenCalledWith(+ expect.objectContaining({ name: MeilisearchEvents.PRODUCTS_CHANGED })+ )+ })++ it('emits PRODUCTS_DELETED for product.product.deleted', async () => {+ const container = makeContainer()+ await meilisearchProductEventsBridgeHandler({+ event: { name: 'product.product.deleted', data: { id: 'prod_1' } },+ container,+ } as any)++ expect(container.eventBus.emit).toHaveBeenCalledWith(+ expect.objectContaining({ name: MeilisearchEvents.PRODUCTS_DELETED })+ )+ })++ it('logs error and rethrows when eventBus.emit fails (FR-012)', async () => {+ const error = new Error('Event bus down')+ const container = makeContainer({+ eventBus: { emit: jest.fn().mockRejectedValue(error) },+ })++ await expect(+ meilisearchProductEventsBridgeHandler({+ event: { name: 'product.created', data: { id: 'prod_1' } },+ container,+ } as any)+ ).rejects.toThrow('Event bus down')++ expect(container.logger.error).toHaveBeenCalledWith(+ expect.stringContaining('prod_1'),+ error+ )+ })+})++// ─── meilisearch-products-changed ────────────────────────────────────────────++// Mock the transformer to keep these tests focused on the subscriber logic+jest.mock('../subscribers/utils/meilisearch-product', () => ({+ filterProductsByStatus: jest.fn(),+ findAndTransformMeilisearchProducts: jest.fn(),+}))++import {+ filterProductsByStatus,+ findAndTransformMeilisearchProducts,+} from '../subscribers/utils/meilisearch-product'++const mockFilterProducts = filterProductsByStatus as jest.Mock+const mockTransformProducts = findAndTransformMeilisearchProducts as jest.Mock++describe('meilisearchProductsChangedHandler', () => {+ beforeEach(() => {+ jest.clearAllMocks()+ mockFilterProducts.mockResolvedValue({ published: ['prod_1'], other: [] })+ mockTransformProducts.mockResolvedValue([{ id: 'prod_1', title: 'Shoes' }])+ })++ it('calls batchUpsert for published products', async () => {+ const container = makeContainer()+ await meilisearchProductsChangedHandler({+ event: { data: { ids: ['prod_1'] } },+ container,+ } as any)++ expect(container.meilisearch.batchUpsert).toHaveBeenCalledWith(+ expect.arrayContaining([expect.objectContaining({ id: 'prod_1' })])+ )+ })++ it('calls batchDelete for non-published products', async () => {+ mockFilterProducts.mockResolvedValue({ published: [], other: ['prod_draft'] })+ mockTransformProducts.mockResolvedValue([])++ const container = makeContainer()+ await meilisearchProductsChangedHandler({+ event: { data: { ids: ['prod_draft'] } },+ container,+ } as any)++ expect(container.meilisearch.batchDelete).toHaveBeenCalledWith(['prod_draft'])+ })++ it('logs error and rethrows on failure (FR-012)', async () => {+ const error = new Error('Meilisearch down')+ const container = makeContainer({+ meilisearch: { batchUpsert: jest.fn().mockRejectedValue(error) },+ })++ await expect(+ meilisearchProductsChangedHandler({+ event: { data: { ids: ['prod_1'] } },+ container,+ } as any)+ ).rejects.toThrow('Meilisearch down')++ expect(container.logger.error).toHaveBeenCalledWith(+ expect.stringContaining('prod_1'),+ error+ )+ })++ it('skips batchUpsert when no published products', async () => {+ mockFilterProducts.mockResolvedValue({ published: [], other: [] })++ const container = makeContainer()+ await meilisearchProductsChangedHandler({+ event: { data: { ids: ['prod_1'] } },+ container,+ } as any)++ expect(container.meilisearch.batchUpsert).not.toHaveBeenCalled()+ })+})++// ─── meilisearch-products-deleted ────────────────────────────────────────────++describe('meilisearchProductsDeletedHandler', () => {+ it('calls batchDelete with the provided ids', async () => {+ const container = makeContainer()+ await meilisearchProductsDeletedHandler({+ event: { data: { ids: ['prod_1', 'prod_2'] } },+ container,+ } as any)++ expect(container.meilisearch.batchDelete).toHaveBeenCalledWith(['prod_1', 'prod_2'])+ })++ it('logs error and rethrows on failure (FR-012)', async () => {+ const error = new Error('Network error')+ const container = makeContainer({+ meilisearch: { batchDelete: jest.fn().mockRejectedValue(error) },+ })++ await expect(+ meilisearchProductsDeletedHandler({+ event: { data: { ids: ['prod_1'] } },+ container,+ } as any)+ ).rejects.toThrow('Network error')++ expect(container.logger.error).toHaveBeenCalledWith(+ expect.stringContaining('prod_1'),+ error+ )+ })+})++// ─── meilisearch-seller-suspended ────────────────────────────────────────────++describe('meilisearchSellerSuspendedHandler', () => {+ it('queries seller products via query.graph and emits PRODUCTS_CHANGED', async () => {+ const container = makeContainer({+ query: {+ graph: jest.fn().mockResolvedValue({+ data: [{ products: [{ id: 'prod_1' }, { id: 'prod_2' }] }],+ }),+ },+ })++ await meilisearchSellerSuspendedHandler({+ event: { data: { id: 'sel_1' } },+ container,+ } as any)++ expect(container.query.graph).toHaveBeenCalledWith(+ expect.objectContaining({ entity: 'seller', filters: { id: 'sel_1' } })+ )+ expect(container.eventBus.emit).toHaveBeenCalledWith({+ name: MeilisearchEvents.PRODUCTS_CHANGED,+ data: { ids: expect.arrayContaining(['prod_1', 'prod_2']) },+ })+ })++ it('emits in chunks of 100 when seller has many products', async () => {+ const productIds = Array.from({ length: 250 }, (_, i) => ({ id: `prod_${i}` }))+ const container = makeContainer({+ query: {+ graph: jest.fn().mockResolvedValue({+ data: [{ products: productIds }],+ }),+ },+ })++ await meilisearchSellerSuspendedHandler({+ event: { data: { id: 'sel_1' } },+ container,+ } as any)++ // 250 products = 3 chunks (100 + 100 + 50)+ expect(container.eventBus.emit).toHaveBeenCalledTimes(3)+ const firstChunkIds = container.eventBus.emit.mock.calls[0][0].data.ids+ const secondChunkIds = container.eventBus.emit.mock.calls[1][0].data.ids+ const thirdChunkIds = container.eventBus.emit.mock.calls[2][0].data.ids+ expect(firstChunkIds).toHaveLength(100)+ expect(secondChunkIds).toHaveLength(100)+ expect(thirdChunkIds).toHaveLength(50)+ })++ it('does nothing when the seller has no linked products', async () => {+ const container = makeContainer({+ query: {+ graph: jest.fn().mockResolvedValue({+ data: [{ products: [] }],+ }),+ },+ })++ await meilisearchSellerSuspendedHandler({+ event: { data: { id: 'sel_1' } },+ container,+ } as any)++ expect(container.eventBus.emit).not.toHaveBeenCalled()+ })++ it('logs error and rethrows on failure (FR-012)', async () => {+ const error = new Error('DB error')+ const container = makeContainer({+ query: {+ graph: jest.fn().mockRejectedValue(error),+ },+ })++ await expect(+ meilisearchSellerSuspendedHandler({+ event: { data: { id: 'sel_1' } },+ container,+ } as any)+ ).rejects.toThrow('DB error')++ expect(container.logger.error).toHaveBeenCalledWith(+ expect.stringContaining('sel_1'),+ error+ )+ })+})++// ─── meilisearch-seller-unsuspended ──────────────────────────────────────────++describe('meilisearchSellerUnsuspendedHandler', () => {+ it('emits PRODUCTS_CHANGED for seller products on reinstatement', async () => {+ const container = makeContainer({+ query: {+ graph: jest.fn().mockResolvedValue({+ data: [{ products: [{ id: 'prod_1' }] }],+ }),+ },+ })++ await meilisearchSellerUnsuspendedHandler({+ event: { data: { id: 'sel_1' } },+ container,+ } as any)++ expect(container.eventBus.emit).toHaveBeenCalledWith({+ name: MeilisearchEvents.PRODUCTS_CHANGED,+ data: { ids: ['prod_1'] },+ })+ })++ it('logs error and rethrows on failure (FR-012)', async () => {+ const error = new Error('Timeout')+ const container = makeContainer({+ query: {+ graph: jest.fn().mockRejectedValue(error),+ },+ })++ await expect(+ meilisearchSellerUnsuspendedHandler({+ event: { data: { id: 'sel_1' } },+ container,+ } as any)+ ).rejects.toThrow('Timeout')++ expect(container.logger.error).toHaveBeenCalledWith(+ expect.stringContaining('sel_1'),+ error+ )+ })+})diff --git a/packages/registry/src/meilisearch/api/admin/meilisearch/route.ts b/packages/registry/src/meilisearch/api/admin/meilisearch/route.tsnew file mode 100644index 000000000..2faa62403--- /dev/null+++ b/packages/registry/src/meilisearch/api/admin/meilisearch/route.ts@@ -0,0 +1,34 @@+import { AuthenticatedMedusaRequest, MedusaResponse } from '@medusajs/framework'++import { MEILISEARCH_MODULE, MeilisearchModuleService } from '../../../modules/meilisearch'+import { IndexType } from '../../../modules/meilisearch/types'+import { syncMeilisearchWorkflow } from '../../../workflows/meilisearch/workflows/sync-meilisearch'++export const POST = async (+ req: AuthenticatedMedusaRequest,+ res: MedusaResponse+) => {+ await syncMeilisearchWorkflow.run({+ container: req.scope,+ })++ res.status(200).json({ message: 'Sync in progress' })+}++export const GET = async (+ req: AuthenticatedMedusaRequest,+ res: MedusaResponse+) => {+ const meilisearch =+ req.scope.resolve<MeilisearchModuleService>(MEILISEARCH_MODULE)++ const host = meilisearch.getHost()+ const { documentCount, isHealthy } = await meilisearch.getStatus()++ res.status(200).json({+ host,+ index: IndexType.PRODUCT,+ documentCount,+ isHealthy,+ })+}diff --git a/packages/registry/src/meilisearch/api/middlewares.ts b/packages/registry/src/meilisearch/api/middlewares.tsnew file mode 100644index 000000000..694cded67--- /dev/null+++ b/packages/registry/src/meilisearch/api/middlewares.ts@@ -0,0 +1,3 @@+import { meilisearchStoreMiddlewares } from './store/meilisearch/products/search/middlewares'++export const allMeilisearchMiddlewares = [...meilisearchStoreMiddlewares]diff --git a/packages/registry/src/meilisearch/api/store/meilisearch/products/search/middlewares.ts b/packages/registry/src/meilisearch/api/store/meilisearch/products/search/middlewares.tsnew file mode 100644index 000000000..6a670a449--- /dev/null+++ b/packages/registry/src/meilisearch/api/store/meilisearch/products/search/middlewares.ts@@ -0,0 +1,11 @@+import { MiddlewareRoute, validateAndTransformBody } from '@medusajs/framework'++import { StoreMeilisearchSearchSchema } from './validators'++export const meilisearchStoreMiddlewares: MiddlewareRoute[] = [+ {+ methods: ['POST'],+ matcher: '/store/meilisearch/products/search',+ middlewares: [validateAndTransformBody(StoreMeilisearchSearchSchema)],+ },+]diff --git a/packages/registry/src/meilisearch/api/store/meilisearch/products/search/route.ts b/packages/registry/src/meilisearch/api/store/meilisearch/products/search/route.tsnew file mode 100644index 000000000..366b112a6--- /dev/null+++ b/packages/registry/src/meilisearch/api/store/meilisearch/products/search/route.ts@@ -0,0 +1,115 @@+import { MedusaRequest, MedusaResponse } from '@medusajs/framework'+import { ContainerRegistrationKeys, QueryContext } from '@medusajs/framework/utils'++import { MEILISEARCH_MODULE, MeilisearchModuleService } from '../../../../../modules/meilisearch'+import { StoreMeilisearchSearchType } from './validators'++export const POST = async (+ req: MedusaRequest<StoreMeilisearchSearchType>,+ res: MedusaResponse+) => {+ const meilisearchService =+ req.scope.resolve<MeilisearchModuleService>(MEILISEARCH_MODULE)+ const query = req.scope.resolve(ContainerRegistrationKeys.QUERY)++ const {+ query: searchQuery,+ page,+ hitsPerPage,+ filters,+ currency_code,+ region_id,+ customer_id,+ customer_group_id,+ } = req.validatedBody++ // Build filter string server-side — seller.status = "active" is always enforced (FR-003)+ const filterParts: string[] = ['seller.status = "active"']++ if (filters?.categories?.length) {+ const ids = filters.categories.map((c) => `"${c}"`).join(', ')+ filterParts.push(`categories.id IN [${ids}]`)+ }+ if (filters?.price_min !== undefined) {+ filterParts.push(`variants.prices.amount >= ${filters.price_min}`)+ }+ if (filters?.price_max !== undefined) {+ filterParts.push(`variants.prices.amount <= ${filters.price_max}`)+ }+ if (filters?.seller_handle) {+ filterParts.push(`seller.handle = "${filters.seller_handle}"`)+ }++ const filter = filterParts.join(' AND ')++ const searchResult = await meilisearchService.search(searchQuery, {+ filter,+ page,+ hitsPerPage,+ attributesToRetrieve: ['id'],+ })++ const productIds = searchResult.hits.map((hit) => hit.id)++ if (!productIds.length) {+ return res.json({+ products: [],+ totalHits: searchResult.totalHits,+ page: searchResult.page,+ totalPages: searchResult.totalPages,+ hitsPerPage: searchResult.hitsPerPage,+ processingTimeMs: searchResult.processingTimeMs,+ query: searchResult.query,+ })+ }++ const hasPricingContext =+ currency_code || region_id || customer_id || customer_group_id++ const contextParams: Record<string, unknown> = {}+ if (hasPricingContext) {+ contextParams.variants = {+ calculated_price: QueryContext({+ ...(currency_code && { currency_code }),+ ...(region_id && { region_id }),+ ...(customer_id && { customer_id }),+ ...(customer_group_id && { customer_group_id }),+ }),+ }+ }++ const { data: products } = await query.graph({+ entity: 'product',+ fields: [+ '*',+ 'images.*',+ 'options.*',+ 'options.values.*',+ 'variants.*',+ 'variants.options.*',+ 'variants.prices.*',+ ...(hasPricingContext ? ['variants.calculated_price.*'] : []),+ 'categories.*',+ 'collection.*',+ 'type.*',+ 'tags.*',+ 'seller.*',+ ],+ filters: { id: productIds },+ ...(Object.keys(contextParams).length > 0 && { context: contextParams }),+ })++ const productMap = new Map(products.map((p) => [p.id, p]))+ const orderedProducts = productIds.map((id) => productMap.get(id)).filter(Boolean)++ return res.json({+ products: orderedProducts,+ totalHits: searchResult.totalHits,+ page: searchResult.page,+ totalPages: searchResult.totalPages,+ hitsPerPage: searchResult.hitsPerPage,+ processingTimeMs: searchResult.processingTimeMs,+ query: searchResult.query,+ facetDistribution: searchResult.facetDistribution,+ })+}diff --git a/packages/registry/src/meilisearch/api/store/meilisearch/products/search/validators.ts b/packages/registry/src/meilisearch/api/store/meilisearch/products/search/validators.tsnew file mode 100644index 000000000..89f867bf8--- /dev/null+++ b/packages/registry/src/meilisearch/api/store/meilisearch/products/search/validators.ts@@ -0,0 +1,21 @@+import { z } from 'zod'++export const StoreMeilisearchFiltersSchema = z.object({+ categories: z.array(z.string().min(1)).optional(),+ price_min: z.number().min(0).optional(),+ price_max: z.number().min(0).optional(),+ seller_handle: z.string().min(1).optional(),+})++export const StoreMeilisearchSearchSchema = z.object({+ query: z.string().default(''),+ page: z.coerce.number().int().min(1).default(1),+ hitsPerPage: z.coerce.number().int().min(1).max(100).default(12),+ filters: StoreMeilisearchFiltersSchema.optional(),+ currency_code: z.string().length(3).optional(),+ region_id: z.string().optional(),+ customer_id: z.string().optional(),+ customer_group_id: z.array(z.string()).optional(),+})++export type StoreMeilisearchSearchType = z.infer<typeof StoreMeilisearchSearchSchema>diff --git a/packages/registry/src/meilisearch/modules/meilisearch/index.ts b/packages/registry/src/meilisearch/modules/meilisearch/index.tsnew file mode 100644index 000000000..1774e2c46--- /dev/null+++ b/packages/registry/src/meilisearch/modules/meilisearch/index.ts@@ -0,0 +1,10 @@+import { Module } from '@medusajs/framework/utils'++import MeilisearchModuleService from './service'++export const MEILISEARCH_MODULE = 'meilisearch'+export { MeilisearchModuleService }++export default Module(MEILISEARCH_MODULE, {+ service: MeilisearchModuleService,+})diff --git a/packages/registry/src/meilisearch/modules/meilisearch/service.ts b/packages/registry/src/meilisearch/modules/meilisearch/service.tsnew file mode 100644index 000000000..7998e3f86--- /dev/null+++ b/packages/registry/src/meilisearch/modules/meilisearch/service.ts@@ -0,0 +1,113 @@+import { MeiliSearch } from 'meilisearch'++import { IndexType, MeilisearchEntity, MeilisearchSearchResult } from './types'++type ModuleOptions = {+ host: string+ apiKey: string+}++const SEARCHABLE_ATTRIBUTES = [+ 'title',+ 'subtitle',+ 'description',+ 'tags.value',+ 'type.value',+ 'categories.name',+ 'collection.title',+ 'variants.title',+ 'seller.name',+ 'seller.handle',+]++const FILTERABLE_ATTRIBUTES = [+ 'seller.status',+ 'seller.handle',+ 'categories.id',+ 'categories.name',+ 'variants.prices.amount',+ 'status',+]++const SORTABLE_ATTRIBUTES = ['title', 'variants.prices.amount']++class MeilisearchModuleService {+ private client_: MeiliSearch++ constructor(_: unknown, options: ModuleOptions) {+ if (!options?.host || !options?.apiKey) {+ const missing = [+ !options?.host && 'MEILISEARCH_HOST',+ !options?.apiKey && 'MEILISEARCH_API_KEY',+ ]+ .filter(Boolean)+ .join(', ')+ throw new Error(+ `[meilisearch block] Missing required environment variables: ${missing}`+ )+ }+ this.client_ = new MeiliSearch({+ host: options.host,+ apiKey: options.apiKey,+ })+ }++ getHost(): string {+ return (this.client_ as any).config?.host ?? ''+ }++ async getStatus(): Promise<{ documentCount: number; isHealthy: boolean }> {+ try {+ const index = this.client_.index(IndexType.PRODUCT)+ const stats = await index.getStats()+ return { documentCount: stats.numberOfDocuments, isHealthy: true }+ } catch {+ return { documentCount: 0, isHealthy: false }+ }+ }++ async batchUpsert(documents: MeilisearchEntity[]): Promise<void> {+ if (!documents.length) {+ return+ }+ const index = this.client_.index(IndexType.PRODUCT)+ await index.addDocuments(documents, { primaryKey: 'id' })+ }++ async batchDelete(ids: string[]): Promise<void> {+ if (!ids.length) {+ return+ }+ const index = this.client_.index(IndexType.PRODUCT)+ await index.deleteDocuments(ids)+ }++ async search(+ query: string,+ options: Record<string, unknown>+ ): Promise<MeilisearchSearchResult> {+ const index = this.client_.index(IndexType.PRODUCT)+ const result = await index.search(query, options)+ return {+ hits: (result.hits ?? []) as Array<{ id: string }>,+ totalHits: result.totalHits ?? result.estimatedTotalHits ?? 0,+ page: result.page ?? 0,+ totalPages: result.totalPages ?? 0,+ hitsPerPage: result.hitsPerPage ?? 0,+ processingTimeMs: result.processingTimeMs,+ query: result.query,+ facetDistribution: result.facetDistribution,+ }+ }++ async ensureSettings(): Promise<void> {+ const index = this.client_.index(IndexType.PRODUCT)+ await index.updateSettings({+ searchableAttributes: SEARCHABLE_ATTRIBUTES,+ filterableAttributes: FILTERABLE_ATTRIBUTES,+ sortableAttributes: SORTABLE_ATTRIBUTES,+ })+ }+}++export default MeilisearchModuleServicediff --git a/packages/registry/src/meilisearch/modules/meilisearch/types.ts b/packages/registry/src/meilisearch/modules/meilisearch/types.tsnew file mode 100644index 000000000..3929105ae--- /dev/null+++ b/packages/registry/src/meilisearch/modules/meilisearch/types.ts@@ -0,0 +1,101 @@+import { z } from 'zod'++export enum IndexType {+ PRODUCT = 'products',+}++export enum MeilisearchEvents {+ PRODUCTS_CHANGED = 'meilisearch.products.changed',+ PRODUCTS_DELETED = 'meilisearch.products.deleted',+}++export const MeilisearchVariantValidator = z.object({+ id: z.string(),+ title: z.string().nullish(),+ sku: z.string().nullish(),+ barcode: z.string().nullish(),+ ean: z.string().nullish(),+ allow_backorder: z.boolean(),+ manage_inventory: z.boolean(),+ weight: z.number().nullish(),+ length: z.number().nullish(),+ height: z.number().nullish(),+ width: z.number().nullish(),+ variant_rank: z.number().nullish(),+ options: z.array(+ z.object({+ id: z.string(),+ value: z.string(),+ option: z.object({+ id: z.string(),+ title: z.string(),+ }),+ })+ ),+ prices: z.array(+ z.object({+ id: z.string(),+ currency_code: z.string(),+ amount: z.number(),+ min_quantity: z.number().nullish(),+ max_quantity: z.number().nullish(),+ rules_count: z.number(),+ })+ ),+}).passthrough()++export const MeilisearchProductValidator = z.object({+ id: z.string(),+ title: z.string(),+ handle: z.string(),+ subtitle: z.string().nullable(),+ description: z.string().nullable(),+ thumbnail: z.string().nullable(),+ status: z.string(),+ categories: z+ .array(z.object({ id: z.string(), name: z.string() }))+ .optional(),+ tags: z.array(z.object({ value: z.string() })).optional(),+ collection: z.object({ title: z.string() }).nullable().optional(),+ type: z.object({ value: z.string() }).nullable().optional(),+ images: z+ .array(+ z.object({+ id: z.string(),+ url: z.string(),+ rank: z.number(),+ })+ )+ .optional(),+ options: z.array(z.record(z.string())).nullable().default(null),+ variants: z.array(MeilisearchVariantValidator).nullable().default(null),+ seller: z+ .object({+ id: z.string(),+ handle: z.string().nullish(),+ name: z.string().nullish(),+ status: z.string().nullish(),+ })+ .nullable(),+})++export type MeilisearchProduct = z.infer<typeof MeilisearchProductValidator>+export type MeilisearchEntity = MeilisearchProduct++export type MeilisearchSearchResult = {+ hits: Array<{ id: string }>+ totalHits: number+ page: number+ totalPages: number+ hitsPerPage: number+ processingTimeMs: number+ query: string+ facetDistribution?: Record<string, Record<string, number>>+}++export interface IMeilisearchModuleService {+ search(+ query: string,+ options: Record<string, unknown>+ ): Promise<MeilisearchSearchResult>+}diff --git a/packages/registry/src/meilisearch/subscribers/meilisearch-product-events-bridge.ts b/packages/registry/src/meilisearch/subscribers/meilisearch-product-events-bridge.tsnew file mode 100644index 000000000..01fbfd45a--- /dev/null+++ b/packages/registry/src/meilisearch/subscribers/meilisearch-product-events-bridge.ts@@ -0,0 +1,46 @@+import { SubscriberArgs, SubscriberConfig } from '@medusajs/framework'+import { IEventBusModuleService } from '@medusajs/framework/types'+import { ContainerRegistrationKeys, Modules } from '@medusajs/framework/utils'++import { MeilisearchEvents } from '../modules/meilisearch/types'++export default async function meilisearchProductEventsBridgeHandler({+ event,+ container,+}: SubscriberArgs<{ id: string }>) {+ const logger = container.resolve(ContainerRegistrationKeys.LOGGER)+ const eventBus = container.resolve<IEventBusModuleService>(Modules.EVENT_BUS)++ try {+ const isDelete =+ event.name === 'product.product.deleted' ||+ event.name === 'product.deleted'++ await eventBus.emit({+ name: isDelete+ ? MeilisearchEvents.PRODUCTS_DELETED+ : MeilisearchEvents.PRODUCTS_CHANGED,+ data: { ids: [event.data.id] },+ })+ } catch (error: unknown) {+ logger.error(+ `Meilisearch bridge: failed to forward event ${event.name} for product ${event.data.id}:`,+ error as Error+ )+ throw error+ }+}++export const config: SubscriberConfig = {+ event: [+ 'product.created',+ 'product.updated',+ 'product.deleted',+ 'product.product.created',+ 'product.product.updated',+ 'product.product.deleted',+ ],+ context: {+ subscriberId: 'meilisearch-product-events-bridge',+ },+}diff --git a/packages/registry/src/meilisearch/subscribers/meilisearch-products-changed.ts b/packages/registry/src/meilisearch/subscribers/meilisearch-products-changed.tsnew file mode 100644index 000000000..2049a4d84--- /dev/null+++ b/packages/registry/src/meilisearch/subscribers/meilisearch-products-changed.ts@@ -0,0 +1,58 @@+import { SubscriberArgs, SubscriberConfig } from '@medusajs/framework'+import { ContainerRegistrationKeys } from '@medusajs/framework/utils'++import { MEILISEARCH_MODULE, MeilisearchModuleService } from '../modules/meilisearch'+import { MeilisearchEvents } from '../modules/meilisearch/types'+import {+ filterProductsByStatus,+ findAndTransformMeilisearchProducts,+} from './utils/meilisearch-product'++export default async function meilisearchProductsChangedHandler({+ event,+ container,+}: SubscriberArgs<{ ids: string[] }>) {+ const logger = container.resolve(ContainerRegistrationKeys.LOGGER)++ try {+ const meilisearch =+ container.resolve<MeilisearchModuleService>(MEILISEARCH_MODULE)++ const { published, other } = await filterProductsByStatus(+ container,+ event.data.ids+ )++ logger.debug(+ `Meilisearch sync: Processing ${event.data.ids.length} products — ${published.length} to upsert, ${other.length} to delete`+ )++ const documentsToUpsert = published.length+ ? await findAndTransformMeilisearchProducts(container, published)+ : []++ if (documentsToUpsert.length) {+ await meilisearch.batchUpsert(documentsToUpsert)+ }+ if (other.length) {+ await meilisearch.batchDelete(other)+ }++ logger.debug(+ `Meilisearch sync: Successfully synced ${documentsToUpsert.length} products`+ )+ } catch (error: unknown) {+ logger.error(+ `Meilisearch sync failed for products [${event.data.ids.join(', ')}]:`,+ error as Error+ )+ throw error+ }+}++export const config: SubscriberConfig = {+ event: MeilisearchEvents.PRODUCTS_CHANGED,+ context: {+ subscriberId: 'meilisearch-products-changed-handler',+ },+}diff --git a/packages/registry/src/meilisearch/subscribers/meilisearch-products-deleted.ts b/packages/registry/src/meilisearch/subscribers/meilisearch-products-deleted.tsnew file mode 100644index 000000000..7a5ef4058--- /dev/null+++ b/packages/registry/src/meilisearch/subscribers/meilisearch-products-deleted.ts@@ -0,0 +1,40 @@+import { SubscriberArgs, SubscriberConfig } from '@medusajs/framework'+import { ContainerRegistrationKeys } from '@medusajs/framework/utils'++import { MEILISEARCH_MODULE, MeilisearchModuleService } from '../modules/meilisearch'+import { MeilisearchEvents } from '../modules/meilisearch/types'++export default async function meilisearchProductsDeletedHandler({+ event,+ container,+}: SubscriberArgs<{ ids: string[] }>) {+ const logger = container.resolve(ContainerRegistrationKeys.LOGGER)++ try {+ const meilisearch =+ container.resolve<MeilisearchModuleService>(MEILISEARCH_MODULE)++ logger.debug(+ `Meilisearch delete: Removing ${event.data.ids.length} products from index`+ )++ await meilisearch.batchDelete(event.data.ids)++ logger.debug(+ `Meilisearch delete: Successfully removed ${event.data.ids.length} products`+ )+ } catch (error: unknown) {+ logger.error(+ `Meilisearch delete failed for products [${event.data.ids.join(', ')}]:`,+ error as Error+ )+ throw error+ }+}++export const config: SubscriberConfig = {+ event: MeilisearchEvents.PRODUCTS_DELETED,+ context: {+ subscriberId: 'meilisearch-products-deleted-handler',+ },+}diff --git a/packages/registry/src/meilisearch/subscribers/meilisearch-seller-suspended.ts b/packages/registry/src/meilisearch/subscribers/meilisearch-seller-suspended.tsnew file mode 100644index 000000000..e5ac696f1--- /dev/null+++ b/packages/registry/src/meilisearch/subscribers/meilisearch-seller-suspended.ts@@ -0,0 +1,60 @@+import { SubscriberArgs, SubscriberConfig } from '@medusajs/framework'+import { IEventBusModuleService } from '@medusajs/framework/types'+import { ContainerRegistrationKeys, Modules } from '@medusajs/framework/utils'++import { MeilisearchEvents } from '../modules/meilisearch/types'++const CHUNK_SIZE = 100++export default async function meilisearchSellerSuspendedHandler({+ event,+ container,+}: SubscriberArgs<{ id: string }>) {+ const logger = container.resolve(ContainerRegistrationKeys.LOGGER)+ const query = container.resolve(ContainerRegistrationKeys.QUERY)+ const eventBus = container.resolve<IEventBusModuleService>(Modules.EVENT_BUS)++ try {+ const sellerId = event.data.id++ // Query seller with linked products to get product IDs (bidirectional link)+ const { data: sellers } = await query.graph({+ entity: 'seller',+ fields: ['products.id'],+ filters: { id: sellerId },+ })++ const productIds: string[] =+ (sellers[0] as any)?.products?.map((p: any) => p.id) ?? []++ if (!productIds.length) {+ return+ }++ logger.debug(+ `Meilisearch: Seller ${sellerId} suspended — re-indexing ${productIds.length} products`+ )++ // Emit in chunks so products-changed subscriber processes them in manageable batches+ for (let i = 0; i < productIds.length; i += CHUNK_SIZE) {+ const chunk = productIds.slice(i, i + CHUNK_SIZE)+ await eventBus.emit({+ name: MeilisearchEvents.PRODUCTS_CHANGED,+ data: { ids: chunk },+ })+ }+ } catch (error: unknown) {+ logger.error(+ `Meilisearch: Failed to process seller.suspended for seller ${event.data.id}:`,+ error as Error+ )+ throw error+ }+}++export const config: SubscriberConfig = {+ event: 'seller.suspended',+ context: {+ subscriberId: 'meilisearch-seller-suspended-handler',+ },+}diff --git a/packages/registry/src/meilisearch/subscribers/meilisearch-seller-unsuspended.ts b/packages/registry/src/meilisearch/subscribers/meilisearch-seller-unsuspended.tsnew file mode 100644index 000000000..0798360dc--- /dev/null+++ b/packages/registry/src/meilisearch/subscribers/meilisearch-seller-unsuspended.ts@@ -0,0 +1,59 @@+import { SubscriberArgs, SubscriberConfig } from '@medusajs/framework'+import { IEventBusModuleService } from '@medusajs/framework/types'+import { ContainerRegistrationKeys, Modules } from '@medusajs/framework/utils'++import { MeilisearchEvents } from '../modules/meilisearch/types'++const CHUNK_SIZE = 100++export default async function meilisearchSellerUnsuspendedHandler({+ event,+ container,+}: SubscriberArgs<{ id: string }>) {+ const logger = container.resolve(ContainerRegistrationKeys.LOGGER)+ const query = container.resolve(ContainerRegistrationKeys.QUERY)+ const eventBus = container.resolve<IEventBusModuleService>(Modules.EVENT_BUS)++ try {+ const sellerId = event.data.id++ // Query seller with linked products to get product IDs (bidirectional link)+ const { data: sellers } = await query.graph({+ entity: 'seller',+ fields: ['products.id'],+ filters: { id: sellerId },+ })++ const productIds: string[] =+ (sellers[0] as any)?.products?.map((p: any) => p.id) ?? []++ if (!productIds.length) {+ return+ }++ logger.debug(+ `Meilisearch: Seller ${sellerId} unsuspended — re-indexing ${productIds.length} products`+ )++ for (let i = 0; i < productIds.length; i += CHUNK_SIZE) {+ const chunk = productIds.slice(i, i + CHUNK_SIZE)+ await eventBus.emit({+ name: MeilisearchEvents.PRODUCTS_CHANGED,+ data: { ids: chunk },+ })+ }+ } catch (error: unknown) {+ logger.error(+ `Meilisearch: Failed to process seller.unsuspended for seller ${event.data.id}:`,+ error as Error+ )+ throw error+ }+}++export const config: SubscriberConfig = {+ event: 'seller.unsuspended',+ context: {+ subscriberId: 'meilisearch-seller-unsuspended-handler',+ },+}diff --git a/packages/registry/src/meilisearch/subscribers/utils/meilisearch-product.ts b/packages/registry/src/meilisearch/subscribers/utils/meilisearch-product.tsnew file mode 100644index 000000000..9277a305d--- /dev/null+++ b/packages/registry/src/meilisearch/subscribers/utils/meilisearch-product.ts@@ -0,0 +1,90 @@+import { z } from 'zod'++import { MedusaContainer } from '@medusajs/framework'+import { ContainerRegistrationKeys, arrayDifference } from '@medusajs/framework/utils'++import { MeilisearchProductValidator, MeilisearchVariantValidator } from '../../modules/meilisearch/types'++export async function filterProductsByStatus(+ container: MedusaContainer,+ ids: string[] = []+) {+ const query = container.resolve(ContainerRegistrationKeys.QUERY)++ const { data: products } = await query.graph({+ entity: 'product',+ fields: ['id', 'status'],+ filters: { id: ids },+ })++ const published = products.filter((p) => p.status === 'published')+ const notPublished = arrayDifference(products, published)++ const existingIds = new Set(products.map((p) => p.id))+ const deletedIds = ids.filter((id) => !existingIds.has(id))++ return {+ published: published.map((p) => p.id),+ other: [...notPublished.map((p) => p.id), ...deletedIds],+ }+}++export async function findAndTransformMeilisearchProducts(+ container: MedusaContainer,+ ids: string[] = []+) {+ const query = container.resolve(ContainerRegistrationKeys.QUERY)++ const { data: products } = await query.graph({+ entity: 'product',+ fields: [+ '*',+ 'categories.name',+ 'categories.id',+ 'collection.title',+ 'tags.value',+ 'type.value',+ 'variants.*',+ 'variants.options.*',+ 'variants.prices.*',+ 'options.*',+ 'options.values.*',+ 'images.*',+ 'seller.id',+ 'seller.handle',+ 'seller.name',+ 'seller.status',+ ],+ filters: ids.length+ ? { id: ids, status: 'published' }+ : { status: 'published' },+ })++ for (const product of products as any[]) {+ product.options = (product.options ?? [])+ .filter((option: any) => option?.title && option?.values)+ .map((option: any) =>+ option.values.map((value: any) => {+ const entry: Record<string, string> = {}+ entry[option.title.toLowerCase()] = value.value+ return entry+ })+ )+ .flat()++ product.variants = z+ .array(MeilisearchVariantValidator)+ .parse(product.variants ?? [])++ product.variants = (product.variants ?? []).map((variant: any) =>+ (variant.options ?? []).reduce((entry: any, item: any) => {+ if (item?.option?.title) {+ entry[item.option.title.toLowerCase()] = item.value+ }+ return entry+ }, variant)+ )+ }++ return z.array(MeilisearchProductValidator).parse(products)+}diff --git a/packages/registry/src/meilisearch/workflows/meilisearch/steps/sync-meilisearch-products.ts b/packages/registry/src/meilisearch/workflows/meilisearch/steps/sync-meilisearch-products.tsnew file mode 100644index 000000000..5260921ee--- /dev/null+++ b/packages/registry/src/meilisearch/workflows/meilisearch/steps/sync-meilisearch-products.ts@@ -0,0 +1,55 @@+import { IEventBusModuleService, RemoteQueryFunction } from '@medusajs/framework/types'+import { ContainerRegistrationKeys, Modules } from '@medusajs/framework/utils'+import { StepResponse, createStep } from '@medusajs/framework/workflows-sdk'++import { MEILISEARCH_MODULE, MeilisearchModuleService } from '../../../modules/meilisearch'+import { MeilisearchEvents } from '../../../modules/meilisearch/types'++const CHUNK_SIZE = 100++export const syncMeilisearchProductsStep = createStep(+ 'sync-meilisearch-products',+ async (_: void, { container }) => {+ const query = container.resolve<RemoteQueryFunction>(+ ContainerRegistrationKeys.QUERY+ )+ const meilisearch =+ container.resolve<MeilisearchModuleService>(MEILISEARCH_MODULE)+ const eventBus = container.resolve<IEventBusModuleService>(Modules.EVENT_BUS)++ // Configure index settings (filterable, searchable, sortable attributes)+ await meilisearch.ensureSettings()++ // Delete products that are not published or have been soft-deleted+ const { data: productsToDelete } = await query.graph({+ entity: 'product',+ filters: {+ status: { $ne: 'published' },+ },+ fields: ['id'],+ })++ if (productsToDelete.length) {+ await meilisearch.batchDelete(productsToDelete.map((p) => p.id))+ }++ // Fetch all published product IDs and process in chunks+ const { data: publishedProducts } = await query.graph({+ entity: 'product',+ filters: { status: 'published' },+ fields: ['id'],+ })++ const productIds = publishedProducts.map((p) => p.id)++ for (let i = 0; i < productIds.length; i += CHUNK_SIZE) {+ const chunk = productIds.slice(i, i + CHUNK_SIZE)+ await eventBus.emit({+ name: MeilisearchEvents.PRODUCTS_CHANGED,+ data: { ids: chunk },+ })+ }++ return new StepResponse()+ }+)diff --git a/packages/registry/src/meilisearch/workflows/meilisearch/workflows/sync-meilisearch.ts b/packages/registry/src/meilisearch/workflows/meilisearch/workflows/sync-meilisearch.tsnew file mode 100644index 000000000..2706f28cd--- /dev/null+++ b/packages/registry/src/meilisearch/workflows/meilisearch/workflows/sync-meilisearch.ts@@ -0,0 +1,10 @@+import { createWorkflow, WorkflowResponse } from '@medusajs/framework/workflows-sdk'++import { syncMeilisearchProductsStep } from '../steps/sync-meilisearch-products'++export const syncMeilisearchWorkflow = createWorkflow(+ 'sync-meilisearch-workflow',+ function () {+ return new WorkflowResponse(syncMeilisearchProductsStep())+ }+)