Skip to content

The complete open source platform to run your entire marketplace. Storefront, vendor panel, admin console, and integrations in one enterprise-grade platform you own.

feat(registry): add meilisearch search block for multi-vendor marketplace

kjedras2c36133de69b
diff --git a/bun.lock b/bun.lock
index 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.test
new file mode 100644
index 000000000..0b4fe5e47
--- /dev/null
+++ b/integration-tests/.env.meilisearch.test
@@ -0,0 +1,2 @@
+MEILISEARCH_HOST=http://localhost:7700
+MEILISEARCH_API_KEY=masterKey
diff --git a/integration-tests/http/meilisearch/admin/meilisearch.spec.ts b/integration-tests/http/meilisearch/admin/meilisearch.spec.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
index 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.json
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.cjs
new file mode 100644
index 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.json
index 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.json
new file mode 100644
index 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 file
diff --git a/packages/registry/r/registry.json b/packages/registry/r/registry.json
index 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 file
diff --git a/packages/registry/registry.json b/packages/registry/registry.json
index 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 file
diff --git a/packages/registry/src/meilisearch/PLUGIN.md b/packages/registry/src/meilisearch/PLUGIN.md
new file mode 100644
index 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.md
new file mode 100644
index 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.md
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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 MeilisearchModuleService
diff --git a/packages/registry/src/meilisearch/modules/meilisearch/types.ts b/packages/registry/src/meilisearch/modules/meilisearch/types.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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())
+ }
+)