@artsy/cohesion 4.395.0 → 4.396.0

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+# v4.396.0 (Thu Sep 03 2026)
+
+#### 🚀  Enhancement
+
+- feat: add suggestedFilters tracking [#743](https://github.com/artsy/cohesion/pull/743) ([@egdbear](https://github.com/egdbear))
+
+#### Authors: 1
+
+- Dejan ([@egdbear](https://github.com/egdbear))
+
+---
+
 # v4.395.0 (Fri Aug 28 2026)
 
 #### 🚀  Enhancement

package/dist/Schema/Events/SavedSearch.d.ts

@@ -68,7 +68,8 @@ export interface DeletedSavedSearch {
     saved_search_id?: string;
 }
 /**
- * User taps on a suggested saved search pill
+ * User taps on a suggested filter pill, either while creating an alert or from
+ * the suggested filter row in search
  *
  * This schema describes events sent to Segment from [[selectedSuggestedFilter]]
  *
@@ -80,9 +81,23 @@ export interface DeletedSavedSearch {
  *    subject: "additionalGeneIDs",
  *  }
  * ```
+ *
+ *  @example
+ *  ```
+ *  {
+ *    action: "selectedSuggestedFilter",
+ *    context_module: "suggestedFilters",
+ *    filters: "{\"additionalGeneIDs\":[\"prints\"],\"priceRange\":\"*-5000\"}",
+ *    query: "warhol prints under 5000"
+ *  }
+ * ```
  */
 export interface SelectedSuggestedFilter {
     action: ActionType.selectedSuggestedFilter;
-    context_module: "createAlert" | "editAlert";
+    context_module: "createAlert" | "editAlert" | "suggestedFilters";
     subject?: string;
+    /** Search only: the filters the query was parsed into, JSON encoded */
+    filters?: string;
+    /** Search only: what the user typed */
+    query?: string;
 }

package/dist/Schema/Events/Search.d.ts

@@ -147,6 +147,32 @@ export interface SearchedWithResults {
     destination_owner_type?: PageOwnerType;
     query: string;
 }
+/**
+ * A user is shown a suggested filter row for what they typed into search
+ *
+ * This schema describes events sent to Segment from [[searchedWithSuggestedFilter]]
+ *
+ *  @example
+ *  ```
+ *  {
+ *    action: "searchedWithSuggestedFilter",
+ *    context_module: "suggestedFilters",
+ *    context_owner_type: "home",
+ *    filters: "{\"additionalGeneIDs\":[\"prints\"],\"priceRange\":\"*-5000\"}",
+ *    query: "warhol prints under 5000"
+ *  }
+ * ```
+ */
+export interface SearchedWithSuggestedFilter {
+    action: ActionType.searchedWithSuggestedFilter;
+    context_module: ContextModule;
+    context_owner_type: PageOwnerType;
+    context_owner_id?: string;
+    context_owner_slug?: string;
+    /** The filters the query was parsed into, JSON encoded */
+    filters: string;
+    query: string;
+}
 /**
  * A user queries the Artsy Price Database, including the artist_id, string queried, and applied filters
  *

package/dist/Schema/Events/index.d.ts

@@ -22,7 +22,7 @@ import { PromptForReview } from "./PromptForReview";
 import { SavedPriceRange } from "./SavedPriceRange";
 import { DeletedSavedSearch, EditedAlert, EditedSavedSearch } from "./SavedSearch";
 import { FollowEvents } from "./SavesAndFollows";
-import { AddressAutoCompletionResult, ConsignmentArtistFailed, EditedAutocompletedAddress, FocusedOnPriceDatabaseSearchInput, FocusedOnSearchInput, PastedIntoSearchInput, SearchedPriceDatabase, SearchedWithNoResults, SearchedWithResults, SelectedItemFromAddressAutoCompletion, SelectedItemFromPriceDatabaseSearch, SelectedItemFromSearch, SelectedItemFromSearchPage, SelectedSearchSuggestionQuickNavigationItem } from "./Search";
+import { AddressAutoCompletionResult, ConsignmentArtistFailed, EditedAutocompletedAddress, FocusedOnPriceDatabaseSearchInput, FocusedOnSearchInput, PastedIntoSearchInput, SearchedPriceDatabase, SearchedWithNoResults, SearchedWithResults, SearchedWithSuggestedFilter, SelectedItemFromAddressAutoCompletion, SelectedItemFromPriceDatabaseSearch, SelectedItemFromSearch, SelectedItemFromSearchPage, SelectedSearchSuggestionQuickNavigationItem } from "./Search";
 import { DarkModeOptionUpdated } from "./Settings";
 import { ClickedOpenInNewTabButton, ClickedShareButton, Share } from "./Share";
 import { SwipedInfiniteDiscoveryArtwork, SwipedUp } from "./Swipe";
@@ -37,7 +37,7 @@ import { ViewedVideo } from "./Video";
  *
  * Each event describes one ActionType
  */
-export type Event = AcceptedOffer | AddCollectedArtwork | AddedArtworkToArtworkList | AddedToAlbum | AddressAutoCompletionResult | AddToCalendar | ArtworkDetailsCompleted | AuctionPageView | AuctionResultsFilterParamsChanged | AuthImpression | BannerViewed | BidPageView | CheckedAccountBalance | ClickedActiveBid | ClickedActivityPanelNotificationItem | ClickedActivityPanelTab | ClickedAddFilters | ClickedAddMissingArtworksDetails | ClickedAddNewShippingAddress | ClickedAddWorksToFair | ClickedAlertsFilters | ClickedAppDownload | ClickedArticleGroup | ClickedArtistArtworkImage | ClickedArtistGroup | ClickedArtistSeriesGroup | ClickedArtworkGroup | ClickedAskSpecialist | ClickedAuctionGroup | ClickedAuctionResultItem | ClickedBid | ClickedBuyerProtection | ClickedBuyNow | ClickedCancelExpressCheckout | ClickedChangeOfferOption | ClickedChangePage | ClickedChangePaymentMethod | ClickedChangeShippingAddress | ClickedChangeShippingMethod | ClickedCloseValidationAddressModal | ClickedCollectionGroup | ClickedCompleteYourProfile | ClickedContactGallery | ClickedConversationsFilter | ClickedCounterOfferOption | ClickedCreateAlert | ClickedCV | ClickedDeliveryMethod | ClickedDismissInquiry | ClickedDownloadAppFooter | ClickedDownloadAppHeader | ClickedEditArtwork | ClickedEditAlert | ClickedEditShippingAddress | ClickedEstimateShippingCost | ClickedExpandFilterPanel | ClickedExpansionToggle | ClickedExpressCheckout | ClickedFairCard | ClickedFairGroup | ClickedFulfillmentTab | ClickedGalleryGroup | ClickedGene | ClickedHeader | ClickedHeroUnitGroup | ClickedImmersiveView | ClickedImportFees | ClickedLoadMore | ClickedMainArtworkGrid | ClickedMakeOffer | ClickedMarketingModal | ClickedMarkSold | ClickedMarkSpam | ClickedNavBar | ClickedNavigationTab | ClickedNotificationsBell | ClickedOfferActions | ClickedOfferOption | ClickedOnArtworkShippingUnitsDropdown | ClickedOnArtworkShippingWeight | ClickedOnBuyNowCheckbox | ClickedOnDuplicateArtwork | ClickedOnFramedMeasurements | ClickedOnFramedMeasurementsDropdown | ClickedOnLearnMore | ClickedOnMakeOfferCheckbox | ClickedOnPagination | ClickedOnPriceDisplayDropdown | ClickedOnReadMore | ClickedOrderArtworkImage | ClickedOrderPage | ClickedOrderProgression | ClickedOrderSummary | ClickedOpenInNewTabButton | ClickedPartnerCard | ClickedPartnerLink | ClickedPaymentDetails | ClickedPaymentMethod | ClickedPromoSpace | ClickedPublish | ClickedRegisterToBid | ClickedSaveAsTemplate | ClickedSelectShippingOption | ClickedSendPartnerOffer | ClickedShareButton | ClickedShippingAddress | ClickedShowGroup | ClickedShowMore | ClickedSnooze | ClickedStartPartnerOffer | ClickedTermsAndConditions | ClickedUpdateArtwork | ClickedUploadArtwork | ClickedValidationAddressOptions | ClickedVerifyIdentity | ClickedViewingRoomCard | ClickedViewWork | ClickedVisitHelpCenter | CommercialFilterParamsChanged | CommercialFilterSelectedAll | CompletedOfflineSync | CompletedOnboarding | ConfirmBid | ConfirmRegistrationPageview | ConsignmentArtistFailed | ConsignmentSubmitted | ContactInformationCompleted | CreatedAccount | CreateAlertReminderMessageViewed | CreatedAlbum | CreatedArtworkList | DarkModeOptionUpdated | DeclinedOffer | DeleteCollectedArtwork | DeletedArtworkList | DeletedSavedSearch | EditCollectedArtwork | EditedAlert | EditedArtworkList | EditedAutocompletedAddress | EditedSavedSearch | EditedUserProfile | EditProfileModalViewed | EnterLiveAuction | ErrorMessageViewed | ExperimentViewed | ExpressCheckoutViewed | FocusedOnConversationMessageInput | FocusedOnPriceDatabaseSearchInput | FocusedOnSearchInput | FollowEvents | Impression | ImmersiveViewArtworkDisplayed | ImmersiveViewOptionViewed | ItemViewed | MaxBidSelected | MyCollectionOnboardingCompleted | NavigationDropdownViewed | NewPaymentMethodViewed | OnboardingUserInputData | OrderDetailsViewed | OrderProgressionViewed | PartnerOfferInConversationViewed | PastedIntoSearchInput | PriceDatabaseFilterParamsChanged | PromptForReview | RailViewed | RegistrationPageView | RegistrationSubmitted | ResetYourPassword | SaleScreenLoadComplete | SaveCollectedArtwork | SavedAddressViewed | SavedCookieConsentPreferences | SavedPaymentMethodViewed | SavedPriceRange | Screen | SearchedPriceDatabase | SearchedWithNoResults | SearchedWithResults | SelectedItemFromAddressAutoCompletion | SelectedItemFromPriceDatabaseSearch | SelectedItemFromSearch | SelectedItemFromSearchPage | SelectedFromDrawer | SelectedRecentPriceRange | SelectedSearchSuggestionQuickNavigationItem | SendOffersBannerViewed | SendOffersErrorMessage | SendOffersModalViewed | SentConsignmentInquiry | SentContent | SentConversationMessage | SentRequestPriceEstimate | Share | ShippingEstimateViewed | ShippingQuoteViewed | StartedOnboarding | SubmitAnotherArtwork | SubmittedCounterOffer | SubmittedOffer | SubmittedOrder | SuccessfullyLoggedIn | SwipedInfiniteDiscoveryArtwork | SwipedUp | Tapped3Dots | TappedActivityGroup | TappedAlertsGroup | TappedArticleGroup | TappedArticleShare | TappedArtistGroup | TappedArtistSeriesGroup | TappedArtworkGroup | TappedArtworkList | TappedAskSpecialist | TappedAuctionGroup | TappedAuctionResultGroup | TappedBid | TappedBrowseSimilarArtworks | TappedBuyerProtection | TappedBuyNow | TappedCardGroup | TappedChangePaymentMethod | TappedClearTask | TappedCollectedArtwork | TappedCollectedArtworkImages | TappedCollectionGroup | TappedCompleteYourProfile | TappedConfirmSeeFewerWorks | TappedConsign | TappedConsignmentInquiry | TappedContactGallery | TappedCreateAlert | TappedEditedProfile | TappedExploreGroup | TappedExploreMyCollection | TappedFairCard | TappedFairGroup | TappedFollowsGroup | TappedGlobalSearchBar | TappedImportFees | TappedInboxConversation | TappedInfoBubble | TappedLearnMore | TappedLink | TappedMainArtworkGrid | TappedMakeOffer | TappedMenuItemGroup | TappedMyCollection | TappedMyCollectionAddArtworkArtist | TappedMyCollectionInsightsMedianAuctionPriceChartCareerHighlight | TappedMyCollectionInsightsMedianAuctionPriceChartCategory | TappedMyCollectionInsightsMedianAuctionPriceChartTimeframe | TappedMyCollectionInsightsMedianAuctionRailItem | TappedNavigationPillsGroup | TappedNavigationTab | TappedNewArtworkList | TappedNotificationsBell | TappedOfferSettings | TappedOrderArtworkImage | TappedPartnerCard | TappedProductCapabilitiesGroup | TappedPromoSpace | TappedRequestPriceEstimate | TappedSeeFewerWorks | TappedSell | TappedSellArtwork | TappedShare | TappedShowMore | TappedSkip | TappedTabBar | TappedTaskGroup | TappedVerifyIdentity | TappedViewingRoomCard | TappedViewingRoomGroup | TappedViewOffer | TappedViewWork | TappedVisitHelpCenter | TimeOnPage | ToggledAccordion | ToggledArtistBio | ToggledCollapsibleOrderSummary | ToggledNotification | ToggledOfferHistory | ToggledPresentationModeSetting | ToggledSavedSearch | TooltipViewed | ProgressiveOnboardingTooltipViewed | UploadPhotosCompleted | UploadSizeLimitExceeded | ValidationAddressViewed | ViewArtworkMyCollection | ViewedArtworkList | ViewedSharedArtworkList | ViewedVideo | ViewedToast | VisitMyCollection | VisitMyCollectionOnboardingSlide;
+export type Event = AcceptedOffer | AddCollectedArtwork | AddedArtworkToArtworkList | AddedToAlbum | AddressAutoCompletionResult | AddToCalendar | ArtworkDetailsCompleted | AuctionPageView | AuctionResultsFilterParamsChanged | AuthImpression | BannerViewed | BidPageView | CheckedAccountBalance | ClickedActiveBid | ClickedActivityPanelNotificationItem | ClickedActivityPanelTab | ClickedAddFilters | ClickedAddMissingArtworksDetails | ClickedAddNewShippingAddress | ClickedAddWorksToFair | ClickedAlertsFilters | ClickedAppDownload | ClickedArticleGroup | ClickedArtistArtworkImage | ClickedArtistGroup | ClickedArtistSeriesGroup | ClickedArtworkGroup | ClickedAskSpecialist | ClickedAuctionGroup | ClickedAuctionResultItem | ClickedBid | ClickedBuyerProtection | ClickedBuyNow | ClickedCancelExpressCheckout | ClickedChangeOfferOption | ClickedChangePage | ClickedChangePaymentMethod | ClickedChangeShippingAddress | ClickedChangeShippingMethod | ClickedCloseValidationAddressModal | ClickedCollectionGroup | ClickedCompleteYourProfile | ClickedContactGallery | ClickedConversationsFilter | ClickedCounterOfferOption | ClickedCreateAlert | ClickedCV | ClickedDeliveryMethod | ClickedDismissInquiry | ClickedDownloadAppFooter | ClickedDownloadAppHeader | ClickedEditArtwork | ClickedEditAlert | ClickedEditShippingAddress | ClickedEstimateShippingCost | ClickedExpandFilterPanel | ClickedExpansionToggle | ClickedExpressCheckout | ClickedFairCard | ClickedFairGroup | ClickedFulfillmentTab | ClickedGalleryGroup | ClickedGene | ClickedHeader | ClickedHeroUnitGroup | ClickedImmersiveView | ClickedImportFees | ClickedLoadMore | ClickedMainArtworkGrid | ClickedMakeOffer | ClickedMarketingModal | ClickedMarkSold | ClickedMarkSpam | ClickedNavBar | ClickedNavigationTab | ClickedNotificationsBell | ClickedOfferActions | ClickedOfferOption | ClickedOnArtworkShippingUnitsDropdown | ClickedOnArtworkShippingWeight | ClickedOnBuyNowCheckbox | ClickedOnDuplicateArtwork | ClickedOnFramedMeasurements | ClickedOnFramedMeasurementsDropdown | ClickedOnLearnMore | ClickedOnMakeOfferCheckbox | ClickedOnPagination | ClickedOnPriceDisplayDropdown | ClickedOnReadMore | ClickedOrderArtworkImage | ClickedOrderPage | ClickedOrderProgression | ClickedOrderSummary | ClickedOpenInNewTabButton | ClickedPartnerCard | ClickedPartnerLink | ClickedPaymentDetails | ClickedPaymentMethod | ClickedPromoSpace | ClickedPublish | ClickedRegisterToBid | ClickedSaveAsTemplate | ClickedSelectShippingOption | ClickedSendPartnerOffer | ClickedShareButton | ClickedShippingAddress | ClickedShowGroup | ClickedShowMore | ClickedSnooze | ClickedStartPartnerOffer | ClickedTermsAndConditions | ClickedUpdateArtwork | ClickedUploadArtwork | ClickedValidationAddressOptions | ClickedVerifyIdentity | ClickedViewingRoomCard | ClickedViewWork | ClickedVisitHelpCenter | CommercialFilterParamsChanged | CommercialFilterSelectedAll | CompletedOfflineSync | CompletedOnboarding | ConfirmBid | ConfirmRegistrationPageview | ConsignmentArtistFailed | ConsignmentSubmitted | ContactInformationCompleted | CreatedAccount | CreateAlertReminderMessageViewed | CreatedAlbum | CreatedArtworkList | DarkModeOptionUpdated | DeclinedOffer | DeleteCollectedArtwork | DeletedArtworkList | DeletedSavedSearch | EditCollectedArtwork | EditedAlert | EditedArtworkList | EditedAutocompletedAddress | EditedSavedSearch | EditedUserProfile | EditProfileModalViewed | EnterLiveAuction | ErrorMessageViewed | ExperimentViewed | ExpressCheckoutViewed | FocusedOnConversationMessageInput | FocusedOnPriceDatabaseSearchInput | FocusedOnSearchInput | FollowEvents | Impression | ImmersiveViewArtworkDisplayed | ImmersiveViewOptionViewed | ItemViewed | MaxBidSelected | MyCollectionOnboardingCompleted | NavigationDropdownViewed | NewPaymentMethodViewed | OnboardingUserInputData | OrderDetailsViewed | OrderProgressionViewed | PartnerOfferInConversationViewed | PastedIntoSearchInput | PriceDatabaseFilterParamsChanged | PromptForReview | RailViewed | RegistrationPageView | RegistrationSubmitted | ResetYourPassword | SaleScreenLoadComplete | SaveCollectedArtwork | SavedAddressViewed | SavedCookieConsentPreferences | SavedPaymentMethodViewed | SavedPriceRange | Screen | SearchedPriceDatabase | SearchedWithNoResults | SearchedWithResults | SearchedWithSuggestedFilter | SelectedItemFromAddressAutoCompletion | SelectedItemFromPriceDatabaseSearch | SelectedItemFromSearch | SelectedItemFromSearchPage | SelectedFromDrawer | SelectedRecentPriceRange | SelectedSearchSuggestionQuickNavigationItem | SendOffersBannerViewed | SendOffersErrorMessage | SendOffersModalViewed | SentConsignmentInquiry | SentContent | SentConversationMessage | SentRequestPriceEstimate | Share | ShippingEstimateViewed | ShippingQuoteViewed | StartedOnboarding | SubmitAnotherArtwork | SubmittedCounterOffer | SubmittedOffer | SubmittedOrder | SuccessfullyLoggedIn | SwipedInfiniteDiscoveryArtwork | SwipedUp | Tapped3Dots | TappedActivityGroup | TappedAlertsGroup | TappedArticleGroup | TappedArticleShare | TappedArtistGroup | TappedArtistSeriesGroup | TappedArtworkGroup | TappedArtworkList | TappedAskSpecialist | TappedAuctionGroup | TappedAuctionResultGroup | TappedBid | TappedBrowseSimilarArtworks | TappedBuyerProtection | TappedBuyNow | TappedCardGroup | TappedChangePaymentMethod | TappedClearTask | TappedCollectedArtwork | TappedCollectedArtworkImages | TappedCollectionGroup | TappedCompleteYourProfile | TappedConfirmSeeFewerWorks | TappedConsign | TappedConsignmentInquiry | TappedContactGallery | TappedCreateAlert | TappedEditedProfile | TappedExploreGroup | TappedExploreMyCollection | TappedFairCard | TappedFairGroup | TappedFollowsGroup | TappedGlobalSearchBar | TappedImportFees | TappedInboxConversation | TappedInfoBubble | TappedLearnMore | TappedLink | TappedMainArtworkGrid | TappedMakeOffer | TappedMenuItemGroup | TappedMyCollection | TappedMyCollectionAddArtworkArtist | TappedMyCollectionInsightsMedianAuctionPriceChartCareerHighlight | TappedMyCollectionInsightsMedianAuctionPriceChartCategory | TappedMyCollectionInsightsMedianAuctionPriceChartTimeframe | TappedMyCollectionInsightsMedianAuctionRailItem | TappedNavigationPillsGroup | TappedNavigationTab | TappedNewArtworkList | TappedNotificationsBell | TappedOfferSettings | TappedOrderArtworkImage | TappedPartnerCard | TappedProductCapabilitiesGroup | TappedPromoSpace | TappedRequestPriceEstimate | TappedSeeFewerWorks | TappedSell | TappedSellArtwork | TappedShare | TappedShowMore | TappedSkip | TappedTabBar | TappedTaskGroup | TappedVerifyIdentity | TappedViewingRoomCard | TappedViewingRoomGroup | TappedViewOffer | TappedViewWork | TappedVisitHelpCenter | TimeOnPage | ToggledAccordion | ToggledArtistBio | ToggledCollapsibleOrderSummary | ToggledNotification | ToggledOfferHistory | ToggledPresentationModeSetting | ToggledSavedSearch | TooltipViewed | ProgressiveOnboardingTooltipViewed | UploadPhotosCompleted | UploadSizeLimitExceeded | ValidationAddressViewed | ViewArtworkMyCollection | ViewedArtworkList | ViewedSharedArtworkList | ViewedVideo | ViewedToast | VisitMyCollection | VisitMyCollectionOnboardingSlide;
 /**
  * The top-level actions an Event describes.
  *
@@ -844,6 +844,10 @@ export declare enum ActionType {
      * Corresponds to {@link SearchedWithResults}
      */
     searchedWithResults = "searchedWithResults",
+    /**
+     * Corresponds to {@link SearchedWithSuggestedFilter}
+     */
+    searchedWithSuggestedFilter = "searchedWithSuggestedFilter",
     /**
      * Corresponds to {@link SelectArtistFromSearch}
      */

package/dist/Schema/Events/index.js

@@ -220,6 +220,7 @@ exports.ActionType = ActionType;
   ActionType["searchedPriceDatabase"] = "searchedPriceDatabase";
   ActionType["searchedWithNoResults"] = "searchedWithNoResults";
   ActionType["searchedWithResults"] = "searchedWithResults";
+  ActionType["searchedWithSuggestedFilter"] = "searchedWithSuggestedFilter";
   ActionType["selectArtistFromSearch"] = "selectArtistFromSearch";
   ActionType["selectArtworkFromGrid"] = "selectArtworkFromGrid";
   ActionType["clickedConversationsFilter"] = "clickedConversationsFilter";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@artsy/cohesion",
-  "version": "4.395.0",
+  "version": "4.396.0",
   "description": "Analytics schema",
   "main": "dist/index.js",
   "publishConfig": {