@artsy/cohesion 4.330.0 → 4.332.0

package/CHANGELOG.md

@@ -1,3 +1,27 @@
+# v4.332.0 (Tue Dec 09 2025)
+
+#### 🚀  Enhancement
+
+- feat: add level property to navigationDropdownViewed event [#669](https://github.com/artsy/cohesion/pull/669) ([@dblandin](https://github.com/dblandin))
+
+#### Authors: 1
+
+- devon blandin ([@dblandin](https://github.com/dblandin))
+
+---
+
+# v4.331.0 (Tue Dec 09 2025)
+
+#### 🚀  Enhancement
+
+- chore: add navigation dropdown tracking events [#668](https://github.com/artsy/cohesion/pull/668) ([@dblandin](https://github.com/dblandin))
+
+#### Authors: 1
+
+- devon blandin ([@dblandin](https://github.com/dblandin))
+
+---
+
 # v4.330.0 (Fri Dec 05 2025)
 
 #### 🚀  Enhancement

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

@@ -2577,3 +2577,49 @@ export interface ClickedHeader {
     context_page_owner_type: PageOwnerType;
     subject: string;
 }
+/**
+ * User clicks an item within a navigation dropdown on web (desktop or mobile)
+ * Triggered before navigation to the destination
+ * Note: Clicks on actual items (e.g., "Banksy"), not category headings (e.g., "Blue-Chip Artists")
+ *
+ * This schema describes events sent to Segment from [[ClickedNavigationDropdownItem]]
+ *
+ *  @example Desktop - clicking "Banksy" from the Blue-Chip Artists group:
+ *  ```
+ *  {
+ *    action: "click",
+ *    flow: "Header",
+ *    context_module: "HeaderArtworksDropdown",
+ *    context_page_owner_type: "home",
+ *    parent_navigation_item: "Artworks",
+ *    dropdown_group: "Blue-Chip Artists",
+ *    subject: "Banksy",
+ *    destination_path: "/artist/banksy"
+ *  }
+ *  ```
+ *
+ *  @example Desktop - clicking "View All Artists":
+ *  ```
+ *  {
+ *    action: "click",
+ *    flow: "Header",
+ *    context_module: "HeaderArtistsDropdown",
+ *    context_page_owner_type: "home",
+ *    parent_navigation_item: "Artists",
+ *    subject: "View All Artists",
+ *    destination_path: "/artists"
+ *  }
+ *  ```
+ */
+export interface ClickedNavigationDropdownItem {
+    action: "click";
+    flow: string;
+    context_module: ContextModule;
+    context_page_owner_type: PageOwnerType;
+    context_page_owner_id?: string;
+    context_page_owner_slug?: string;
+    parent_navigation_item: string;
+    dropdown_group?: string;
+    subject: string;
+    destination_path: string;
+}

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

@@ -528,3 +528,44 @@ export interface ImmersiveViewArtworkDisplayed {
     context_page_owner_id?: string;
     artwork_id: string;
 }
+/**
+ * User views a navigation dropdown on web
+ * - Desktop: triggered after hovering over a top-level nav item (e.g., "Artists") with delay
+ * - Mobile web: triggered when drilling down into the navigation menu hierarchy
+ *
+ * This schema describes events sent to Segment from [[NavigationDropdownViewed]].
+ *
+ *  @example Desktop hover (always level 0):
+ *  ```
+ *  {
+ *    action: "navigationDropdownViewed",
+ *    context_module: "header",
+ *    context_page_owner_type: "home",
+ *    navigation_item: "Artists",
+ *    level: 0,
+ *    interaction_type: "hover"
+ *  }
+ *  ```
+ *
+ *  @example Mobile web drilldown (level 1):
+ *  ```
+ *  {
+ *    action: "navigationDropdownViewed",
+ *    context_module: "header",
+ *    context_page_owner_type: "home",
+ *    navigation_item: "Blue-Chip Artists",
+ *    level: 1,
+ *    interaction_type: "drilldown"
+ *  }
+ *  ```
+ */
+export interface NavigationDropdownViewed {
+    action: ActionType.navigationDropdownViewed;
+    context_module: ContextModule;
+    context_page_owner_type: PageOwnerType;
+    context_page_owner_id?: string;
+    context_page_owner_slug?: string;
+    navigation_item: string;
+    level: number;
+    interaction_type: "hover" | "drilldown";
+}

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

@@ -15,7 +15,7 @@ import { AddedToAlbum, CompletedOfflineSync, CreatedAlbum, SentContent, ToggledP
 import { TappedProductCapabilitiesGroup } from "./HomeFeedArtsyOnboarding";
 import { MyCollectionOnboardingCompleted, TappedExploreMyCollection, VisitMyCollection, VisitMyCollectionOnboardingSlide } from "./HomeFeedMyCollectionOnboarding";
 import { Impression } from "./Impression";
-import { BannerViewed, CreateAlertReminderMessageViewed, EditProfileModalViewed, ErrorMessageViewed, ExpressCheckoutViewed, ImmersiveViewArtworkDisplayed, ImmersiveViewOptionViewed, ItemViewed, OrderDetailsViewed, OrderProgressionViewed, ProgressiveOnboardingTooltipViewed, RailViewed, SavedAddressViewed, SavedPaymentMethodViewed, SendOffersBannerViewed, SendOffersErrorMessage, SendOffersModalViewed, ShippingEstimateViewed, TooltipViewed, ValidationAddressViewed, ViewedToast } from "./ImpressionTracking";
+import { BannerViewed, CreateAlertReminderMessageViewed, EditProfileModalViewed, ErrorMessageViewed, ExpressCheckoutViewed, ImmersiveViewArtworkDisplayed, ImmersiveViewOptionViewed, ItemViewed, NavigationDropdownViewed, OrderDetailsViewed, OrderProgressionViewed, ProgressiveOnboardingTooltipViewed, RailViewed, SavedAddressViewed, SavedPaymentMethodViewed, SendOffersBannerViewed, SendOffersErrorMessage, SendOffersModalViewed, ShippingEstimateViewed, TooltipViewed, ValidationAddressViewed, ViewedToast } from "./ImpressionTracking";
 import { AddCollectedArtwork, DeleteCollectedArtwork, EditCollectedArtwork, SaveCollectedArtwork, SentRequestPriceEstimate, TappedCollectedArtwork, TappedCollectedArtworkImages, TappedMyCollection, TappedMyCollectionAddArtworkArtist, TappedRequestPriceEstimate } from "./MyCollection";
 import { TappedMyCollectionInsightsMedianAuctionPriceChartCareerHighlight, TappedMyCollectionInsightsMedianAuctionPriceChartCategory, TappedMyCollectionInsightsMedianAuctionPriceChartTimeframe, TappedMyCollectionInsightsMedianAuctionRailItem } from "./MyCollectionInsights";
 import { PromptForReview } from "./PromptForReview";
@@ -37,7 +37,7 @@ import { ViewedVideo } from "./Video";
  *
  * Each event describes one ActionType
  */
-export type Event = AddCollectedArtwork | AddedArtworkToArtworkList | AddedToAlbum | AddressAutoCompletionResult | AddToCalendar | ArtworkDetailsCompleted | AuctionPageView | AuctionResultsFilterParamsChanged | AuthImpression | BannerViewed | BidPageView | CheckedAccountBalance | ClickedActiveBid | ClickedActivityPanelNotificationItem | ClickedActivityPanelTab | ClickedAddFilters | ClickedAddMissingArtworksDetails | ClickedAddNewShippingAddress | ClickedAddWorksToFair | ClickedAlertsFilters | ClickedAppDownload | ClickedArticleGroup | ClickedArtistGroup | ClickedArtistSeriesGroup | ClickedArtworkGroup | ClickedAskSpecialist | ClickedAuctionGroup | ClickedAuctionResultItem | ClickedBid | ClickedBuyerProtection | ClickedBuyNow | ClickedCancelExpressCheckout | ClickedChangePage | ClickedChangePaymentMethod | ClickedChangeShippingAddress | ClickedChangeShippingMethod | ClickedCloseValidationAddressModal | ClickedCollectionGroup | ClickedCompleteYourProfile | ClickedContactGallery | ClickedConversationsFilter | ClickedCreateAlert | ClickedDeliveryMethod | ClickedDismissInquiry | ClickedDownloadAppFooter | ClickedDownloadAppHeader | ClickedEditArtwork | ClickedEditAlert | ClickedEstimateShippingCost | ClickedExpandFilterPanel | ClickedExpansionToggle | ClickedExpressCheckout | ClickedFairCard | ClickedFairGroup | ClickedFulfillmentTab | ClickedGalleryGroup | 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 | ClickedOrderPage | ClickedOrderProgression | ClickedOrderSummary | ClickedOpenInNewTabButton | ClickedPartnerCard | ClickedPartnerLink | ClickedPaymentDetails | ClickedPaymentMethod | ClickedPromoSpace | ClickedPublish | ClickedRegisterToBid | ClickedSaveAsTemplate | ClickedSelectShippingOption | ClickedSendPartnerOffer | ClickedShareButton | ClickedShippingAddress | ClickedShowGroup | ClickedShowMore | ClickedSnooze | ClickedStartPartnerOffer | ClickedUpdateArtwork | ClickedUploadArtwork | ClickedValidationAddressOptions | ClickedVerifyIdentity | ClickedViewingRoomCard | ClickedViewWork | ClickedVisitHelpCenter | CommercialFilterParamsChanged | CommercialFilterSelectedAll | CompletedOfflineSync | CompletedOnboarding | ConfirmBid | ConfirmRegistrationPageview | ConsignmentArtistFailed | ConsignmentSubmitted | ContactInformationCompleted | CreatedAccount | CreateAlertReminderMessageViewed | CreatedAlbum | CreatedArtworkList | DarkModeOptionUpdated | DeleteCollectedArtwork | DeletedArtworkList | DeletedSavedSearch | EditCollectedArtwork | EditedAlert | EditedArtworkList | EditedAutocompletedAddress | EditedSavedSearch | EditedUserProfile | EditProfileModalViewed | EnterLiveAuction | ErrorMessageViewed | ExperimentViewed | ExpressCheckoutViewed | FocusedOnConversationMessageInput | FocusedOnPriceDatabaseSearchInput | FocusedOnSearchInput | FollowEvents | Impression | ImmersiveViewArtworkDisplayed | ImmersiveViewOptionViewed | ItemViewed | MaxBidSelected | MyCollectionOnboardingCompleted | OnboardingUserInputData | OrderDetailsViewed | OrderProgressionViewed | PriceDatabaseFilterParamsChanged | PromptForReview | RailViewed | RegistrationPageView | RegistrationSubmitted | ResetYourPassword | SaleScreenLoadComplete | SaveCollectedArtwork | SavedAddressViewed | SavedCookieConsentPreferences | SavedPaymentMethodViewed | SavedPriceRange | Screen | SearchedPriceDatabase | SearchedWithNoResults | SearchedWithResults | SelectedItemFromAddressAutoCompletion | SelectedItemFromPriceDatabaseSearch | SelectedItemFromSearch | SelectedFromDrawer | SelectedRecentPriceRange | SelectedSearchSuggestionQuickNavigationItem | SendOffersBannerViewed | SendOffersErrorMessage | SendOffersModalViewed | SentConsignmentInquiry | SentContent | SentConversationMessage | SentRequestPriceEstimate | Share | ShippingEstimateViewed | StartedOnboarding | SubmitAnotherArtwork | 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 | TappedPartnerCard | TappedProductCapabilitiesGroup | TappedPromoSpace | TappedRequestPriceEstimate | TappedSeeFewerWorks | TappedSell | TappedSellArtwork | TappedShare | TappedShowMore | TappedSkip | TappedTabBar | TappedTaskGroup | TappedVerifyIdentity | TappedViewingRoomCard | TappedViewingRoomGroup | TappedViewOffer | TappedViewWork | TappedVisitHelpCenter | TimeOnPage | ToggledAccordion | ToggledCollapsibleOrderSummary | ToggledNotification | ToggledPresentationModeSetting | ToggledSavedSearch | TooltipViewed | ProgressiveOnboardingTooltipViewed | UploadPhotosCompleted | UploadSizeLimitExceeded | ValidationAddressViewed | ViewArtworkMyCollection | ViewedArtworkList | ViewedSharedArtworkList | ViewedVideo | ViewedToast | VisitMyCollection | VisitMyCollectionOnboardingSlide;
+export type Event = AddCollectedArtwork | AddedArtworkToArtworkList | AddedToAlbum | AddressAutoCompletionResult | AddToCalendar | ArtworkDetailsCompleted | AuctionPageView | AuctionResultsFilterParamsChanged | AuthImpression | BannerViewed | BidPageView | CheckedAccountBalance | ClickedActiveBid | ClickedActivityPanelNotificationItem | ClickedActivityPanelTab | ClickedAddFilters | ClickedAddMissingArtworksDetails | ClickedAddNewShippingAddress | ClickedAddWorksToFair | ClickedAlertsFilters | ClickedAppDownload | ClickedArticleGroup | ClickedArtistGroup | ClickedArtistSeriesGroup | ClickedArtworkGroup | ClickedAskSpecialist | ClickedAuctionGroup | ClickedAuctionResultItem | ClickedBid | ClickedBuyerProtection | ClickedBuyNow | ClickedCancelExpressCheckout | ClickedChangePage | ClickedChangePaymentMethod | ClickedChangeShippingAddress | ClickedChangeShippingMethod | ClickedCloseValidationAddressModal | ClickedCollectionGroup | ClickedCompleteYourProfile | ClickedContactGallery | ClickedConversationsFilter | ClickedCreateAlert | ClickedDeliveryMethod | ClickedDismissInquiry | ClickedDownloadAppFooter | ClickedDownloadAppHeader | ClickedEditArtwork | ClickedEditAlert | ClickedEstimateShippingCost | ClickedExpandFilterPanel | ClickedExpansionToggle | ClickedExpressCheckout | ClickedFairCard | ClickedFairGroup | ClickedFulfillmentTab | ClickedGalleryGroup | 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 | ClickedOrderPage | ClickedOrderProgression | ClickedOrderSummary | ClickedOpenInNewTabButton | ClickedPartnerCard | ClickedPartnerLink | ClickedPaymentDetails | ClickedPaymentMethod | ClickedPromoSpace | ClickedPublish | ClickedRegisterToBid | ClickedSaveAsTemplate | ClickedSelectShippingOption | ClickedSendPartnerOffer | ClickedShareButton | ClickedShippingAddress | ClickedShowGroup | ClickedShowMore | ClickedSnooze | ClickedStartPartnerOffer | ClickedUpdateArtwork | ClickedUploadArtwork | ClickedValidationAddressOptions | ClickedVerifyIdentity | ClickedViewingRoomCard | ClickedViewWork | ClickedVisitHelpCenter | CommercialFilterParamsChanged | CommercialFilterSelectedAll | CompletedOfflineSync | CompletedOnboarding | ConfirmBid | ConfirmRegistrationPageview | ConsignmentArtistFailed | ConsignmentSubmitted | ContactInformationCompleted | CreatedAccount | CreateAlertReminderMessageViewed | CreatedAlbum | CreatedArtworkList | DarkModeOptionUpdated | 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 | OnboardingUserInputData | OrderDetailsViewed | OrderProgressionViewed | PriceDatabaseFilterParamsChanged | PromptForReview | RailViewed | RegistrationPageView | RegistrationSubmitted | ResetYourPassword | SaleScreenLoadComplete | SaveCollectedArtwork | SavedAddressViewed | SavedCookieConsentPreferences | SavedPaymentMethodViewed | SavedPriceRange | Screen | SearchedPriceDatabase | SearchedWithNoResults | SearchedWithResults | SelectedItemFromAddressAutoCompletion | SelectedItemFromPriceDatabaseSearch | SelectedItemFromSearch | SelectedFromDrawer | SelectedRecentPriceRange | SelectedSearchSuggestionQuickNavigationItem | SendOffersBannerViewed | SendOffersErrorMessage | SendOffersModalViewed | SentConsignmentInquiry | SentContent | SentConversationMessage | SentRequestPriceEstimate | Share | ShippingEstimateViewed | StartedOnboarding | SubmitAnotherArtwork | 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 | TappedPartnerCard | TappedProductCapabilitiesGroup | TappedPromoSpace | TappedRequestPriceEstimate | TappedSeeFewerWorks | TappedSell | TappedSellArtwork | TappedShare | TappedShowMore | TappedSkip | TappedTabBar | TappedTaskGroup | TappedVerifyIdentity | TappedViewingRoomCard | TappedViewingRoomGroup | TappedViewOffer | TappedViewWork | TappedVisitHelpCenter | TimeOnPage | ToggledAccordion | ToggledCollapsibleOrderSummary | ToggledNotification | ToggledPresentationModeSetting | ToggledSavedSearch | TooltipViewed | ProgressiveOnboardingTooltipViewed | UploadPhotosCompleted | UploadSizeLimitExceeded | ValidationAddressViewed | ViewArtworkMyCollection | ViewedArtworkList | ViewedSharedArtworkList | ViewedVideo | ViewedToast | VisitMyCollection | VisitMyCollectionOnboardingSlide;
 /**
  * The top-level actions an Event describes.
  *
@@ -708,6 +708,10 @@ export declare enum ActionType {
      * Corresponds to {@link MyCollectionOnboardingCompleted}
      */
     myCollectionOnboardingCompleted = "myCollectionOnboardingCompleted",
+    /**
+     * Corresponds to {@link NavigationDropdownViewed}
+     */
+    navigationDropdownViewed = "navigationDropdownViewed",
     /**
      * Corresponds to {@link OnboardingUserInputData}
      */

package/dist/Schema/Events/index.js

@@ -186,6 +186,7 @@ exports.ActionType = ActionType;
   ActionType["longPressedArtwork"] = "longPressedArtwork";
   ActionType["maxBidSelected"] = "maxBidSelected";
   ActionType["myCollectionOnboardingCompleted"] = "myCollectionOnboardingCompleted";
+  ActionType["navigationDropdownViewed"] = "navigationDropdownViewed";
   ActionType["onboardingUserInputData"] = "onboardingUserInputData";
   ActionType["orderDetailsViewed"] = "orderDetailsViewed";
   ActionType["orderProgressionViewed"] = "orderProgressionViewed";

package/package.json

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