@artsy/cohesion 4.362.0 → 4.363.0

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+# v4.363.0 (Tue Jun 23 2026)
+
+#### 🚀  Enhancement
+
+- chore: add tracking schema for OS Multi-Add feature [#706](https://github.com/artsy/cohesion/pull/706) ([@mzikherman](https://github.com/mzikherman))
+
+#### Authors: 1
+
+- Matt Zikherman ([@mzikherman](https://github.com/mzikherman))
+
+---
+
 # v4.362.0 (Thu Jun 18 2026)
 
 #### 🚀  Enhancement

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

@@ -163,6 +163,8 @@ export declare enum ContextModule {
     minimalCTABanner = "minimalCTABanner",
     moreFromThisSeries = "moreFromThisSeries",
     moreSeriesByThisArtist = "moreSeriesByThisArtist",
+    multiAdd = "multiAdd",
+    multiAddReview = "multiAddReview",
     myCollection = "myCollection",
     myCollectionAddArtworkAddArtist = "myCollectionAddArtworkAddArtist",
     myCollectionArtwork = "myCollectionArtwork",

package/dist/Schema/Values/ContextModule.js

@@ -177,6 +177,8 @@ exports.ContextModule = ContextModule;
   ContextModule["minimalCTABanner"] = "minimalCTABanner";
   ContextModule["moreFromThisSeries"] = "moreFromThisSeries";
   ContextModule["moreSeriesByThisArtist"] = "moreSeriesByThisArtist";
+  ContextModule["multiAdd"] = "multiAdd";
+  ContextModule["multiAddReview"] = "multiAddReview";
   ContextModule["myCollection"] = "myCollection";
   ContextModule["myCollectionAddArtworkAddArtist"] = "myCollectionAddArtworkAddArtist";
   ContextModule["myCollectionArtwork"] = "myCollectionArtwork";

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

@@ -93,6 +93,7 @@ export declare enum OwnerType {
     infiniteDiscoveryArtwork = "infiniteDiscoveryArtwork",
     infiniteDiscoveryArtist = "infiniteDiscoveryArtist",
     infiniteDiscoveryOnboarding = "infiniteDiscoveryOnboarding",
+    inventory = "inventory",
     lotsByArtistsYouFollow = "lotsByArtistsYouFollow",
     lotsForYou = "lotsForYou",
     marketNews = "marketNews",

package/dist/Schema/Values/OwnerType.js

@@ -111,6 +111,7 @@ exports.OwnerType = OwnerType;
   OwnerType["infiniteDiscoveryArtwork"] = "infiniteDiscoveryArtwork";
   OwnerType["infiniteDiscoveryArtist"] = "infiniteDiscoveryArtist";
   OwnerType["infiniteDiscoveryOnboarding"] = "infiniteDiscoveryOnboarding";
+  OwnerType["inventory"] = "inventory";
   OwnerType["lotsByArtistsYouFollow"] = "lotsByArtistsYouFollow";
   OwnerType["lotsForYou"] = "lotsForYou";
   OwnerType["marketNews"] = "marketNews";

package/dist/Schema/index.d.ts

@@ -47,3 +47,10 @@ export * from "./CMS/Events/QuickReplyFlow";
 export * from "./CMS/Events/SettingsFlow";
 export * from "./CMS/Events/ShowFlow";
 export * from "./CMS/Events/UploadArtworkFlow";
+/**
+ * Art OS-specific exports
+ */
+export * from "./os/Events";
+export * from "./os/Values/OsContextModule";
+export * from "./os/Values/OsOwnerType";
+export * from "./os/Events/MultiAddFlow";

package/dist/Schema/index.js

@@ -518,4 +518,52 @@ Object.keys(_UploadArtworkFlow).forEach(function (key) {
       return _UploadArtworkFlow[key];
     }
   });
+});
+
+var _Events3 = require("./os/Events");
+
+Object.keys(_Events3).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _Events3[key];
+    }
+  });
+});
+
+var _OsContextModule = require("./os/Values/OsContextModule");
+
+Object.keys(_OsContextModule).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _OsContextModule[key];
+    }
+  });
+});
+
+var _OsOwnerType = require("./os/Values/OsOwnerType");
+
+Object.keys(_OsOwnerType).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _OsOwnerType[key];
+    }
+  });
+});
+
+var _MultiAddFlow = require("./os/Events/MultiAddFlow");
+
+Object.keys(_MultiAddFlow).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _MultiAddFlow[key];
+    }
+  });
 });

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

