@misiki/gocommerce-connector 0.13.0 → 0.14.0

package/README.md

@@ -45,7 +45,8 @@ gocommerce -identity -wishlist -reviews -cms -faq -menus serve
 
 Each is optional. Without `-identity` there is no sign-in (guest checkout
 always works); without `-reviews` products show no stars; and so on. Add
-`-meilisearch` (with `MEILI_HOST` and keys) for price sorting and price filters,
+`-meilisearch` (with `MEILI_HOST` and keys) for typo-tolerant search once a store
+switches the Meilisearch plugin on,
 `-newsletter` and `-contact` for the signup box and contact form, and `-b2b` for
 business buyers (see "Beyond the storefront's screens").
 
@@ -152,7 +153,7 @@ down stays best-effort: the storefront renders from its static record.
 | attribute filters (`?attributes.color=Red`) | `/api/products?attr=color:Red` |
 | newsletter box | `/x/newsletter/subscribe` |
 | contact form, product enquiries | `/x/contact/messages` |
-| price sort and filter, type-ahead | `/x/meilisearch/search`, falling back to the engine's own search |
+| search words, type-ahead (plugin on) | `/x/meilisearch/search`, falling back to the engine's own search when it is off or down |
 | store record | the storefront's own config, with the engine's currency, menus and module switches over it |
 
 Blogs, banners, reels, chat, warranties, deals and uploads have no engine

package/dist/{index-DHKyh3CU.d.cts → index-C0CR05Q4.d.cts}

