@findlane/server 0.2.0 → 0.4.0

package/dist/index.d.ts

@@ -28,6 +28,9 @@ export type IndexSettings = {
     synonyms?: string[][];
     /** Languages whose common words queries drop, and whose plurals and alternative spellings match. */
     languages?: Array<"da" | "de" | "en" | "is" | "no" | "sv">;
+    /** Searches say which words typo tolerance corrected, and `suggest()` offers a corrected query for a
+     * search that finds nothing. Off by default. */
+    didYouMean?: boolean;
     normalizationProfile?: "default-v2" | "default-v1" | "icelandic-ascii-v1";
     [key: string]: unknown;
 };
@@ -93,6 +96,12 @@ export type SearchRequest = {
     /** Field values to keep: a value, `{ in: [...] }`, or a range `{ gte, lte }` for numbers and dates. */
     filters?: Record<string, unknown>;
     facets?: string[];
+    /** Facets (also in `facets`) counted without the filter on their own field, so a list of choices
+     * keeps its other values, with counts, after one is chosen. */
+    disjunctiveFacets?: string[];
+    /** Number fields (up to eight) whose smallest and largest values across the matches to return in
+     * `facetStats`, such as a price slider's bounds. Each field's own filter is left out. */
+    facetStats?: string[];
     limit?: number;
     offset?: number;
     attributesToRetrieve?: string[];
@@ -120,8 +129,28 @@ export type SearchResponse<T> = {
     totalRelation?: "eq" | "gte";
     hasMore?: boolean;
     facets: Record<string, Record<string, number>>;
+    /** With `facetStats`: each field's smallest and largest value across the matches, without the field's
+     * own filter. A field no match has is left out. */
+    facetStats?: Record<string, {
+        min: number;
+        max: number;
+    }>;
     tookMs: number;
     sort?: string;
+    /** With the index's `didYouMean` setting: the query with the words typo tolerance corrected, when the
+     * results matched some words only by typo ("Showing results for …"), else null. */
+    didYouMean?: DidYouMean | null;
+};
+/** A corrected query. `applied`: the results are already for `q` (a search's "Showing results for");
+ * otherwise searching `q` finds results that the query didn't ("Did you mean"). `changes` lists each
+ * changed part of the query as typed. */
+export type DidYouMean = {
+    q: string;
+    applied: boolean;
+    changes: {
+        from: string;
+        to: string;
+    }[];
 };
 export type ConditionalWriteOptions = {
     expectedVersion: number;
@@ -178,6 +207,10 @@ export declare class SearchServerClient {
     } = JsonRecord>(name: string): {
         /** Searches the index; the API key needs the `search` scope. */
         search: <R = T>(query?: SearchRequest, signal?: AbortSignal) => Promise<SearchResponse<R>>;
+        /** Did you mean: for a search that found nothing, a query that finds something, or null. Takes the
+         * same request (its q, filters, and fields matter). Needs the `didYouMean` setting; not counted as
+         * a search. */
+        suggest: (query: SearchRequest, signal?: AbortSignal) => Promise<DidYouMean | null>;
         upsert: (records: T[], signal?: AbortSignal) => Promise<WriteReceipt>;
         getRecord: (objectID: string, signal?: AbortSignal) => Promise<RecordSnapshot<T>>;
         upsertOne: (record: T, options: ConditionalWriteOptions) => Promise<WriteReceipt>;

package/dist/index.js

@@ -97,6 +97,7 @@ class SearchServerClient {
     };
     return {
       search: (query = {}, signal) => request("/search", "POST", query, signal),
+      suggest: async (query, signal) => (await request("/suggest", "POST", query, signal)).didYouMean,
       upsert: (records, signal) => request("/records", "POST", { records }, signal),
       getRecord: (objectID, signal) => request(`/records/${encodeURIComponent(objectID)}`, "GET", undefined, signal),
       upsertOne: (record, options) => writeOne("upsert", record.objectID, record, options),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@findlane/server",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Findlane server SDK: upload catalogs, manage index settings, and search with a secret workspace API key.",
   "keywords": ["findlane", "search", "full-text search", "typo tolerance", "ecommerce search", "search api", "sdk"],
   "license": "MIT",