@@ -0,0 +1,170 @@
+/**
+ * Schemas describing Art OS Multi-Add Artworks events
+ * @packageDocumentation
+ */
+import { OsContextModule } from "../Values/OsContextModule";
+import { OsOwnerType } from "../Values/OsOwnerType";
+import { OsActionType } from "./index";
+/**
+ * A partner clicks "Add From File" to enter the Multi-Add flow and open the drop zone.
+ *
+ * @example
+ * ```
+ * {
+ *   action: "clickedAddFromFile",
+ *   context_module: "multiAdd",
+ *   context_page_owner_type: "inventory"
+ * }
+ * ```
+ */
+export interface ClickedAddFromFile {
+    action: OsActionType.clickedAddFromFile;
+    context_module: OsContextModule.multiAdd;
+    context_page_owner_type: OsOwnerType.inventory;
+}
+/**
+ * A partner exits the drop zone without dropping a file (nothing is saved).
+ *
+ * @example
+ * ```
+ * {
+ *   action: "clickedExitDropZone",
+ *   context_module: "multiAdd",
+ *   context_page_owner_type: "inventory"
+ * }
+ * ```
+ */
+export interface ClickedExitDropZone {
+    action: OsActionType.clickedExitDropZone;
+    context_module: OsContextModule.multiAdd;
+    context_page_owner_type: OsOwnerType.inventory;
+}
+/**
+ * A file is accepted by the drop zone and an import session starts (upload to S3,
+ * then createArtworkImport with parseWithAI). One event per started session.
+ *
+ * @example
+ * ```
+ * {
+ *   action: "startedArtworkImport",
+ *   context_module: "multiAdd",
+ *   context_page_owner_type: "inventory",
+ *   file_type: "application/pdf"
+ * }
+ * ```
+ */
+export interface StartedArtworkImport {
+    action: OsActionType.startedArtworkImport;
+    context_module: OsContextModule.multiAdd;
+    context_page_owner_type: OsOwnerType.inventory;
+    file_type: string;
+}
+/**
+ * A partner confirms the review and creates artworks from the import (skipped rows excluded).
+ *
+ * @example
+ * ```
+ * {
+ *   action: "createdImportedArtworks",
+ *   context_module: "multiAddReview",
+ *   context_page_owner_type: "inventory",
+ *   artwork_import_id: "67b646ecbe87376bfeb3f962",
+ *   row_count: 14,
+ *   selected_count: 12
+ * }
+ * ```
+ */
+export interface CreatedImportedArtworks {
+    action: OsActionType.createdImportedArtworks;
+    context_module: OsContextModule.multiAddReview;
+    context_page_owner_type: OsOwnerType.inventory;
+    artwork_import_id: string;
+    row_count: number;
+    selected_count: number;
+}
+/**
+ * A partner cancels the review session, discarding the import.
+ *
+ * @example
+ * ```
+ * {
+ *   action: "cancelledArtworkImport",
+ *   context_module: "multiAddReview",
+ *   context_page_owner_type: "inventory",
+ *   artwork_import_id: "67b646ecbe87376bfeb3f962"
+ * }
+ * ```
+ */
+export interface CancelledArtworkImport {
+    action: OsActionType.cancelledArtworkImport;
+    context_module: OsContextModule.multiAddReview;
+    context_page_owner_type: OsOwnerType.inventory;
+    artwork_import_id: string;
+}
+/**
+ * A partner is dropped back into a prior import session that is awaiting review.
+ *
+ * @example
+ * ```
+ * {
+ *   action: "resumedArtworkImport",
+ *   context_module: "multiAdd",
+ *   context_page_owner_type: "inventory",
+ *   artwork_import_id: "67b646ecbe87376bfeb3f962"
+ * }
+ * ```
+ */
+export interface ResumedArtworkImport {
+    action: OsActionType.resumedArtworkImport;
+    context_module: OsContextModule.multiAdd;
+    context_page_owner_type: OsOwnerType.inventory;
+    artwork_import_id: string;
+}
+/**
+ * Artwork creation for the import finishes successfully.
+ *
+ * @example
+ * ```
+ * {
+ *   action: "completedArtworkImport",
+ *   context_module: "multiAdd",
+ *   context_page_owner_type: "inventory",
+ *   artwork_import_id: "67b646ecbe87376bfeb3f962"
+ * }
+ * ```
+ */
+export interface CompletedArtworkImport {
+    action: OsActionType.completedArtworkImport;
+    context_module: OsContextModule.multiAdd;
+    context_page_owner_type: OsOwnerType.inventory;
+    artwork_import_id: string;
+}
+/**
+ * A partner corrects a cell in the review table (a flagged cell or an unmatched artist).
+ * Carries the import row rather than a saved artwork.
+ *
+ * @example
+ * ```
+ * {
+ *   action: "editedArtworkField",
+ *   context_module: "multiAddReview",
+ *   context_page_owner_type: "inventory",
+ *   artwork_import_id: "67b646ecbe87376bfeb3f962",
+ *   import_row_id: "a1b2c3d4",
+ *   field: "title",
+ *   old_value: "Untitld",
+ *   new_value: "Untitled"
+ * }
+ * ```
+ */
+export interface EditedArtworkField {
+    action: OsActionType.editedArtworkField;
+    context_module: OsContextModule.multiAddReview;
+    context_page_owner_type: OsOwnerType.inventory;
+    artwork_import_id: string;
+    import_row_id: string;
+    field: string;
+    old_value: string;
+    new_value: string;
+}
+export type OsMultiAddFlow = ClickedAddFromFile | ClickedExitDropZone | StartedArtworkImport | CreatedImportedArtworks | CancelledArtworkImport | ResumedArtworkImport | CompletedArtworkImport | EditedArtworkField;

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

