@artsy/cohesion 4.374.0--canary.717.15299.0 → 4.374.0

package/AGENTS.md

@@ -0,0 +1,132 @@
+# Agent Guidelines
+
+`@artsy/cohesion` is **Artsy's analytics schema** — a published TypeScript package of
+interfaces and enums that describe every analytics event sent to Segment/Redshift.
+There is no runtime logic: each event is a typed shape, and each event name maps to a
+downstream Redshift table. Consuming apps (web + iOS) import these types to fire events.
+
+## Tech Stack
+
+- **TypeScript** (strict) — the entire schema is type definitions; no runtime code
+- **Babel** — compiles `src/**/*.ts` → `dist/` (`@babel/preset-typescript`)
+- **tsc** — type-checking and `.d.ts` emission only (not used for transpiling)
+- **Jest** — tests assert each event interface serializes to its expected JSON shape
+- **ESLint + Prettier** — `simple-import-sort` and `sort-keys-fix` are enforced
+- **TypeDoc** — public docs at https://cohesion.artsy.net are generated from doc comments
+- **Auto / CircleCI** — versioning and npm publish on merge to `main`
+
+## Common Commands
+
+- `yarn test` — run the Jest suite (`<file>` or `-t <name>` to scope)
+- `yarn type-check` — `tsc --noEmit` (also runs on pre-push)
+- `yarn lint` — `eslint . --ext .ts --fix` (import + key sorting)
+- `yarn docs` — regenerate TypeDoc output into `doc/`
+
+## Pre-Commit Verification
+
+Before every commit, verify on pending files:
+
+```sh
+yarn type-check
+yarn test
+yarn lint
+```
+
+`husky` runs `lint-staged` on pre-commit and `yarn type-check` on pre-push. Never commit
+code that fails these checks.
+
+## Code Style & Common Patterns
+
+These are enforced by lint/test or are established conventions — follow them verbatim:
+
+- **One interface per event.** Name it `UpperCamelCase`; its `action` literal and the
+  matching `ActionType`/`OsActionType` enum member are `lowerCamelCase`. The enum member
+  value **is** the Redshift table name, so it must not change casually.
+- **`action` is always a literal type**, e.g. `action: ActionType.commercialFilterParamsChanged`
+  (not the bare `ActionType`).
+- **Sort keys alphabetically.** `sort-keys-fix` lints interface members, enum members, and
+  object literals (including test fixtures) into alphabetical order. Run `yarn lint` to fix.
+- **Sort imports.** `simple-import-sort` orders imports; let `--fix` handle it.
+- **Every event needs a context module and an owner type.** Use `context_module`
+  (`ContextModule`/`OsContextModule`) for the component, and an owner-type field for the
+  page/screen: `context_owner_type` (`OwnerType`), or `context_page_owner_type` /
+  `context_screen_owner_type` for the page/screen-scoped subtypes.
+- **Document every event with a TypeDoc block** containing a prose description and an
+  `@example` code fence showing the emitted JSON. This is the public documentation — see
+  `src/Schema/Events/FilterAndSort.ts` for the canonical style.
+- **Aggregate interfaces into a union** (e.g. `OsSubmitEvent`, `OsEvent`) and re-export
+  every new file from the relevant `index.ts` and `src/Schema/index.ts`.
+- **Prettier:** no semicolons, double quotes, trailing commas, 2-space indent.
+
+To add a CMS or core event, follow the step-by-step guide in [README.md](README.md#schema).
+
+## ArtOS Events (`src/Schema/os/`)
+
+ArtOS events have their **own** schema and conventions — do **not** reuse CMS or core
+events for ArtOS. When adding ArtOS tracking, follow these principles (from the
+[ArtOS tracking guidelines](https://app.notion.com/p/373cab0764a080fca7e7d5a984ec17c7) and
+[Filter/Sort/Search doc](https://app.notion.com/p/37bcab0764a081a2b22dc0f6434e44fa)):
+
+1. **Live under `src/Schema/os/`** with its own `Events/` and `Values/` folders. ArtOS has
+   dedicated `OsActionType`, `OsContextModule`, and `OsOwnerType` — never the shared ones.
+2. **Never reuse CMS events** for ArtOS surfaces, and vice versa.
+3. **Name events `VerbNoun`, past tense** — `ClickedFilterDrawer`, `CreatedStudioContent`,
+   `BulkEditedArtworks`. (The older `NounVerb` names like `ListCreated` were flipped.)
+4. **No generic action events.** Avoid `InventoryClicked` / `Clicked` / `Toggled` /
+   `Impression`; events must name the specific intent (`ClickedActionsDropdown`,
+   not a catch-all click). Events should be **reusable across surfaces** by intent — e.g.
+   `ClickedFilterDrawer` can fire on any page that has a filter component.
+5. **Differentiate surfaces via owner type, not a module field.** Do not add an `OSModule`
+   field; use `context_page_owner_type` (`inventory`, `collection`, `studioInstagram`, …)
+   to distinguish ArtOS surfaces. The URL itself changes (`/catalog` → `/lists` → …).
+6. **Group reusable events by interaction in shared files** (`Click.ts`, `Impression.ts`,
+   `Toggle.ts`). A set of events that is 100% non-reusable and scoped to one surface may get
+   its own file (e.g. `InstagramEditor.ts`, `MultiAddFlow.ts`).
+7. **Backend-tied, flow-completion events go in `Submit.ts`** — events that fire on
+   successful completion of a flow and depend on a backend change (`BulkEditedArtworks`,
+   `DeletedArtwork`, `DistributedArtworks`). These are platform-agnostic (web + future app),
+   so they stay out of the web-only `Click.ts`.
+8. **Avoid name collisions with existing events** — the OS list events drop the "Artwork"
+   qualifier (`CreatedList`, not `CreatedArtworkList`) so they don't clash with the existing
+   CMS saved-artwork-list events.
+
+## File Organization
+
+```
+src/
+├── index.ts              # Top-level package entry (re-exports Schema + DeprecatedHelpers)
+├── Schema/
+│   ├── index.ts          # Re-exports every event + value file (web/iOS, CMS, ArtOS)
+│   ├── Events/           # Core web + iOS events (FilterAndSort, Search, Click, Tap, …)
+│   ├── Values/           # Shared enums: ContextModule, OwnerType, Intent, Tab, …
+│   ├── CMS/              # CMS (gallery partner CMS) schema — Events/ + Values/
+│   └── os/               # ArtOS schema — see "ArtOS Events" above
+│       ├── Events/       # Click, Submit, InstagramEditor, MultiAddFlow, … (+ __tests__/)
+│       └── Values/       # OsContextModule, OsOwnerType
+├── DeprecatedSchema/     # Frozen legacy schema — do not extend
+└── DeprecatedHelpers/    # Frozen legacy helpers — do not extend
+```
+
+## Workflow
+
+- Branch off `main`; open a PR using `pull_request_template.md`.
+- Merging to `main` auto-publishes a new npm version via Auto; **PRs from feature branches
+  publish canary versions** consumers can test before merge.
+- Commit messages follow Conventional Commits (e.g. `chore:`, `feat:`) — used by Auto to
+  decide the version bump.
+
+## Gotchas
+
+- **Adding a file is not enough** — it must be re-exported from `src/Schema/index.ts` (and
+  any folder `index.ts` union) or consumers can't import it.
+- **The enum value is a contract.** An `ActionType`/`OsActionType` value names a Redshift
+  table; renaming it breaks the downstream data pipeline.
+- **`DeprecatedSchema` / `DeprecatedHelpers` are frozen** — add new events to `Schema`.
+- **Doc comments are shipped docs**, not just hints — keep `@example` blocks accurate.
+- The data team owns the core `Schema`; coordinate before changing shared `Values`.
+
+## Further Documentation
+
+- [README.md](README.md) — setup, and the canonical "add a new event" walkthrough
+- ArtOS tracking guidelines: [event list & principles](https://app.notion.com/p/373cab0764a080fca7e7d5a984ec17c7), [Filter/Sort/Search](https://app.notion.com/p/37bcab0764a081a2b22dc0f6434e44fa)
+- Generated API docs: https://cohesion.artsy.net

package/CHANGELOG.md

@@ -1,3 +1,51 @@
+# v4.374.0 (Sat Jun 27 2026)
+
+#### 🚀  Enhancement
+
+- chore(os): Add tracking schema for Art OS Filter, Sort, Search [#714](https://github.com/artsy/cohesion/pull/714) ([@olerichter00](https://github.com/olerichter00))
+
+#### Authors: 1
+
+- Ole ([@olerichter00](https://github.com/olerichter00))
+
+---
+
+# v4.373.0 (Fri Jun 26 2026)
+
+#### 🚀  Enhancement
+
+- fix(os): Export MaterialsEditor events correctly from Schema [#719](https://github.com/artsy/cohesion/pull/719) ([@olerichter00](https://github.com/olerichter00))
+
+#### Authors: 1
+
+- Ole ([@olerichter00](https://github.com/olerichter00))
+
+---
+
+# v4.372.0 (Fri Jun 26 2026)
+
+#### 🚀  Enhancement
+
+- chore: Remove list from os owner type [#718](https://github.com/artsy/cohesion/pull/718) ([@MrSltun](https://github.com/MrSltun))
+
+#### Authors: 1
+
+- Sultan Al-Maari ([@MrSltun](https://github.com/MrSltun))
+
+---
+
+# v4.371.0 (Fri Jun 26 2026)
+
+#### 🚀  Enhancement
+
+- chore: Add AGENTS.md and CLAUDE.md for agent onboarding [#715](https://github.com/artsy/cohesion/pull/715) ([@MounirDhahri](https://github.com/MounirDhahri))
+
+#### Authors: 1
+
+- Mounir Dhahri ([@MounirDhahri](https://github.com/MounirDhahri))
+
+---
+
 # v4.370.0 (Thu Jun 25 2026)
 
 #### 🚀  Enhancement

package/CLAUDE.md

@@ -0,0 +1,3 @@
+# CLAUDE.md
+
+See @AGENTS.md

package/dist/Schema/Values/ContextModule.d.ts

@@ -55,7 +55,6 @@ export declare enum ContextModule {
     artworkRecommendationsRail = "artworkRecommendationsRail",
     artworkSidebar = "artworkSidebar",
     artworksTab = "artworksTab",
-    artworkTable = "artworkTable",
     associatedViewingRoom = "associatedViewingRoom",
     auctionCard = "auctionCard",
     auctionHome = "auctionHome",

package/dist/Schema/Values/ContextModule.js

@@ -69,7 +69,6 @@ exports.ContextModule = ContextModule;
   ContextModule["artworkRecommendationsRail"] = "artworkRecommendationsRail";
   ContextModule["artworkSidebar"] = "artworkSidebar";
   ContextModule["artworksTab"] = "artworksTab";
-  ContextModule["artworkTable"] = "artworkTable";
   ContextModule["associatedViewingRoom"] = "associatedViewingRoom";
   ContextModule["auctionCard"] = "auctionCard";
   ContextModule["auctionHome"] = "auctionHome";

package/dist/Schema/index.d.ts

@@ -54,10 +54,11 @@ export * from "./os/Events";
 export * from "./os/Events/BrandKit";
 export * from "./os/Events/Click";
 export * from "./os/Events/ConnectedAppsFlow";
+export * from "./os/Events/FilterSortSearch";
 export * from "./os/Events/InstagramEditor";
 export * from "./os/Events/InventoryTable";
+export * from "./os/Events/MaterialsEditor";
 export * from "./os/Events/MultiAddFlow";
 export * from "./os/Events/Submit";
-export * from "./os/Events/Toggle";
 export * from "./os/Values/OsContextModule";
 export * from "./os/Values/OsOwnerType";

package/dist/Schema/index.js

@@ -568,6 +568,18 @@ Object.keys(_ConnectedAppsFlow).forEach(function (key) {
   });
 });
 
+var _FilterSortSearch = require("./os/Events/FilterSortSearch");
+
+Object.keys(_FilterSortSearch).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _FilterSortSearch[key];
+    }
+  });
+});
+
 var _InstagramEditor = require("./os/Events/InstagramEditor");
 
 Object.keys(_InstagramEditor).forEach(function (key) {
@@ -592,38 +604,38 @@ Object.keys(_InventoryTable).forEach(function (key) {
   });
 });
 
-var _MultiAddFlow = require("./os/Events/MultiAddFlow");
+var _MaterialsEditor = require("./os/Events/MaterialsEditor");
 
-Object.keys(_MultiAddFlow).forEach(function (key) {
+Object.keys(_MaterialsEditor).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
   Object.defineProperty(exports, key, {
     enumerable: true,
     get: function get() {
-      return _MultiAddFlow[key];
+      return _MaterialsEditor[key];
     }
   });
 });
 
-var _Submit = require("./os/Events/Submit");
+var _MultiAddFlow = require("./os/Events/MultiAddFlow");
 
-Object.keys(_Submit).forEach(function (key) {
+Object.keys(_MultiAddFlow).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
   Object.defineProperty(exports, key, {
     enumerable: true,
     get: function get() {
-      return _Submit[key];
+      return _MultiAddFlow[key];
     }
   });
 });
 
-var _Toggle2 = require("./os/Events/Toggle");
+var _Submit = require("./os/Events/Submit");
 
-Object.keys(_Toggle2).forEach(function (key) {
+Object.keys(_Submit).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
   Object.defineProperty(exports, key, {
     enumerable: true,
     get: function get() {
-      return _Toggle2[key];
+      return _Submit[key];
     }
   });
 });

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

@@ -49,29 +49,6 @@ export interface ClickedCancelBulkEdit {
     context_page_owner_type: OsOwnerType;
     artwork_ids: string[];
 }
-/**
- * The divergence marker appears in a syncable cell when the OS value
- * diverges from the downstream destination value (e.g. Artsy CMS). Fires as an
- * impression when the marker first renders for a given artwork/field combination.
- *
- * @example
- * ```
- * {
- *   action: "viewedDivergenceMarker",
- *   context_module: "artworkTable",
- *   context_page_owner_type: "inventory",
- *   artwork_id: "abc123",
- *   field: "availability"
- * }
- * ```
- */
-export interface ViewedDivergenceMarker {
-    action: OsActionType.viewedDivergenceMarker;
-    context_module: OsContextModule.artworkTable;
-    context_page_owner_type: OsOwnerType;
-    artwork_id: string;
-    field: "availability" | "medium" | "price";
-}
 /**
  * A partner opens a list, either from the Lists surface (a `ListCard`) or from
  * the recent-lists shortcut on the Inventory surface. `source` distinguishes the
@@ -97,4 +74,4 @@ export interface ClickedOpenList {
     list_type: string;
     source: string;
 }
-export type OsClickEvent = ClickedActionsDropdown | ClickedCancelBulkEdit | ViewedDivergenceMarker | ClickedOpenList;
+export type OsClickEvent = ClickedActionsDropdown | ClickedCancelBulkEdit | ClickedOpenList;

package/dist/Schema/os/Events/FilterSortSearch.d.ts

@@ -0,0 +1,162 @@
+import { OsContextModule } from "../Values/OsContextModule";
+import { OsOwnerType } from "../Values/OsOwnerType";
+import { OsActionType } from ".";
+/**
+ * Schemas describing Art OS Filter, Sort & Search events
+ * @packageDocumentation
+ */
+/**
+ * A partner opens the filter drawer via the Filter pill in the inventory or collection view.
+ *
+ * This schema describes events sent to Segment from [[OsClickedFilterDrawer]]
+ *
+ * @example
+ * ```
+ * {
+ *   action: "clickedFilterDrawer",
+ *   context_module: "artworkFilters",
+ *   context_page_owner_type: "inventory",
+ *   value: 2
+ * }
+ * ```
+ */
+export interface OsClickedFilterDrawer {
+    action: OsActionType.clickedFilterDrawer;
+    context_module: OsContextModule.artworkFilters;
+    context_page_owner_type: OsOwnerType.inventory | OsOwnerType.collection;
+    /** Number of active filters when opening the drawer */
+    value: number;
+}
+/**
+ * A partner applies a filter in the filter drawer.
+ * One event fires per selection; `label` identifies the filter type
+ * and `value` carries the selected value.
+ *
+ * This schema describes events sent to Segment from [[OsAppliedFilter]]
+ *
+ * @example Availability filter
+ * ```
+ * {
+ *   action: "appliedFilter",
+ *   context_module: "artworkFilters",
+ *   context_page_owner_type: "inventory",
+ *   label: "availability",
+ *   value: "for sale"
+ * }
+ * ```
+ *
+ * @example Artist filter
+ * ```
+ * {
+ *   action: "appliedFilter",
+ *   context_module: "artworkFilters",
+ *   context_page_owner_type: "collection",
+ *   label: "artist",
+ *   value: "<artistId>"
+ * }
+ * ```
+ */
+export interface OsAppliedFilter {
+    action: OsActionType.appliedFilter;
+    context_module: OsContextModule.artworkFilters;
+    context_page_owner_type: OsOwnerType.inventory | OsOwnerType.collection;
+    label: "availability" | "status" | "location" | "artist" | "coa";
+    value: string;
+}
+/**
+ * A partner removes a single filter via the selected-filter pill or the per-section Clear link.
+ *
+ * This schema describes events sent to Segment from [[OsRemovedFilter]]
+ *
+ * @example
+ * ```
+ * {
+ *   action: "removedFilter",
+ *   context_module: "artworkFilters",
+ *   context_page_owner_type: "inventory",
+ *   label: "availability",
+ *   value: "for sale"
+ * }
+ * ```
+ */
+export interface OsRemovedFilter {
+    action: OsActionType.removedFilter;
+    context_module: OsContextModule.artworkFilters;
+    context_page_owner_type: OsOwnerType.inventory | OsOwnerType.collection;
+    label: "availability" | "status" | "location" | "artist" | "coa";
+    value: string;
+}
+/**
+ * A partner clears all active filters via the "Clear all" button.
+ *
+ * This schema describes events sent to Segment from [[OsClearedFilters]]
+ *
+ * @example
+ * ```
+ * {
+ *   action: "clearedFilters",
+ *   context_module: "artworkFilters",
+ *   context_page_owner_type: "inventory",
+ *   value: 3
+ * }
+ * ```
+ */
+export interface OsClearedFilters {
+    action: OsActionType.clearedFilters;
+    context_module: OsContextModule.artworkFilters;
+    context_page_owner_type: OsOwnerType.inventory | OsOwnerType.collection;
+    /** Number of filters cleared */
+    value: number;
+}
+/**
+ * A partner clicks a sortable column header to sort the artwork table.
+ * A column-header click cycles ascending → descending → default.
+ *
+ * This schema describes events sent to Segment from [[OsSortedColumn]]
+ *
+ * @example
+ * ```
+ * {
+ *   action: "sortedColumn",
+ *   context_module: "artworkTable",
+ *   context_page_owner_type: "inventory",
+ *   label: "date added",
+ *   value: "asc"
+ * }
+ * ```
+ */
+export interface OsSortedColumn {
+    action: OsActionType.sortedColumn;
+    context_module: OsContextModule.artworkTable;
+    context_page_owner_type: OsOwnerType.inventory | OsOwnerType.collection;
+    /** The column being sorted */
+    label: string;
+    value: "asc" | "desc" | "default";
+}
+/**
+ * A partner submits a keyword search in the artwork search bar.
+ * Fires on the debounced commit (not per keystroke).
+ *
+ * This schema describes events sent to Segment from [[OsSearchedArtworks]]
+ *
+ * @example
+ * ```
+ * {
+ *   action: "searchedArtworks",
+ *   context_module: "artworkSearch",
+ *   context_page_owner_type: "inventory",
+ *   query: "Kelly",
+ *   value: 42
+ * }
+ * ```
+ */
+export interface OsSearchedArtworks {
+    action: OsActionType.searchedArtworks;
+    context_module: OsContextModule.artworkSearch;
+    context_page_owner_type: OsOwnerType.inventory | OsOwnerType.collection;
+    /** The committed search string */
+    query: string;
+    /** Number of results after the search resolves */
+    value: number;
+}
+export type OsFilterSortSearch = OsAppliedFilter | OsClearedFilters | OsClickedFilterDrawer | OsRemovedFilter | OsSearchedArtworks | OsSortedColumn;

package/dist/Schema/os/Events/InventoryTable.d.ts

@@ -311,41 +311,10 @@ export interface OsClickedActionsDropdown {
      * Top-bar "More": "Delete"
      * Row/context menu only: "Remove from Artsy" | "Change Collection" | "Remove from Collection" |
      *   "Convert to Edition Set" | "Edit Edition Set" | "Convert to Unique"
-     * Distribution: "Distribute to Artsy"
      */
-    value: "Add to Artsy" | "Add to Collection" | "Change Collection" | "Checklist" | "Convert to Edition Set" | "Convert to Unique" | "Delete" | "Distribute to Artsy" | "Edit Edition Set" | "Instagram Post" | "Mailchimp Campaign" | "Remove from Artsy" | "Remove from Collection" | "Tearsheet";
+    value: "Add to Artsy" | "Add to Collection" | "Change Collection" | "Checklist" | "Convert to Edition Set" | "Convert to Unique" | "Delete" | "Edit Edition Set" | "Instagram Post" | "Mailchimp Campaign" | "Remove from Artsy" | "Remove from Collection" | "Tearsheet";
     /** Which button or trigger the partner used to open this dropdown */
     label: "add to dropdown" | "context menu" | "more dropdown" | "row action" | "studio dropdown";
     artwork_ids: string[];
 }
-/**
- * A partner edits an availability, medium, or price cell that is configured to sync
- * with a downstream destination (e.g. Artsy CMS). Fires on mutation success. Distinct
- * from {@link OsEditedArtworkField} (general field edits) — this captures only the three
- * syncable fields and whether a push to the destination actually occurred.
- *
- * @example
- * ```
- * {
- *   action: "editedInventoryField",
- *   context_module: "artworkTable",
- *   context_page_owner_type: "inventory",
- *   destination: ["artsy"],
- *   artwork_id: "abc123",
- *   field: "availability",
- *   did_push_to_cms: false
- * }
- * ```
- */
-export interface EditedInventoryField {
-    action: OsActionType.editedInventoryField;
-    context_module: OsContextModule.artworkTable;
-    context_page_owner_type: OsOwnerType;
-    /** Downstream destinations the value was pushed to (e.g. ["artsy"]) */
-    destination: string[];
-    artwork_id: string;
-    field: "availability" | "medium" | "price";
-    /** false e.g. for "Not For Sale" (OS-only value that does not push to the destination) */
-    did_push_to_cms: boolean;
-}
-export type OsInventoryTable = EditedInventoryField | OsAddedArtist | OsAddedArtworkDocument | OsAddedLocation | OsClickedActionsDropdown | OsClickedArtworkRow | OsClickedEditionSetRow | OsClickedImagesModal | OsEditedArtworkField | OsRemovedArtworkDocument | OsSavedArtworkImages;
+export type OsInventoryTable = OsAddedArtist | OsAddedArtworkDocument | OsAddedLocation | OsClickedActionsDropdown | OsClickedArtworkRow | OsClickedEditionSetRow | OsClickedImagesModal | OsEditedArtworkField | OsRemovedArtworkDocument | OsSavedArtworkImages;

package/dist/Schema/os/Events/MaterialsEditor.d.ts

@@ -5,29 +5,6 @@ import { OsActionType } from ".";
  * Schemas describing Art OS Materials (Tearsheet / Checklist) events
  * @packageDocumentation
  */
-/**
- * A partner selects "Tearsheet" or "Checklist" from the inventory actions dropdown
- * to open the Materials editor. The dropdown is surfaced three ways: the artwork's
- * actions, bulk actions, and the right-click context menu.
- *
- * This schema describes events sent to Segment from [[OsClickedActionsDropdown]]
- *
- * @example
- * ```
- * {
- *   action: "clickedActionsDropdown",
- *   context_module: "actionsDropdown",
- *   context_page_owner_type: "inventory",
- *   value: "Tearsheet"
- * }
- * ```
- */
-export interface OsClickedActionsDropdown {
-    action: OsActionType.clickedActionsDropdown;
-    context_module: OsContextModule.actionsDropdown;
-    context_page_owner_type: OsOwnerType;
-    value: "Tearsheet" | "Checklist" | "Instagram Post";
-}
 /**
  * A partner clicks "Exit" in the Materials editor header to leave the editor.
  *
@@ -108,4 +85,4 @@ export interface OsCreatedStudioContent {
     /** Generic catch-all for the artwork detail fields included in the generated material */
     content: Record<string, unknown>;
 }
-export type OsMaterialsEditor = OsClickedActionsDropdown | OsClickedBrandKitModal | OsClickedExitEditor | OsCreatedStudioContent;
+export type OsMaterialsEditor = OsClickedBrandKitModal | OsClickedExitEditor | OsCreatedStudioContent;

package/dist/Schema/os/Events/Submit.d.ts

@@ -78,36 +78,6 @@ export interface DistributedArtworks {
     artwork_ids: string[];
     selected_count: number;
 }
-/**
- * The websocket-driven distribute job reaches a terminal state (complete or failed).
- * Driven by `useDistributeWebsocket` (`PartnersChannel`, `metadata_update`).
- * Fire on the final websocket message to capture success/skip rates.
- *
- * @example
- * ```
- * {
- *   action: "completedArtworkDistribution",
- *   context_module: "artworkTable",
- *   context_page_owner_type: "inventory",
- *   destination: ["artsy"],
- *   total_artworks: 12,
- *   success_count: 10,
- *   skipped_count: 2,
- *   value: "partial"
- * }
- * ```
- */
-export interface CompletedArtworkDistribution {
-    action: OsActionType.completedArtworkDistribution;
-    context_module: OsContextModule.artworkTable;
-    context_page_owner_type: OsOwnerType.inventory;
-    /** Destination marketplaces (currently Artsy only; extensible) */
-    destination: string[];
-    total_artworks: number;
-    success_count: number;
-    skipped_count: number;
-    value: "success" | "partial" | "error";
-}
 /**
  * A partner creates a new list in the Add-to-list modal and bulk-adds the current
  * selection to it. `start_date` / `end_date` are null when unset; `fair_id` is
@@ -289,4 +259,4 @@ export interface DistributedList {
     fair_id?: string;
     partner_show_id: string;
 }
-export type OsSubmitEvent = BulkEditedArtworks | CompletedArtworkDistribution | DeletedArtwork | DistributedArtworks | CreatedList | AddedArtworksToList | UpdatedList | DeletedList | RemovedArtworksFromList | MovedArtworksBetweenLists | DistributedList;
+export type OsSubmitEvent = BulkEditedArtworks | DeletedArtwork | DistributedArtworks | CreatedList | AddedArtworksToList | UpdatedList | DeletedList | RemovedArtworksFromList | MovedArtworksBetweenLists | DistributedList;

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

@@ -1,24 +1,28 @@
 import { ClickedAddBrandKitFile, ClickedBrandKitColor, ClickedBrandKitFont, ClickedSaveBrandKit } from "./BrandKit";
 import { OsClickEvent } from "./Click";
 import { OsConnectedAppsFlow } from "./ConnectedAppsFlow";
+import { OsFilterSortSearch } from "./FilterSortSearch";
 import { OsInstagramEditor } from "./InstagramEditor";
 import { OsInventoryTable } from "./InventoryTable";
 import { OsMaterialsEditor } from "./MaterialsEditor";
 import { OsMultiAddFlow } from "./MultiAddFlow";
 import { OsSubmitEvent } from "./Submit";
-import { OsToggleEvent } from "./Toggle";
 /**
  * List of valid schemas for Art OS analytics actions
  *
  * Each event describes one ActionType
  */
-export type OsEvent = OsMultiAddFlow | ClickedBrandKitColor | ClickedBrandKitFont | ClickedAddBrandKitFile | ClickedSaveBrandKit | OsConnectedAppsFlow | OsClickEvent | OsInstagramEditor | OsInventoryTable | OsMaterialsEditor | OsSubmitEvent | OsToggleEvent;
+export type OsEvent = OsMultiAddFlow | ClickedBrandKitColor | ClickedBrandKitFont | ClickedAddBrandKitFile | ClickedSaveBrandKit | OsConnectedAppsFlow | OsClickEvent | OsFilterSortSearch | OsInstagramEditor | OsInventoryTable | OsMaterialsEditor | OsSubmitEvent;
 /**
  * List of all Art OS actions
  *
  * Each OsActionType corresponds with a table in Redshift.
  */
 export declare enum OsActionType {
+    /**
+     * Corresponds to {@link OsFilterSortSearch}
+     */
+    appliedFilter = "appliedFilter",
     /**
      * Corresponds to {@link OsInventoryTable}
      */
@@ -64,6 +68,10 @@ export declare enum OsActionType {
      * Corresponds to {@link ClickedCancelBulkEdit}
      */
     clickedCancelBulkEdit = "clickedCancelBulkEdit",
+    /**
+     * Corresponds to {@link OsFilterSortSearch}
+     */
+    clickedFilterDrawer = "clickedFilterDrawer",
     /**
      * Corresponds to {@link ClickedConnectAccount}
      */
@@ -112,10 +120,6 @@ export declare enum OsActionType {
      * Corresponds to {@link OsInstagramEditor}
      */
     clickedUploadImageBank = "clickedUploadImageBank",
-    /**
-     * Corresponds to {@link CompletedArtworkDistribution}
-     */
-    completedArtworkDistribution = "completedArtworkDistribution",
     /**
      * Corresponds to {@link CompletedArtworkImport}
      */
@@ -132,6 +136,10 @@ export declare enum OsActionType {
      * Corresponds to {@link OsMaterialsEditor} and {@link OsInstagramEditor}
      */
     createdStudioContent = "createdStudioContent",
+    /**
+     * Corresponds to {@link OsFilterSortSearch}
+     */
+    clearedFilters = "clearedFilters",
     /**
      * Corresponds to {@link DeletedArtwork}
      */
@@ -152,10 +160,6 @@ export declare enum OsActionType {
      * Corresponds to {@link EditedArtworkField}
      */
     editedArtworkField = "editedArtworkField",
-    /**
-     * Corresponds to {@link EditedInventoryField}
-     */
-    editedInventoryField = "editedInventoryField",
     /**
      * Corresponds to {@link MovedArtworksBetweenLists}
      */
@@ -164,6 +168,10 @@ export declare enum OsActionType {
      * Corresponds to {@link OsInventoryTable}
      */
     removedArtworkDocument = "removedArtworkDocument",
+    /**
+     * Corresponds to {@link OsFilterSortSearch}
+     */
+    removedFilter = "removedFilter",
     /**
      * Corresponds to {@link RemovedArtworksFromList}
      */
@@ -177,19 +185,19 @@ export declare enum OsActionType {
      */
     savedArtworkImages = "savedArtworkImages",
     /**
-     * Corresponds to {@link StartedArtworkImport}
+     * Corresponds to {@link OsFilterSortSearch}
      */
-    startedArtworkImport = "startedArtworkImport",
+    searchedArtworks = "searchedArtworks",
     /**
-     * Corresponds to {@link ToggledDistributionSync}
+     * Corresponds to {@link OsFilterSortSearch}
      */
-    toggledDistributionSync = "toggledDistributionSync",
+    sortedColumn = "sortedColumn",
     /**
-     * Corresponds to {@link UpdatedList}
+     * Corresponds to {@link StartedArtworkImport}
      */
-    updatedList = "updatedList",
+    startedArtworkImport = "startedArtworkImport",
     /**
-     * Corresponds to {@link ViewedDivergenceMarker}
+     * Corresponds to {@link UpdatedList}
      */
-    viewedDivergenceMarker = "viewedDivergenceMarker"
+    updatedList = "updatedList"
 }

package/dist/Schema/os/Events/index.js

@@ -20,6 +20,7 @@ var OsActionType;
 exports.OsActionType = OsActionType;
 
 (function (OsActionType) {
+  OsActionType["appliedFilter"] = "appliedFilter";
   OsActionType["addedArtist"] = "addedArtist";
   OsActionType["addedArtworkDocument"] = "addedArtworkDocument";
   OsActionType["addedArtworksToList"] = "addedArtworksToList";
@@ -32,6 +33,7 @@ exports.OsActionType = OsActionType;
   OsActionType["clickedAspectRatio"] = "clickedAspectRatio";
   OsActionType["clickedBrandKitModal"] = "clickedBrandKitModal";
   OsActionType["clickedCancelBulkEdit"] = "clickedCancelBulkEdit";
+  OsActionType["clickedFilterDrawer"] = "clickedFilterDrawer";
   OsActionType["clickedConnectAccount"] = "clickedConnectAccount";
   OsActionType["clickedConnectAccountModal"] = "clickedConnectAccountModal";
   OsActionType["clickedConnectModal"] = "clickedConnectModal";
@@ -44,24 +46,24 @@ exports.OsActionType = OsActionType;
   OsActionType["clickedOpenList"] = "clickedOpenList";
   OsActionType["clickedPublishConfirmation"] = "clickedPublishConfirmation";
   OsActionType["clickedUploadImageBank"] = "clickedUploadImageBank";
-  OsActionType["completedArtworkDistribution"] = "completedArtworkDistribution";
   OsActionType["completedArtworkImport"] = "completedArtworkImport";
   OsActionType["createdImportedArtworks"] = "createdImportedArtworks";
   OsActionType["createdList"] = "createdList";
   OsActionType["createdStudioContent"] = "createdStudioContent";
+  OsActionType["clearedFilters"] = "clearedFilters";
   OsActionType["deletedArtwork"] = "deletedArtwork";
   OsActionType["deletedList"] = "deletedList";
   OsActionType["distributedArtworks"] = "distributedArtworks";
   OsActionType["distributedList"] = "distributedList";
   OsActionType["editedArtworkField"] = "editedArtworkField";
-  OsActionType["editedInventoryField"] = "editedInventoryField";
   OsActionType["movedArtworksBetweenLists"] = "movedArtworksBetweenLists";
   OsActionType["removedArtworkDocument"] = "removedArtworkDocument";
+  OsActionType["removedFilter"] = "removedFilter";
   OsActionType["removedArtworksFromList"] = "removedArtworksFromList";
   OsActionType["resumedArtworkImport"] = "resumedArtworkImport";
   OsActionType["savedArtworkImages"] = "savedArtworkImages";
+  OsActionType["searchedArtworks"] = "searchedArtworks";
+  OsActionType["sortedColumn"] = "sortedColumn";
   OsActionType["startedArtworkImport"] = "startedArtworkImport";
-  OsActionType["toggledDistributionSync"] = "toggledDistributionSync";
   OsActionType["updatedList"] = "updatedList";
-  OsActionType["viewedDivergenceMarker"] = "viewedDivergenceMarker";
 })(OsActionType || (exports.OsActionType = OsActionType = {}));

package/dist/Schema/os/Values/OsContextModule.d.ts

@@ -9,6 +9,8 @@ export declare enum OsContextModule {
     addArtistModal = "addArtistModal",
     addLocationModal = "addLocationModal",
     addToListModal = "addToListModal",
+    artworkFilters = "artworkFilters",
+    artworkSearch = "artworkSearch",
     artworkTable = "artworkTable",
     brandKit = "brandKit",
     brandKitPromptModal = "brandKitPromptModal",
@@ -28,6 +30,5 @@ export declare enum OsContextModule {
     materialsEditor = "materialsEditor",
     multiAdd = "multiAdd",
     multiAddReview = "multiAddReview",
-    publishConfirmationModal = "publishConfirmationModal",
-    tableActions = "tableActions"
+    publishConfirmationModal = "publishConfirmationModal"
 }

package/dist/Schema/os/Values/OsContextModule.js

@@ -19,6 +19,8 @@ exports.OsContextModule = OsContextModule;
   OsContextModule["addArtistModal"] = "addArtistModal";
   OsContextModule["addLocationModal"] = "addLocationModal";
   OsContextModule["addToListModal"] = "addToListModal";
+  OsContextModule["artworkFilters"] = "artworkFilters";
+  OsContextModule["artworkSearch"] = "artworkSearch";
   OsContextModule["artworkTable"] = "artworkTable";
   OsContextModule["brandKit"] = "brandKit";
   OsContextModule["brandKitPromptModal"] = "brandKitPromptModal";
@@ -39,5 +41,4 @@ exports.OsContextModule = OsContextModule;
   OsContextModule["multiAdd"] = "multiAdd";
   OsContextModule["multiAddReview"] = "multiAddReview";
   OsContextModule["publishConfirmationModal"] = "publishConfirmationModal";
-  OsContextModule["tableActions"] = "tableActions";
 })(OsContextModule || (exports.OsContextModule = OsContextModule = {}));

package/dist/Schema/os/Values/OsOwnerType.d.ts

@@ -7,7 +7,6 @@ export declare enum OsOwnerType {
     collection = "collection",
     connectedApps = "connectedApps",
     inventory = "inventory",
-    list = "list",
     studio = "studio",
     studioInstagram = "studioInstagram",
     studioMaterials = "studioMaterials"

package/dist/Schema/os/Values/OsOwnerType.js

@@ -17,7 +17,6 @@ exports.OsOwnerType = OsOwnerType;
   OsOwnerType["collection"] = "collection";
   OsOwnerType["connectedApps"] = "connectedApps";
   OsOwnerType["inventory"] = "inventory";
-  OsOwnerType["list"] = "list";
   OsOwnerType["studio"] = "studio";
   OsOwnerType["studioInstagram"] = "studioInstagram";
   OsOwnerType["studioMaterials"] = "studioMaterials";

package/package.json

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

package/dist/Schema/os/Events/Toggle.d.ts

@@ -1,28 +0,0 @@
-/**
- * Schemas describing Art OS toggle events
- * @packageDocumentation
- */
-import { OsContextModule } from "../Values/OsContextModule";
-import { OsOwnerType } from "../Values/OsOwnerType";
-import { OsActionType } from "./index";
-/**
- * A partner toggles account-wide Auto-sync on or off via the InventoryTableActions bar.
- * Flips `distributionSyncEnabled` for the whole partner account.
- *
- * @example
- * ```
- * {
- *   action: "toggledDistributionSync",
- *   context_module: "tableActions",
- *   context_page_owner_type: "inventory",
- *   value: "on"
- * }
- * ```
- */
-export interface ToggledDistributionSync {
-    action: OsActionType.toggledDistributionSync;
-    context_module: OsContextModule.tableActions;
-    context_page_owner_type: OsOwnerType.inventory;
-    value: "on" | "off";
-}
-export type OsToggleEvent = ToggledDistributionSync;

package/dist/Schema/os/Events/__tests__/DistributionSyncFlow.test.d.ts

@@ -1 +0,0 @@
-export {};