@@ -578,6 +578,8 @@ type SearchResult = {
     total: number;
     limit: number;
     offset: number;
+    /** Meilisearch did not answer: search the product listing instead. */
+    unavailable?: boolean;
 };
 /** One approved vendor's offer on a variant, from `GET /api/variants/{id}/offers`. Cheapest first. */
 type Offer = {
@@ -1489,6 +1491,19 @@ type CatalogPage = {
 declare class CatalogService extends BaseService {
     protected readonly facts: StoreFacts;
     protected queryCatalog(q: CatalogQuery): Promise<CatalogPage>;
+    /**
+     * The shelf from the Meilisearch module, or null when the store has it off,
+     * sells through a channel, finds nothing for the words, or it cannot answer (Meilisearch down: the engine says `unavailable`), so
+     * the caller asks the database instead of showing the shopper an error.
+     */
+    protected fromIndex(q: CatalogQuery, o: {
+        page: number;
+        limit: number;
+        search?: string;
+        sortKey?: string;
+        wantsRange: boolean;
+        hierarchy: CatalogPage['categoryHierarchy'];
+    }): Promise<CatalogPage | null>;
 }
 
 /**
@@ -2697,39 +2712,6 @@ declare class MeilisearchService extends CatalogService {
         search?: string;
         limit?: number;
     }): Promise<{
-        data: {
-            id: string;
-            slug: string;
-            title: string;
-            name: string;
-            description: string;
-            currency: string;
-            price: number;
-            mrp: number;
-            minPrice: number;
-            maxPrice: number;
-            thumbnail: string | null;
-            image_url: string | null;
-            images: string;
-            stock: number;
-            hasStock: boolean;
-            manageInventory: boolean;
-            allowBackorder: boolean;
-            productTags: string;
-            category: {
-                name: string;
-                slug: string;
-            } | null;
-            vendor: {
-                businessName: string;
-            } | null;
-            variants: ReturnType<typeof toVariant>[];
-            options: never[];
-            ratings: never[];
-            link: string;
-            updatedAt: string;
-        }[];
-    } | {
         data: {
             id: string;
             slug: string;
@@ -2840,6 +2822,37 @@ declare class MeilisearchService extends CatalogService {
             metadata: Record<string, unknown> | null;
             createdAt: string;
             updatedAt: string;
+        }[] | {
+            id: string;
+            slug: string;
+            title: string;
+            name: string;
+            description: string;
+            currency: string;
+            price: number;
+            mrp: number;
+            minPrice: number;
+            maxPrice: number;
+            thumbnail: string | null;
+            image_url: string | null;
+            images: string;
+            stock: number;
+            hasStock: boolean;
+            manageInventory: boolean;
+            allowBackorder: boolean;
+            productTags: string;
+            category: {
+                name: string;
+                slug: string;
+            } | null;
+            vendor: {
+                businessName: string;
+            } | null;
+            variants: ReturnType<typeof toVariant>[];
+            options: never[];
+            ratings: never[];
+            link: string;
+            updatedAt: string;
         }[];
     }>;
 }
@@ -6606,39 +6619,6 @@ declare class AutocompleteService extends MeilisearchService {
         q?: string;
         search?: string;
     }): Promise<{
-        data: {
-            id: string;
-            slug: string;
-            title: string;
-            name: string;
-            description: string;
-            currency: string;
-            price: number;
-            mrp: number;
-            minPrice: number;
-            maxPrice: number;
-            thumbnail: string | null;
-            image_url: string | null;
-            images: string;
-            stock: number;
-            hasStock: boolean;
-            manageInventory: boolean;
-            allowBackorder: boolean;
-            productTags: string;
-            category: {
-                name: string;
-                slug: string;
-            } | null;
-            vendor: {
-                businessName: string;
-            } | null;
-            variants: ReturnType<typeof toVariant>[];
-            options: never[];
-            ratings: never[];
-            link: string;
-            updatedAt: string;
-        }[];
-    } | {
         data: {
             id: string;
             slug: string;
@@ -6749,6 +6729,37 @@ declare class AutocompleteService extends MeilisearchService {
             metadata: Record<string, unknown> | null;
             createdAt: string;
             updatedAt: string;
+        }[] | {
+            id: string;
+            slug: string;
+            title: string;
+            name: string;
+            description: string;
+            currency: string;
+            price: number;
+            mrp: number;
+            minPrice: number;
+            maxPrice: number;
+            thumbnail: string | null;
+            image_url: string | null;
+            images: string;
+            stock: number;
+            hasStock: boolean;
+            manageInventory: boolean;
+            allowBackorder: boolean;
+            productTags: string;
+            category: {
+                name: string;
+                slug: string;
+            } | null;
+            vendor: {
+                businessName: string;
+            } | null;
+            variants: ReturnType<typeof toVariant>[];
+            options: never[];
+            ratings: never[];
+            link: string;
+            updatedAt: string;
         }[];
     }>;
 }

package/dist/{index-DHKyh3CU.d.ts → index-C0CR05Q4.d.ts}

@@ -578,6 +578,8 @@ type SearchResult = {
     total: number;
     limit: number;
     offset: number;
+    /** Meilisearch did not answer: search the product listing instead. */
+    unavailable?: boolean;
 };
 /** One approved vendor's offer on a variant, from `GET /api/variants/{id}/offers`. Cheapest first. */
 type Offer = {
@@ -1489,6 +1491,19 @@ type CatalogPage = {
 declare class CatalogService extends BaseService {
     protected readonly facts: StoreFacts;
     protected queryCatalog(q: CatalogQuery): Promise<CatalogPage>;
+    /**
+     * The shelf from the Meilisearch module, or null when the store has it off,
+     * sells through a channel, finds nothing for the words, or it cannot answer (Meilisearch down: the engine says `unavailable`), so
+     * the caller asks the database instead of showing the shopper an error.
+     */
+    protected fromIndex(q: CatalogQuery, o: {
+        page: number;
+        limit: number;
+        search?: string;
+        sortKey?: string;
+        wantsRange: boolean;
+        hierarchy: CatalogPage['categoryHierarchy'];
+    }): Promise<CatalogPage | null>;
 }
 
 /**
@@ -2697,39 +2712,6 @@ declare class MeilisearchService extends CatalogService {
         search?: string;
         limit?: number;
     }): Promise<{
-        data: {
-            id: string;
-            slug: string;
-            title: string;
-            name: string;
-            description: string;
-            currency: string;
-            price: number;
-            mrp: number;
-            minPrice: number;
-            maxPrice: number;
-            thumbnail: string | null;
-            image_url: string | null;
-            images: string;
-            stock: number;
-            hasStock: boolean;
-            manageInventory: boolean;
-            allowBackorder: boolean;
-            productTags: string;
-            category: {
-                name: string;
-                slug: string;
-            } | null;
-            vendor: {
-                businessName: string;
-            } | null;
-            variants: ReturnType<typeof toVariant>[];
-            options: never[];
-            ratings: never[];
-            link: string;
-            updatedAt: string;
-        }[];
-    } | {
         data: {
             id: string;
             slug: string;
@@ -2840,6 +2822,37 @@ declare class MeilisearchService extends CatalogService {
             metadata: Record<string, unknown> | null;
             createdAt: string;
             updatedAt: string;
+        }[] | {
+            id: string;
+            slug: string;
+            title: string;
+            name: string;
+            description: string;
+            currency: string;
+            price: number;
+            mrp: number;
+            minPrice: number;
+            maxPrice: number;
+            thumbnail: string | null;
+            image_url: string | null;
+            images: string;
+            stock: number;
+            hasStock: boolean;
+            manageInventory: boolean;
+            allowBackorder: boolean;
+            productTags: string;
+            category: {
+                name: string;
+                slug: string;
+            } | null;
+            vendor: {
+                businessName: string;
+            } | null;
+            variants: ReturnType<typeof toVariant>[];
+            options: never[];
+            ratings: never[];
+            link: string;
+            updatedAt: string;
         }[];
     }>;
 }
@@ -6606,39 +6619,6 @@ declare class AutocompleteService extends MeilisearchService {
         q?: string;
         search?: string;
     }): Promise<{
-        data: {
-            id: string;
-            slug: string;
-            title: string;
-            name: string;
-            description: string;
-            currency: string;
-            price: number;
-            mrp: number;
-            minPrice: number;
-            maxPrice: number;
-            thumbnail: string | null;
-            image_url: string | null;
-            images: string;
-            stock: number;
-            hasStock: boolean;
-            manageInventory: boolean;
-            allowBackorder: boolean;
-            productTags: string;
-            category: {
-                name: string;
-                slug: string;
-            } | null;
-            vendor: {
-                businessName: string;
-            } | null;
-            variants: ReturnType<typeof toVariant>[];
-            options: never[];
-            ratings: never[];
-            link: string;
-            updatedAt: string;
-        }[];
-    } | {
         data: {
             id: string;
             slug: string;
@@ -6749,6 +6729,37 @@ declare class AutocompleteService extends MeilisearchService {
             metadata: Record<string, unknown> | null;
             createdAt: string;
             updatedAt: string;
+        }[] | {
+            id: string;
+            slug: string;
+            title: string;
+            name: string;
+            description: string;
+            currency: string;
+            price: number;
+            mrp: number;
+            minPrice: number;
+            maxPrice: number;
+            thumbnail: string | null;
+            image_url: string | null;
+            images: string;
+            stock: number;
+            hasStock: boolean;
+            manageInventory: boolean;
+            allowBackorder: boolean;
+            productTags: string;
+            category: {
+                name: string;
+                slug: string;
+            } | null;
+            vendor: {
+                businessName: string;
+            } | null;
+            variants: ReturnType<typeof toVariant>[];
+            options: never[];
+            ratings: never[];
+            link: string;
+            updatedAt: string;
         }[];
     }>;
 }

package/dist/index.cjs

@@ -1216,14 +1216,17 @@ var CatalogService = class extends BaseService {
     const attr = Object.entries(q.attributes ?? {}).flatMap(
       ([handle, values]) => values.filter(Boolean).map((v) => `${handle}:${v}`)
     );
-    if (q.facets && !legacyListing.has(this.engineBase())) {
+    const refined = attr.length > 0 || !!(q.tags?.length || q.vendors?.length || q.productTypes?.length);
+    const triedIndex = !!search && !refined;
+    const counted = q.facets && !legacyListing.has(this.engineBase());
+    const facetListing = async (page2, limit2) => {
       const { currency } = await this.facts.ready();
       const minor = (n) => Number.isFinite(n) ? Math.max(0, toMinor(n, currency)) : void 0;
-      const env2 = await this.engine("/api/products", {
+      return this.engine("/api/products", {
         query: {
           q: search,
-          page,
-          limit,
+          page: page2,
+          limit: limit2,
           channel: this.creds.channel,
           category: q.category,
           tag: q.tags,
@@ -1236,6 +1239,16 @@ var CatalogService = class extends BaseService {
           facets: 1
         }
       });
+    };
+    if (triedIndex && await this.facts.pluginOn("meilisearch")) {
+      const [found, rail] = await Promise.all([
+        this.fromIndex(q, { page, limit, search, sortKey, wantsRange, hierarchy }),
+        counted ? facetListing(1, 1).catch(() => null) : null
+      ]);
+      if (found) return rail?.meta?.facets ? { ...found, facets: rail.meta.facets } : found;
+    }
+    if (counted) {
+      const env2 = await facetListing(page, limit);
       if (env2.meta?.facets) {
         return {
           ...toPage(env2, (p) => toProduct(p)),
@@ -1246,39 +1259,9 @@ var CatalogService = class extends BaseService {
       }
       legacyListing.add(this.engineBase());
     }
-    if ((sortKey || wantsRange) && await this.facts.pluginOn("meilisearch")) {
-      const filters = [];
-      if (q.category) {
-        const names = (await this.facts.subtree(q.category).catch(() => [])).map(
-          (c) => quote(c.full_name)
-        );
-        if (!names.length) return { ...emptyCatalog(limit), categoryHierarchy: hierarchy, sorted: true };
-        filters.push(`category IN [${names.join(", ")}]`);
-      }
-      if (wantsRange) {
-        const { currency } = await this.facts.ready();
-        if (Number.isFinite(q.priceFrom)) filters.push(`price_minor >= ${toMinor(q.priceFrom, currency)}`);
-        if (Number.isFinite(q.priceTo)) filters.push(`price_minor <= ${toMinor(q.priceTo, currency)}`);
-      }
-      const res = await this.data("/x/meilisearch/search", {
-        query: {
-          q: search ?? "",
-          limit,
-          offset: (page - 1) * limit,
-          filter: filters.join(" AND ") || void 0,
-          sort: sortKey
-        }
-      });
-      const total = res.total ?? 0;
-      return {
-        data: (res.hits ?? []).map(fromSearchDoc),
-        count: total,
-        pageSize: limit,
-        noOfPage: Math.max(1, Math.ceil(total / limit)),
-        page,
-        categoryHierarchy: hierarchy,
-        sorted: true
-      };
+    if (!triedIndex && (sortKey || wantsRange)) {
+      const found = await this.fromIndex(q, { page, limit, search, sortKey, wantsRange, hierarchy });
+      if (found) return found;
     }
     const sorted = !sortKey && !wantsRange;
     if (q.category && !search) {
@@ -1298,6 +1281,45 @@ var CatalogService = class extends BaseService {
     });
     return { ...toPage(env, (p) => toProduct(p)), categoryHierarchy: hierarchy, sorted };
   }
+  /**
+   * The shelf from the Meilisearch module, or null when the store has it off,
+   * sells through a channel, finds nothing for the words, or it cannot answer (Meilisearch down: the engine says `unavailable`), so
+   * the caller asks the database instead of showing the shopper an error.
+   */
+  async fromIndex(q, o) {
+    if (this.creds.channel || !await this.facts.pluginOn("meilisearch")) return null;
+    const filters = [];
+    if (q.category) {
+      const names = (await this.facts.subtree(q.category).catch(() => [])).map((c) => quote(c.full_name));
+      if (!names.length) return { ...emptyCatalog(o.limit), categoryHierarchy: o.hierarchy, sorted: true };
+      filters.push(`category IN [${names.join(", ")}]`);
+    }
+    if (o.wantsRange) {
+      const { currency } = await this.facts.ready();
+      if (Number.isFinite(q.priceFrom)) filters.push(`price_minor >= ${toMinor(q.priceFrom, currency)}`);
+      if (Number.isFinite(q.priceTo)) filters.push(`price_minor <= ${toMinor(q.priceTo, currency)}`);
+    }
+    const res = await this.data("/x/meilisearch/search", {
+      query: {
+        q: o.search ?? "",
+        limit: o.limit,
+        offset: (o.page - 1) * o.limit,
+        filter: filters.join(" AND ") || void 0,
+        sort: o.sortKey
+      }
+    }).catch(() => null);
+    if (!res || res.unavailable || o.search && !res.hits?.length) return null;
+    const total = res.total ?? 0;
+    return {
+      data: (res.hits ?? []).map(fromSearchDoc),
+      count: total,
+      pageSize: o.limit,
+      noOfPage: Math.max(1, Math.ceil(total / o.limit)),
+      page: o.page,
+      categoryHierarchy: o.hierarchy,
+      sorted: true
+    };
+  }
 };
 function emptyCatalog(limit = PAGE_SIZE) {
   return { data: [], count: 0, pageSize: limit, noOfPage: 0, page: 1 };
@@ -1595,10 +1617,8 @@ var MeilisearchService = class extends CatalogService {
   async searchAutoComplete({ query, search, limit = 8 } = {}) {
     const q = (query ?? search ?? "").trim();
     if (!q) return { data: [] };
-    if (await this.facts.pluginOn("meilisearch")) {
-      const res = await this.data("/x/meilisearch/search", { query: { q, limit } });
-      return { data: (res.hits ?? []).map(fromSearchDoc) };
-    }
+    const found = await this.fromIndex({}, { page: 1, limit, search: q, wantsRange: false, hierarchy: [] });
+    if (found) return { data: found.data };
     const rows = await this.data("/api/products", { query: { q, limit, channel: this.creds.channel } }) ?? [];
     return { data: rows.map((p) => toProduct(p)) };
   }