@@ -0,0 +1 @@
+"use strict";

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

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

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

@@ -0,0 +1,46 @@
+import { OsMultiAddFlow } from "./MultiAddFlow";
+/**
+ * List of valid schemas for Art OS analytics actions
+ *
+ * Each event describes one ActionType
+ */
+export type OsEvent = OsMultiAddFlow;
+/**
+ * List of all Art OS actions
+ *
+ * Each OsActionType corresponds with a table in Redshift.
+ */
+export declare enum OsActionType {
+    /**
+     * Corresponds to {@link CancelledArtworkImport}
+     */
+    cancelledArtworkImport = "cancelledArtworkImport",
+    /**
+     * Corresponds to {@link ClickedAddFromFile}
+     */
+    clickedAddFromFile = "clickedAddFromFile",
+    /**
+     * Corresponds to {@link ClickedExitDropZone}
+     */
+    clickedExitDropZone = "clickedExitDropZone",
+    /**
+     * Corresponds to {@link CompletedArtworkImport}
+     */
+    completedArtworkImport = "completedArtworkImport",
+    /**
+     * Corresponds to {@link CreatedImportedArtworks}
+     */
+    createdImportedArtworks = "createdImportedArtworks",
+    /**
+     * Corresponds to {@link EditedArtworkField}
+     */
+    editedArtworkField = "editedArtworkField",
+    /**
+     * Corresponds to {@link ResumedArtworkImport}
+     */
+    resumedArtworkImport = "resumedArtworkImport",
+    /**
+     * Corresponds to {@link StartedArtworkImport}
+     */
+    startedArtworkImport = "startedArtworkImport"
+}

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

@@ -0,0 +1,31 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.OsActionType = void 0;
+
+/**
+ * List of valid schemas for Art OS analytics actions
+ *
+ * Each event describes one ActionType
+ */
+
+/**
+ * List of all Art OS actions
+ *
+ * Each OsActionType corresponds with a table in Redshift.
+ */
+var OsActionType;
+exports.OsActionType = OsActionType;
+
+(function (OsActionType) {
+  OsActionType["cancelledArtworkImport"] = "cancelledArtworkImport";
+  OsActionType["clickedAddFromFile"] = "clickedAddFromFile";
+  OsActionType["clickedExitDropZone"] = "clickedExitDropZone";
+  OsActionType["completedArtworkImport"] = "completedArtworkImport";
+  OsActionType["createdImportedArtworks"] = "createdImportedArtworks";
+  OsActionType["editedArtworkField"] = "editedArtworkField";
+  OsActionType["resumedArtworkImport"] = "resumedArtworkImport";
+  OsActionType["startedArtworkImport"] = "startedArtworkImport";
+})(OsActionType || (exports.OsActionType = OsActionType = {}));

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

@@ -0,0 +1,10 @@
+/**
+ * All context modules available for Art OS
+ *
+ * A component where an action is triggered
+ * @packageDocumentation
+ */
+export declare enum OsContextModule {
+    multiAdd = "multiAdd",
+    multiAddReview = "multiAddReview"
+}

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

@@ -0,0 +1,20 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.OsContextModule = void 0;
+
+/**
+ * All context modules available for Art OS
+ *
+ * A component where an action is triggered
+ * @packageDocumentation
+ */
+var OsContextModule;
+exports.OsContextModule = OsContextModule;
+
+(function (OsContextModule) {
+  OsContextModule["multiAdd"] = "multiAdd";
+  OsContextModule["multiAddReview"] = "multiAddReview";
+})(OsContextModule || (exports.OsContextModule = OsContextModule = {}));

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

@@ -0,0 +1,8 @@
+/**
+ * All owner types available for Art OS
+ *
+ * @packageDocumentation
+ */
+export declare enum OsOwnerType {
+    inventory = "inventory"
+}

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

@@ -0,0 +1,18 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.OsOwnerType = void 0;
+
+/**
+ * All owner types available for Art OS
+ *
+ * @packageDocumentation
+ */
+var OsOwnerType;
+exports.OsOwnerType = OsOwnerType;
+
+(function (OsOwnerType) {
+  OsOwnerType["inventory"] = "inventory";
+})(OsOwnerType || (exports.OsOwnerType = OsOwnerType = {}));

package/package.json

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