@findlane/server 0.25.0 → 0.27.0

package/dist/index.cjs

@@ -357,6 +357,7 @@ class SearchServerClient {
         productCounts: (options = {}) => report("product-counts", options),
         product: (objectID, options = {}) => report(`products/${encodeURIComponent(objectID)}`, options),
         revenue: (options = {}) => report("revenue", options),
+        filterSales: (options = {}) => report("filter-sales", options),
         banners: (options = {}) => request(`/banners?range=${options.range ?? "30d"}`, "GET", undefined, options.signal)
       },
       upsert: (records, signal) => request("/records", "POST", { records }, signal),
@@ -380,6 +381,8 @@ class SearchServerClient {
           const stage = await beginReplacement(stageId, options.signal);
           if (stage.status === "committed")
             return { acceptedRevision: stage.acceptedRevision, recordCount: stage.recordCount, replaced: true };
+          if (stage.status === "committing")
+            return await commitReplacement(stageId, stage.batchCount, stage.recordCount, options.signal);
           if (stage.status !== "open")
             throw new Error(`Stage is ${stage.status}`);
           let batch = [];

package/dist/index.d.cts

@@ -21,7 +21,12 @@ export type IndexSettings = {
     }[];
     facetFields: string[];
     filterFields?: string[];
-    typoTolerance: boolean;
+    /** Prefixes and typos match (true, the default), or not (false). `"min"` keeps only the results with the
+     * fewest typos, and `"strict"` those and the ones with one more, ranked after them, as Algolia's modes do. */
+    typoTolerance: boolean | "min" | "strict";
+    /** The last query word matches as the start of longer words from its first letter, numbers too, for search
+     * boxes that search as you type. Off by default, when words match as prefixes from 3 letters. */
+    shortPrefixes?: boolean;
     /** Words of at least `oneTypo` letters match with one typo, and of at least `twoTypos` with two.
      * `{ oneTypo: 4, twoTypos: 7 }` by default; oneTypo is 3 to 20, twoTypos from oneTypo to 50. */
     typoWordLengths?: {
@@ -691,7 +696,8 @@ export type IndexingStatus = {
 };
 export type ReplacementStage = {
     stageId: string;
-    status: "open" | "committed" | "aborted";
+    /** "committing" (0.27.0): a big stage's commit going on in steps; committing it again waits for it. */
+    status: "open" | "committing" | "committed" | "aborted";
     baseRevision: number;
     recordCount: number;
     batchCount: number;
@@ -750,6 +756,13 @@ export type ServerEvent = {
     list?: "goesWith" | "similar" | "together" | "related";
     from?: string;
     timestamp?: number;
+    /** When the search wasn't made on the store but opened from outside it: an ad, an email, or another site's
+     * link. Revenue from search leaves these clicks out. */
+    landing?: "ad" | "email" | "link";
+    /** With `landing: "ad"`: the ad's network, from its click ID or tags. */
+    network?: "google" | "microsoft" | "meta" | "tiktok" | "x" | "linkedin" | "pinterest" | "snapchat";
+    /** The filters of the search the click came from, as the search took them, for sales by filter value. */
+    filters?: Record<string, unknown>;
 } | {
     type: "addToCart";
     items: EventItem[];
@@ -1115,6 +1128,8 @@ export type RevenueQuery = {
     carts: number;
     orders: number;
     revenue: number;
+    /** Orders' value after this search when an ad, an email or another site opened it, not counted in `revenue`. */
+    openedRevenue: number;
     typed: string[];
 };
 /** A product's orders and their value, beside those found through search, and the query it was found by most. */
@@ -1126,6 +1141,7 @@ export type RevenueProduct = {
     revenue: number;
     searchOrders: number;
     searchRevenue: number;
+    openedRevenue: number;
     topQuery: string | null;
 };
 /** Revenue from search (0.20.0): purchases and add-to-carts of products the shopper clicked in search results in
@@ -1144,6 +1160,24 @@ export type RevenueReport = AnalyticsReport & {
     searchCarts: number;
     searchCartValue: number;
     searchClicks: number;
+    /** Orders and add-to-carts after searches an ad, an email or another site's link opened (0.26.0): the shopper didn't
+     * search, so they're left out of the search numbers. By kind, with the clicks on such searches. */
+    opened: {
+        orders: number;
+        revenue: number;
+        carts: number;
+        cartValue: number;
+        clicks: number;
+        byKind: Record<"ad" | "email" | "link", {
+            orders: number;
+            revenue: number;
+        }>;
+    };
+    /** Orders in the main currency cancelled or refunded since (0.27.0), which every number above leaves out, and their value. */
+    cancelled: {
+        orders: number;
+        revenue: number;
+    };
     otherCurrencies: {
         currency: string;
         orders: number;
@@ -1164,6 +1198,31 @@ export type RevenueReport = AnalyticsReport & {
     /** The products bought after a search, the most revenue from search first, up to 50. */
     products: RevenueProduct[];
 };
+/** A filter value's clicks on results while it was chosen, and the add-to-carts, orders and revenue of the products
+ * clicked. */
+export type FilterValueSales = {
+    value: string;
+    clicks: number;
+    carts: number;
+    orders: number;
+    revenue: number;
+};
+/** Sales by filter value (0.26.0): for each facet field, the values shoppers filtered on, on searches and on category
+ * pages apart, attributed as revenue from search is. A click with several values counts for each. From when clicks
+ * started carrying filters (`since`). */
+export type FilterSalesReport = AnalyticsReport & {
+    computedAt: string;
+    since: string;
+    currency: string | null;
+    fields: {
+        field: string;
+        search: FilterValueSales[];
+        page: FilterValueSales[];
+    }[];
+    /** Searches without filters, to compare with. */
+    unfiltered: Omit<FilterValueSales, "value">;
+    visitorIds: boolean;
+};
 export declare class FindlaneError extends Error {
     status: number;
     constructor(status: number, message: string);
@@ -1351,6 +1410,8 @@ export declare class SearchServerClient {
             /** Revenue from search: orders and add-to-carts of products found through search, per query and per
              * product (0.20.0). */
             revenue: (options?: Omit<AnalyticsOptions, "source">) => Promise<RevenueReport>;
+            /** Sales by filter value: each facet value's clicks, add-to-carts, orders and revenue (0.26.0). */
+            filterSales: (options?: Omit<AnalyticsOptions, "source">) => Promise<FilterSalesReport>;
             /** Each banner's shown (shoppers' searches that showed it, cache answers included) and clicks, by its rule,
              * over the last 7, 30 (by default) or 90 days (0.23.0). */
             banners: (options?: {
@@ -1557,6 +1618,8 @@ export declare class SearchServerClient {
                 /** Revenue from search: orders and add-to-carts of products found through search, per query and per
                  * product (0.20.0). */
                 revenue: (options?: Omit<AnalyticsOptions, "source">) => Promise<RevenueReport>;
+                /** Sales by filter value: each facet value's clicks, add-to-carts, orders and revenue (0.26.0). */
+                filterSales: (options?: Omit<AnalyticsOptions, "source">) => Promise<FilterSalesReport>;
                 /** Each banner's shown (shoppers' searches that showed it, cache answers included) and clicks, by its rule,
                  * over the last 7, 30 (by default) or 90 days (0.23.0). */
                 banners: (options?: {
@@ -1761,6 +1824,8 @@ export declare class SearchServerClient {
                     /** Revenue from search: orders and add-to-carts of products found through search, per query and per
                      * product (0.20.0). */
                     revenue: (options?: Omit<AnalyticsOptions, "source">) => Promise<RevenueReport>;
+                    /** Sales by filter value: each facet value's clicks, add-to-carts, orders and revenue (0.26.0). */
+                    filterSales: (options?: Omit<AnalyticsOptions, "source">) => Promise<FilterSalesReport>;
                     /** Each banner's shown (shoppers' searches that showed it, cache answers included) and clicks, by its rule,
                      * over the last 7, 30 (by default) or 90 days (0.23.0). */
                     banners: (options?: {
@@ -1965,6 +2030,8 @@ export declare class SearchServerClient {
                         /** Revenue from search: orders and add-to-carts of products found through search, per query and per
                          * product (0.20.0). */
                         revenue: (options?: Omit<AnalyticsOptions, "source">) => Promise<RevenueReport>;
+                        /** Sales by filter value: each facet value's clicks, add-to-carts, orders and revenue (0.26.0). */
+                        filterSales: (options?: Omit<AnalyticsOptions, "source">) => Promise<FilterSalesReport>;
                         /** Each banner's shown (shoppers' searches that showed it, cache answers included) and clicks, by its rule,
                          * over the last 7, 30 (by default) or 90 days (0.23.0). */
                         banners: (options?: {
@@ -2169,6 +2236,8 @@ export declare class SearchServerClient {
                             /** Revenue from search: orders and add-to-carts of products found through search, per query and per
                              * product (0.20.0). */
                             revenue: (options?: Omit<AnalyticsOptions, "source">) => Promise<RevenueReport>;
+                            /** Sales by filter value: each facet value's clicks, add-to-carts, orders and revenue (0.26.0). */
+                            filterSales: (options?: Omit<AnalyticsOptions, "source">) => Promise<FilterSalesReport>;
                             /** Each banner's shown (shoppers' searches that showed it, cache answers included) and clicks, by its rule,
                              * over the last 7, 30 (by default) or 90 days (0.23.0). */
                             banners: (options?: {
@@ -2373,6 +2442,8 @@ export declare class SearchServerClient {
                                 /** Revenue from search: orders and add-to-carts of products found through search, per query and per
                                  * product (0.20.0). */
                                 revenue: (options?: Omit<AnalyticsOptions, "source">) => Promise<RevenueReport>;
+                                /** Sales by filter value: each facet value's clicks, add-to-carts, orders and revenue (0.26.0). */
+                                filterSales: (options?: Omit<AnalyticsOptions, "source">) => Promise<FilterSalesReport>;
                                 /** Each banner's shown (shoppers' searches that showed it, cache answers included) and clicks, by its rule,
                                  * over the last 7, 30 (by default) or 90 days (0.23.0). */
                                 banners: (options?: {
@@ -2577,6 +2648,8 @@ export declare class SearchServerClient {
                                     /** Revenue from search: orders and add-to-carts of products found through search, per query and per
                                      * product (0.20.0). */
                                     revenue: (options?: Omit<AnalyticsOptions, "source">) => Promise<RevenueReport>;
+                                    /** Sales by filter value: each facet value's clicks, add-to-carts, orders and revenue (0.26.0). */
+                                    filterSales: (options?: Omit<AnalyticsOptions, "source">) => Promise<FilterSalesReport>;
                                     /** Each banner's shown (shoppers' searches that showed it, cache answers included) and clicks, by its rule,
                                      * over the last 7, 30 (by default) or 90 days (0.23.0). */
                                     banners: (options?: {
@@ -2781,6 +2854,8 @@ export declare class SearchServerClient {
                                         /** Revenue from search: orders and add-to-carts of products found through search, per query and per
                                          * product (0.20.0). */
                                         revenue: (options?: Omit<AnalyticsOptions, "source">) => Promise<RevenueReport>;
+                                        /** Sales by filter value: each facet value's clicks, add-to-carts, orders and revenue (0.26.0). */
+                                        filterSales: (options?: Omit<AnalyticsOptions, "source">) => Promise<FilterSalesReport>;
                                         /** Each banner's shown (shoppers' searches that showed it, cache answers included) and clicks, by its rule,
                                          * over the last 7, 30 (by default) or 90 days (0.23.0). */
                                         banners: (options?: {
@@ -2985,6 +3060,8 @@ export declare class SearchServerClient {
                                             /** Revenue from search: orders and add-to-carts of products found through search, per query and per
                                              * product (0.20.0). */
                                             revenue: (options?: Omit<AnalyticsOptions, "source">) => Promise<RevenueReport>;
+                                            /** Sales by filter value: each facet value's clicks, add-to-carts, orders and revenue (0.26.0). */
+                                            filterSales: (options?: Omit<AnalyticsOptions, "source">) => Promise<FilterSalesReport>;
                                             /** Each banner's shown (shoppers' searches that showed it, cache answers included) and clicks, by its rule,
                                              * over the last 7, 30 (by default) or 90 days (0.23.0). */
                                             banners: (options?: {
@@ -3189,6 +3266,8 @@ export declare class SearchServerClient {
                                                 /** Revenue from search: orders and add-to-carts of products found through search, per query and per
                                                  * product (0.20.0). */
                                                 revenue: (options?: Omit<AnalyticsOptions, "source">) => Promise<RevenueReport>;
+                                                /** Sales by filter value: each facet value's clicks, add-to-carts, orders and revenue (0.26.0). */
+                                                filterSales: (options?: Omit<AnalyticsOptions, "source">) => Promise<FilterSalesReport>;
                                                 /** Each banner's shown (shoppers' searches that showed it, cache answers included) and clicks, by its rule,
                                                  * over the last 7, 30 (by default) or 90 days (0.23.0). */
                                                 banners: (options?: {
@@ -3393,6 +3472,8 @@ export declare class SearchServerClient {
                                                     /** Revenue from search: orders and add-to-carts of products found through search, per query and per
                                                      * product (0.20.0). */
                                                     revenue: (options?: Omit<AnalyticsOptions, "source">) => Promise<RevenueReport>;
+                                                    /** Sales by filter value: each facet value's clicks, add-to-carts, orders and revenue (0.26.0). */
+                                                    filterSales: (options?: Omit<AnalyticsOptions, "source">) => Promise<FilterSalesReport>;
                                                     /** Each banner's shown (shoppers' searches that showed it, cache answers included) and clicks, by its rule,
                                                      * over the last 7, 30 (by default) or 90 days (0.23.0). */
                                                     banners: (options?: {

package/dist/index.d.ts

@@ -21,7 +21,12 @@ export type IndexSettings = {
     }[];
     facetFields: string[];
     filterFields?: string[];
-    typoTolerance: boolean;
+    /** Prefixes and typos match (true, the default), or not (false). `"min"` keeps only the results with the
+     * fewest typos, and `"strict"` those and the ones with one more, ranked after them, as Algolia's modes do. */
+    typoTolerance: boolean | "min" | "strict";
+    /** The last query word matches as the start of longer words from its first letter, numbers too, for search
+     * boxes that search as you type. Off by default, when words match as prefixes from 3 letters. */
+    shortPrefixes?: boolean;
     /** Words of at least `oneTypo` letters match with one typo, and of at least `twoTypos` with two.
      * `{ oneTypo: 4, twoTypos: 7 }` by default; oneTypo is 3 to 20, twoTypos from oneTypo to 50. */
     typoWordLengths?: {
@@ -691,7 +696,8 @@ export type IndexingStatus = {
 };
 export type ReplacementStage = {
     stageId: string;
-    status: "open" | "committed" | "aborted";
+    /** "committing" (0.27.0): a big stage's commit going on in steps; committing it again waits for it. */
+    status: "open" | "committing" | "committed" | "aborted";
     baseRevision: number;
     recordCount: number;
     batchCount: number;
@@ -750,6 +756,13 @@ export type ServerEvent = {
     list?: "goesWith" | "similar" | "together" | "related";
     from?: string;
     timestamp?: number;
+    /** When the search wasn't made on the store but opened from outside it: an ad, an email, or another site's
+     * link. Revenue from search leaves these clicks out. */
+    landing?: "ad" | "email" | "link";
+    /** With `landing: "ad"`: the ad's network, from its click ID or tags. */
+    network?: "google" | "microsoft" | "meta" | "tiktok" | "x" | "linkedin" | "pinterest" | "snapchat";
+    /** The filters of the search the click came from, as the search took them, for sales by filter value. */
+    filters?: Record<string, unknown>;
 } | {
     type: "addToCart";
     items: EventItem[];
@@ -1115,6 +1128,8 @@ export type RevenueQuery = {
     carts: number;
     orders: number;
     revenue: number;
+    /** Orders' value after this search when an ad, an email or another site opened it, not counted in `revenue`. */
+    openedRevenue: number;
     typed: string[];
 };
 /** A product's orders and their value, beside those found through search, and the query it was found by most. */
@@ -1126,6 +1141,7 @@ export type RevenueProduct = {
     revenue: number;
     searchOrders: number;
     searchRevenue: number;
+    openedRevenue: number;
     topQuery: string | null;
 };
 /** Revenue from search (0.20.0): purchases and add-to-carts of products the shopper clicked in search results in
@@ -1144,6 +1160,24 @@ export type RevenueReport = AnalyticsReport & {
     searchCarts: number;
     searchCartValue: number;
     searchClicks: number;
+    /** Orders and add-to-carts after searches an ad, an email or another site's link opened (0.26.0): the shopper didn't
+     * search, so they're left out of the search numbers. By kind, with the clicks on such searches. */
+    opened: {
+        orders: number;
+        revenue: number;
+        carts: number;
+        cartValue: number;
+        clicks: number;
+        byKind: Record<"ad" | "email" | "link", {
+            orders: number;
+            revenue: number;
+        }>;
+    };
+    /** Orders in the main currency cancelled or refunded since (0.27.0), which every number above leaves out, and their value. */
+    cancelled: {
+        orders: number;
+        revenue: number;
+    };
     otherCurrencies: {
         currency: string;
         orders: number;
@@ -1164,6 +1198,31 @@ export type RevenueReport = AnalyticsReport & {
     /** The products bought after a search, the most revenue from search first, up to 50. */
     products: RevenueProduct[];
 };
+/** A filter value's clicks on results while it was chosen, and the add-to-carts, orders and revenue of the products
+ * clicked. */
+export type FilterValueSales = {
+    value: string;
+    clicks: number;
+    carts: number;
+    orders: number;
+    revenue: number;
+};
+/** Sales by filter value (0.26.0): for each facet field, the values shoppers filtered on, on searches and on category
+ * pages apart, attributed as revenue from search is. A click with several values counts for each. From when clicks
+ * started carrying filters (`since`). */
+export type FilterSalesReport = AnalyticsReport & {
+    computedAt: string;
+    since: string;
+    currency: string | null;
+    fields: {
+        field: string;
+        search: FilterValueSales[];
+        page: FilterValueSales[];
+    }[];
+    /** Searches without filters, to compare with. */
+    unfiltered: Omit<FilterValueSales, "value">;
+    visitorIds: boolean;
+};
 export declare class FindlaneError extends Error {
     status: number;
     constructor(status: number, message: string);
@@ -1351,6 +1410,8 @@ export declare class SearchServerClient {
             /** Revenue from search: orders and add-to-carts of products found through search, per query and per
              * product (0.20.0). */
             revenue: (options?: Omit<AnalyticsOptions, "source">) => Promise<RevenueReport>;
+            /** Sales by filter value: each facet value's clicks, add-to-carts, orders and revenue (0.26.0). */
+            filterSales: (options?: Omit<AnalyticsOptions, "source">) => Promise<FilterSalesReport>;
             /** Each banner's shown (shoppers' searches that showed it, cache answers included) and clicks, by its rule,
              * over the last 7, 30 (by default) or 90 days (0.23.0). */
             banners: (options?: {
@@ -1557,6 +1618,8 @@ export declare class SearchServerClient {
                 /** Revenue from search: orders and add-to-carts of products found through search, per query and per
                  * product (0.20.0). */
                 revenue: (options?: Omit<AnalyticsOptions, "source">) => Promise<RevenueReport>;
+                /** Sales by filter value: each facet value's clicks, add-to-carts, orders and revenue (0.26.0). */
+                filterSales: (options?: Omit<AnalyticsOptions, "source">) => Promise<FilterSalesReport>;
                 /** Each banner's shown (shoppers' searches that showed it, cache answers included) and clicks, by its rule,
                  * over the last 7, 30 (by default) or 90 days (0.23.0). */
                 banners: (options?: {
@@ -1761,6 +1824,8 @@ export declare class SearchServerClient {
                     /** Revenue from search: orders and add-to-carts of products found through search, per query and per
                      * product (0.20.0). */
                     revenue: (options?: Omit<AnalyticsOptions, "source">) => Promise<RevenueReport>;
+                    /** Sales by filter value: each facet value's clicks, add-to-carts, orders and revenue (0.26.0). */
+                    filterSales: (options?: Omit<AnalyticsOptions, "source">) => Promise<FilterSalesReport>;
                     /** Each banner's shown (shoppers' searches that showed it, cache answers included) and clicks, by its rule,
                      * over the last 7, 30 (by default) or 90 days (0.23.0). */
                     banners: (options?: {
@@ -1965,6 +2030,8 @@ export declare class SearchServerClient {
                         /** Revenue from search: orders and add-to-carts of products found through search, per query and per
                          * product (0.20.0). */
                         revenue: (options?: Omit<AnalyticsOptions, "source">) => Promise<RevenueReport>;
+                        /** Sales by filter value: each facet value's clicks, add-to-carts, orders and revenue (0.26.0). */
+                        filterSales: (options?: Omit<AnalyticsOptions, "source">) => Promise<FilterSalesReport>;
                         /** Each banner's shown (shoppers' searches that showed it, cache answers included) and clicks, by its rule,
                          * over the last 7, 30 (by default) or 90 days (0.23.0). */
                         banners: (options?: {
@@ -2169,6 +2236,8 @@ export declare class SearchServerClient {
                             /** Revenue from search: orders and add-to-carts of products found through search, per query and per
                              * product (0.20.0). */
                             revenue: (options?: Omit<AnalyticsOptions, "source">) => Promise<RevenueReport>;
+                            /** Sales by filter value: each facet value's clicks, add-to-carts, orders and revenue (0.26.0). */
+                            filterSales: (options?: Omit<AnalyticsOptions, "source">) => Promise<FilterSalesReport>;
                             /** Each banner's shown (shoppers' searches that showed it, cache answers included) and clicks, by its rule,
                              * over the last 7, 30 (by default) or 90 days (0.23.0). */
                             banners: (options?: {
@@ -2373,6 +2442,8 @@ export declare class SearchServerClient {
                                 /** Revenue from search: orders and add-to-carts of products found through search, per query and per
                                  * product (0.20.0). */
                                 revenue: (options?: Omit<AnalyticsOptions, "source">) => Promise<RevenueReport>;
+                                /** Sales by filter value: each facet value's clicks, add-to-carts, orders and revenue (0.26.0). */
+                                filterSales: (options?: Omit<AnalyticsOptions, "source">) => Promise<FilterSalesReport>;
                                 /** Each banner's shown (shoppers' searches that showed it, cache answers included) and clicks, by its rule,
                                  * over the last 7, 30 (by default) or 90 days (0.23.0). */
                                 banners: (options?: {
@@ -2577,6 +2648,8 @@ export declare class SearchServerClient {
                                     /** Revenue from search: orders and add-to-carts of products found through search, per query and per
                                      * product (0.20.0). */
                                     revenue: (options?: Omit<AnalyticsOptions, "source">) => Promise<RevenueReport>;
+                                    /** Sales by filter value: each facet value's clicks, add-to-carts, orders and revenue (0.26.0). */
+                                    filterSales: (options?: Omit<AnalyticsOptions, "source">) => Promise<FilterSalesReport>;
                                     /** Each banner's shown (shoppers' searches that showed it, cache answers included) and clicks, by its rule,
                                      * over the last 7, 30 (by default) or 90 days (0.23.0). */
                                     banners: (options?: {
@@ -2781,6 +2854,8 @@ export declare class SearchServerClient {
                                         /** Revenue from search: orders and add-to-carts of products found through search, per query and per
                                          * product (0.20.0). */
                                         revenue: (options?: Omit<AnalyticsOptions, "source">) => Promise<RevenueReport>;
+                                        /** Sales by filter value: each facet value's clicks, add-to-carts, orders and revenue (0.26.0). */
+                                        filterSales: (options?: Omit<AnalyticsOptions, "source">) => Promise<FilterSalesReport>;
                                         /** Each banner's shown (shoppers' searches that showed it, cache answers included) and clicks, by its rule,
                                          * over the last 7, 30 (by default) or 90 days (0.23.0). */
                                         banners: (options?: {
@@ -2985,6 +3060,8 @@ export declare class SearchServerClient {
                                             /** Revenue from search: orders and add-to-carts of products found through search, per query and per
                                              * product (0.20.0). */
                                             revenue: (options?: Omit<AnalyticsOptions, "source">) => Promise<RevenueReport>;
+                                            /** Sales by filter value: each facet value's clicks, add-to-carts, orders and revenue (0.26.0). */
+                                            filterSales: (options?: Omit<AnalyticsOptions, "source">) => Promise<FilterSalesReport>;
                                             /** Each banner's shown (shoppers' searches that showed it, cache answers included) and clicks, by its rule,
                                              * over the last 7, 30 (by default) or 90 days (0.23.0). */
                                             banners: (options?: {
@@ -3189,6 +3266,8 @@ export declare class SearchServerClient {
                                                 /** Revenue from search: orders and add-to-carts of products found through search, per query and per
                                                  * product (0.20.0). */
                                                 revenue: (options?: Omit<AnalyticsOptions, "source">) => Promise<RevenueReport>;
+                                                /** Sales by filter value: each facet value's clicks, add-to-carts, orders and revenue (0.26.0). */
+                                                filterSales: (options?: Omit<AnalyticsOptions, "source">) => Promise<FilterSalesReport>;
                                                 /** Each banner's shown (shoppers' searches that showed it, cache answers included) and clicks, by its rule,
                                                  * over the last 7, 30 (by default) or 90 days (0.23.0). */
                                                 banners: (options?: {
@@ -3393,6 +3472,8 @@ export declare class SearchServerClient {
                                                     /** Revenue from search: orders and add-to-carts of products found through search, per query and per
                                                      * product (0.20.0). */
                                                     revenue: (options?: Omit<AnalyticsOptions, "source">) => Promise<RevenueReport>;
+                                                    /** Sales by filter value: each facet value's clicks, add-to-carts, orders and revenue (0.26.0). */
+                                                    filterSales: (options?: Omit<AnalyticsOptions, "source">) => Promise<FilterSalesReport>;
                                                     /** Each banner's shown (shoppers' searches that showed it, cache answers included) and clicks, by its rule,
                                                      * over the last 7, 30 (by default) or 90 days (0.23.0). */
                                                     banners: (options?: {

package/dist/index.js

@@ -311,6 +311,7 @@ class SearchServerClient {
         productCounts: (options = {}) => report("product-counts", options),
         product: (objectID, options = {}) => report(`products/${encodeURIComponent(objectID)}`, options),
         revenue: (options = {}) => report("revenue", options),
+        filterSales: (options = {}) => report("filter-sales", options),
         banners: (options = {}) => request(`/banners?range=${options.range ?? "30d"}`, "GET", undefined, options.signal)
       },
       upsert: (records, signal) => request("/records", "POST", { records }, signal),
@@ -334,6 +335,8 @@ class SearchServerClient {
           const stage = await beginReplacement(stageId, options.signal);
           if (stage.status === "committed")
             return { acceptedRevision: stage.acceptedRevision, recordCount: stage.recordCount, replaced: true };
+          if (stage.status === "committing")
+            return await commitReplacement(stageId, stage.batchCount, stage.recordCount, options.signal);
           if (stage.status !== "open")
             throw new Error(`Stage is ${stage.status}`);
           let batch = [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@findlane/server",
-  "version": "0.25.0",
+  "version": "0.27.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",