@reactionary/core 0.11.2 → 0.12.0

package/schemas/models/analytics/event.model.js

@@ -0,0 +1,255 @@
+import * as z from "zod";
+import {
+  AnalyticsMutationPageViewedSchema,
+  AnalyticsMutationSearchResultsViewedSchema,
+  AnalyticsMutationAutocompleteSuggestionSelectedSchema,
+  AnalyticsMutationCategoryViewedSchema,
+  AnalyticsMutationProductCarouselViewedSchema,
+  AnalyticsMutationProductClickedSchema,
+  AnalyticsMutationProductViewedSchema,
+  AnalyticsMutationPromotionViewedSchema,
+  AnalyticsMutationPromotionClickedSchema,
+  AnalyticsMutationCartItemAddedSchema,
+  AnalyticsMutationCartItemRemovedSchema,
+  AnalyticsMutationCartItemQuantityChangedSchema,
+  AnalyticsMutationCartViewedSchema,
+  AnalyticsMutationCouponAppliedSchema,
+  AnalyticsMutationCouponRejectedSchema,
+  AnalyticsMutationCheckoutStartedSchema,
+  AnalyticsMutationShippingInfoAddedSchema,
+  AnalyticsMutationPaymentInfoAddedSchema,
+  AnalyticsMutationOrderPlacedSchema,
+  AnalyticsMutationQuoteRequestedSchema,
+  AnalyticsMutationOrderReorderedSchema,
+  AnalyticsMutationCompanyRegisteredSchema,
+  AnalyticsMutationUserLoggedInSchema,
+  AnalyticsMutationUserLoggedOutSchema,
+  AnalyticsMutationUserRegisteredSchema,
+  AnalyticsMutationProfileUpdatedSchema,
+  AnalyticsMutationConsentChangedSchema,
+  AnalyticsMutationNewsletterSubscribedSchema,
+  AnalyticsMutationWishlistItemAddedSchema,
+  AnalyticsMutationWishlistItemRemovedSchema,
+  AnalyticsMutationBackInStockRequestedSchema,
+  AnalyticsMutationReviewSubmittedSchema,
+  AnalyticsMutationStoreSelectedSchema,
+  AnalyticsMutationProductSharedSchema,
+  AnalyticsMutationCustomSchema
+} from "../../mutations/analytics/events/index.js";
+import { AnalyticsEventEnvelopeSchema } from "./envelope.model.js";
+const omitEnvelopeFields = { origin: true, properties: true };
+const AnalyticsEventPageViewedSchema = AnalyticsEventEnvelopeSchema.extend({
+  type: z.literal("page-viewed"),
+  payload: AnalyticsMutationPageViewedSchema.omit(omitEnvelopeFields)
+});
+const AnalyticsEventSearchResultsViewedSchema = AnalyticsEventEnvelopeSchema.extend({
+  type: z.literal("search-results-viewed"),
+  payload: AnalyticsMutationSearchResultsViewedSchema.omit(omitEnvelopeFields)
+});
+const AnalyticsEventAutocompleteSuggestionSelectedSchema = AnalyticsEventEnvelopeSchema.extend({
+  type: z.literal("autocomplete-suggestion-selected"),
+  payload: AnalyticsMutationAutocompleteSuggestionSelectedSchema.omit(omitEnvelopeFields)
+});
+const AnalyticsEventCategoryViewedSchema = AnalyticsEventEnvelopeSchema.extend({
+  type: z.literal("category-viewed"),
+  payload: AnalyticsMutationCategoryViewedSchema.omit(omitEnvelopeFields)
+});
+const AnalyticsEventProductCarouselViewedSchema = AnalyticsEventEnvelopeSchema.extend({
+  type: z.literal("product-carousel-viewed"),
+  payload: AnalyticsMutationProductCarouselViewedSchema.omit(omitEnvelopeFields)
+});
+const AnalyticsEventProductClickedSchema = AnalyticsEventEnvelopeSchema.extend({
+  type: z.literal("product-clicked"),
+  payload: AnalyticsMutationProductClickedSchema.omit(omitEnvelopeFields)
+});
+const AnalyticsEventProductViewedSchema = AnalyticsEventEnvelopeSchema.extend({
+  type: z.literal("product-viewed"),
+  payload: AnalyticsMutationProductViewedSchema.omit(omitEnvelopeFields)
+});
+const AnalyticsEventPromotionViewedSchema = AnalyticsEventEnvelopeSchema.extend({
+  type: z.literal("promotion-viewed"),
+  payload: AnalyticsMutationPromotionViewedSchema.omit(omitEnvelopeFields)
+});
+const AnalyticsEventPromotionClickedSchema = AnalyticsEventEnvelopeSchema.extend({
+  type: z.literal("promotion-clicked"),
+  payload: AnalyticsMutationPromotionClickedSchema.omit(omitEnvelopeFields)
+});
+const AnalyticsEventCartItemAddedSchema = AnalyticsEventEnvelopeSchema.extend({
+  type: z.literal("cart-item-added"),
+  payload: AnalyticsMutationCartItemAddedSchema.omit(omitEnvelopeFields)
+});
+const AnalyticsEventCartItemRemovedSchema = AnalyticsEventEnvelopeSchema.extend({
+  type: z.literal("cart-item-removed"),
+  payload: AnalyticsMutationCartItemRemovedSchema.omit(omitEnvelopeFields)
+});
+const AnalyticsEventCartItemQuantityChangedSchema = AnalyticsEventEnvelopeSchema.extend({
+  type: z.literal("cart-item-quantity-changed"),
+  payload: AnalyticsMutationCartItemQuantityChangedSchema.omit(omitEnvelopeFields)
+});
+const AnalyticsEventCartViewedSchema = AnalyticsEventEnvelopeSchema.extend({
+  type: z.literal("cart-viewed"),
+  payload: AnalyticsMutationCartViewedSchema.omit(omitEnvelopeFields)
+});
+const AnalyticsEventCouponAppliedSchema = AnalyticsEventEnvelopeSchema.extend({
+  type: z.literal("coupon-applied"),
+  payload: AnalyticsMutationCouponAppliedSchema.omit(omitEnvelopeFields)
+});
+const AnalyticsEventCouponRejectedSchema = AnalyticsEventEnvelopeSchema.extend({
+  type: z.literal("coupon-rejected"),
+  payload: AnalyticsMutationCouponRejectedSchema.omit(omitEnvelopeFields)
+});
+const AnalyticsEventCheckoutStartedSchema = AnalyticsEventEnvelopeSchema.extend({
+  type: z.literal("checkout-started"),
+  payload: AnalyticsMutationCheckoutStartedSchema.omit(omitEnvelopeFields)
+});
+const AnalyticsEventShippingInfoAddedSchema = AnalyticsEventEnvelopeSchema.extend({
+  type: z.literal("shipping-info-added"),
+  payload: AnalyticsMutationShippingInfoAddedSchema.omit(omitEnvelopeFields)
+});
+const AnalyticsEventPaymentInfoAddedSchema = AnalyticsEventEnvelopeSchema.extend({
+  type: z.literal("payment-info-added"),
+  payload: AnalyticsMutationPaymentInfoAddedSchema.omit(omitEnvelopeFields)
+});
+const AnalyticsEventOrderPlacedSchema = AnalyticsEventEnvelopeSchema.extend({
+  type: z.literal("order-placed"),
+  payload: AnalyticsMutationOrderPlacedSchema.omit(omitEnvelopeFields)
+});
+const AnalyticsEventQuoteRequestedSchema = AnalyticsEventEnvelopeSchema.extend({
+  type: z.literal("quote-requested"),
+  payload: AnalyticsMutationQuoteRequestedSchema.omit(omitEnvelopeFields)
+});
+const AnalyticsEventOrderReorderedSchema = AnalyticsEventEnvelopeSchema.extend({
+  type: z.literal("order-reordered"),
+  payload: AnalyticsMutationOrderReorderedSchema.omit(omitEnvelopeFields)
+});
+const AnalyticsEventCompanyRegisteredSchema = AnalyticsEventEnvelopeSchema.extend({
+  type: z.literal("company-registered"),
+  payload: AnalyticsMutationCompanyRegisteredSchema.omit(omitEnvelopeFields)
+});
+const AnalyticsEventUserLoggedInSchema = AnalyticsEventEnvelopeSchema.extend({
+  type: z.literal("user-logged-in"),
+  payload: AnalyticsMutationUserLoggedInSchema.omit(omitEnvelopeFields)
+});
+const AnalyticsEventUserLoggedOutSchema = AnalyticsEventEnvelopeSchema.extend({
+  type: z.literal("user-logged-out"),
+  payload: AnalyticsMutationUserLoggedOutSchema.omit(omitEnvelopeFields)
+});
+const AnalyticsEventUserRegisteredSchema = AnalyticsEventEnvelopeSchema.extend({
+  type: z.literal("user-registered"),
+  payload: AnalyticsMutationUserRegisteredSchema.omit(omitEnvelopeFields)
+});
+const AnalyticsEventProfileUpdatedSchema = AnalyticsEventEnvelopeSchema.extend({
+  type: z.literal("profile-updated"),
+  payload: AnalyticsMutationProfileUpdatedSchema.omit(omitEnvelopeFields)
+});
+const AnalyticsEventConsentChangedSchema = AnalyticsEventEnvelopeSchema.extend({
+  type: z.literal("consent-changed"),
+  payload: AnalyticsMutationConsentChangedSchema.omit(omitEnvelopeFields)
+});
+const AnalyticsEventNewsletterSubscribedSchema = AnalyticsEventEnvelopeSchema.extend({
+  type: z.literal("newsletter-subscribed"),
+  payload: AnalyticsMutationNewsletterSubscribedSchema.omit(omitEnvelopeFields)
+});
+const AnalyticsEventWishlistItemAddedSchema = AnalyticsEventEnvelopeSchema.extend({
+  type: z.literal("wishlist-item-added"),
+  payload: AnalyticsMutationWishlistItemAddedSchema.omit(omitEnvelopeFields)
+});
+const AnalyticsEventWishlistItemRemovedSchema = AnalyticsEventEnvelopeSchema.extend({
+  type: z.literal("wishlist-item-removed"),
+  payload: AnalyticsMutationWishlistItemRemovedSchema.omit(omitEnvelopeFields)
+});
+const AnalyticsEventBackInStockRequestedSchema = AnalyticsEventEnvelopeSchema.extend({
+  type: z.literal("back-in-stock-requested"),
+  payload: AnalyticsMutationBackInStockRequestedSchema.omit(omitEnvelopeFields)
+});
+const AnalyticsEventReviewSubmittedSchema = AnalyticsEventEnvelopeSchema.extend({
+  type: z.literal("review-submitted"),
+  payload: AnalyticsMutationReviewSubmittedSchema.omit(omitEnvelopeFields)
+});
+const AnalyticsEventStoreSelectedSchema = AnalyticsEventEnvelopeSchema.extend({
+  type: z.literal("store-selected"),
+  payload: AnalyticsMutationStoreSelectedSchema.omit(omitEnvelopeFields)
+});
+const AnalyticsEventProductSharedSchema = AnalyticsEventEnvelopeSchema.extend({
+  type: z.literal("product-shared"),
+  payload: AnalyticsMutationProductSharedSchema.omit(omitEnvelopeFields)
+});
+const AnalyticsEventCustomSchema = AnalyticsEventEnvelopeSchema.extend({
+  type: z.literal("custom"),
+  payload: AnalyticsMutationCustomSchema.omit(omitEnvelopeFields)
+});
+const AnalyticsEventSchema = z.discriminatedUnion("type", [
+  AnalyticsEventPageViewedSchema,
+  AnalyticsEventSearchResultsViewedSchema,
+  AnalyticsEventAutocompleteSuggestionSelectedSchema,
+  AnalyticsEventCategoryViewedSchema,
+  AnalyticsEventProductCarouselViewedSchema,
+  AnalyticsEventProductClickedSchema,
+  AnalyticsEventProductViewedSchema,
+  AnalyticsEventPromotionViewedSchema,
+  AnalyticsEventPromotionClickedSchema,
+  AnalyticsEventCartItemAddedSchema,
+  AnalyticsEventCartItemRemovedSchema,
+  AnalyticsEventCartItemQuantityChangedSchema,
+  AnalyticsEventCartViewedSchema,
+  AnalyticsEventCouponAppliedSchema,
+  AnalyticsEventCouponRejectedSchema,
+  AnalyticsEventCheckoutStartedSchema,
+  AnalyticsEventShippingInfoAddedSchema,
+  AnalyticsEventPaymentInfoAddedSchema,
+  AnalyticsEventOrderPlacedSchema,
+  AnalyticsEventQuoteRequestedSchema,
+  AnalyticsEventOrderReorderedSchema,
+  AnalyticsEventCompanyRegisteredSchema,
+  AnalyticsEventUserLoggedInSchema,
+  AnalyticsEventUserLoggedOutSchema,
+  AnalyticsEventUserRegisteredSchema,
+  AnalyticsEventProfileUpdatedSchema,
+  AnalyticsEventConsentChangedSchema,
+  AnalyticsEventNewsletterSubscribedSchema,
+  AnalyticsEventWishlistItemAddedSchema,
+  AnalyticsEventWishlistItemRemovedSchema,
+  AnalyticsEventBackInStockRequestedSchema,
+  AnalyticsEventReviewSubmittedSchema,
+  AnalyticsEventStoreSelectedSchema,
+  AnalyticsEventProductSharedSchema,
+  AnalyticsEventCustomSchema
+]);
+export {
+  AnalyticsEventAutocompleteSuggestionSelectedSchema,
+  AnalyticsEventBackInStockRequestedSchema,
+  AnalyticsEventCartItemAddedSchema,
+  AnalyticsEventCartItemQuantityChangedSchema,
+  AnalyticsEventCartItemRemovedSchema,
+  AnalyticsEventCartViewedSchema,
+  AnalyticsEventCategoryViewedSchema,
+  AnalyticsEventCheckoutStartedSchema,
+  AnalyticsEventCompanyRegisteredSchema,
+  AnalyticsEventConsentChangedSchema,
+  AnalyticsEventCouponAppliedSchema,
+  AnalyticsEventCouponRejectedSchema,
+  AnalyticsEventCustomSchema,
+  AnalyticsEventNewsletterSubscribedSchema,
+  AnalyticsEventOrderPlacedSchema,
+  AnalyticsEventOrderReorderedSchema,
+  AnalyticsEventPageViewedSchema,
+  AnalyticsEventPaymentInfoAddedSchema,
+  AnalyticsEventProductCarouselViewedSchema,
+  AnalyticsEventProductClickedSchema,
+  AnalyticsEventProductSharedSchema,
+  AnalyticsEventProductViewedSchema,
+  AnalyticsEventProfileUpdatedSchema,
+  AnalyticsEventPromotionClickedSchema,
+  AnalyticsEventPromotionViewedSchema,
+  AnalyticsEventQuoteRequestedSchema,
+  AnalyticsEventReviewSubmittedSchema,
+  AnalyticsEventSchema,
+  AnalyticsEventSearchResultsViewedSchema,
+  AnalyticsEventShippingInfoAddedSchema,
+  AnalyticsEventStoreSelectedSchema,
+  AnalyticsEventUserLoggedInSchema,
+  AnalyticsEventUserLoggedOutSchema,
+  AnalyticsEventUserRegisteredSchema,
+  AnalyticsEventWishlistItemAddedSchema,
+  AnalyticsEventWishlistItemRemovedSchema
+};

package/schemas/models/analytics/index.js

@@ -0,0 +1,6 @@
+export * from "./consent.model.js";
+export * from "./dispatch.model.js";
+export * from "./envelope.model.js";
+export * from "./event-parts.model.js";
+export * from "./event.model.js";
+export * from "./origin.model.js";

package/schemas/models/analytics/origin.model.js

@@ -0,0 +1,113 @@
+import * as z from "zod";
+import {
+  CategoryIdentifierSchema,
+  FacetValueIdentifierSchema,
+  OrderIdentifierSchema,
+  ProductIdentifierSchema,
+  ProductListIdentifierSchema,
+  ProductRecommendationIdentifierSchema,
+  ProductSearchIdentifierSchema,
+  PromotionIdentifierSchema
+} from "../identifiers.model.js";
+const PositionSchema = z.int().min(0).meta({ description: "Absolute 0-based index of the item across all pages of the originating list." });
+const AssociationKindSchema = z.enum(["related", "cross-sell", "upsell", "accessories"]).meta({ description: "The kind of product association the visitor came from." });
+const CartOriginKindSchema = z.enum(["page", "mini-cart", "upsell"]).meta({ description: "Which cart surface the visitor came from." });
+const QuickOrderKindSchema = z.enum(["sku-entry", "csv", "scan"]).meta({ description: "How the items were entered in the quick order flow." });
+const OriginSearchSchema = z.looseObject({
+  type: z.literal("search"),
+  identifier: ProductSearchIdentifierSchema.meta({ description: "The search the visitor came from, including term, facets and paging. Vendor query ids ride on provider subtypes of this identifier." }),
+  position: PositionSchema
+});
+const OriginAutocompleteSchema = z.looseObject({
+  type: z.literal("autocomplete"),
+  term: z.string().meta({ description: "The autocomplete term." }),
+  position: PositionSchema
+});
+const OriginCategorySchema = z.looseObject({
+  type: z.literal("category"),
+  categoryId: CategoryIdentifierSchema,
+  filters: z.array(FacetValueIdentifierSchema).default(() => []).meta({ description: "Facet values active on the category listing." }),
+  position: PositionSchema
+});
+const OriginListSchema = z.looseObject({
+  type: z.literal("list"),
+  recommendationId: ProductRecommendationIdentifierSchema.optional().meta({ description: "The recommendation the carousel was built from, if any." }),
+  carouselName: z.string().meta({ description: "Storefront name of the recommendation or merchandised carousel." }),
+  position: PositionSchema
+});
+const OriginAssociationsSchema = z.looseObject({
+  type: z.literal("associations"),
+  productId: ProductIdentifierSchema.meta({ description: "The product whose associations were shown." }),
+  kind: AssociationKindSchema,
+  position: PositionSchema
+});
+const OriginProductListSchema = z.looseObject({
+  type: z.literal("product-list"),
+  listId: ProductListIdentifierSchema,
+  position: PositionSchema
+});
+const OriginPromotionSchema = z.looseObject({
+  type: z.literal("promotion"),
+  promotionId: PromotionIdentifierSchema,
+  slot: z.string().meta({ description: "The placement of the promotion." })
+});
+const OriginContentSchema = z.looseObject({
+  type: z.literal("content"),
+  contentId: z.string(),
+  slot: z.string().optional()
+});
+const OriginCartSchema = z.looseObject({
+  type: z.literal("cart"),
+  kind: CartOriginKindSchema.optional()
+});
+const OriginOrderSchema = z.looseObject({
+  type: z.literal("order"),
+  orderId: OrderIdentifierSchema.meta({ description: "The order the items were reordered from." })
+});
+const OriginQuickOrderSchema = z.looseObject({
+  type: z.literal("quick-order"),
+  kind: QuickOrderKindSchema.optional()
+});
+const OriginDirectSchema = z.looseObject({
+  type: z.literal("direct")
+});
+const OriginPdpSchema = z.looseObject({
+  type: z.literal("pdp"),
+  get upstream() {
+    return OriginSchema.optional().meta({ description: "The origin of the visit to the product detail page, so conversions stay attributed to the list that led there." });
+  }
+});
+const OriginSchema = z.discriminatedUnion("type", [
+  OriginSearchSchema,
+  OriginAutocompleteSchema,
+  OriginCategorySchema,
+  OriginListSchema,
+  OriginAssociationsSchema,
+  OriginProductListSchema,
+  OriginPromotionSchema,
+  OriginContentSchema,
+  OriginCartSchema,
+  OriginOrderSchema,
+  OriginQuickOrderSchema,
+  OriginPdpSchema,
+  OriginDirectSchema
+]).meta({ description: "Where the visitor encountered the item or surface an event relates to." });
+export {
+  AssociationKindSchema,
+  CartOriginKindSchema,
+  OriginAssociationsSchema,
+  OriginAutocompleteSchema,
+  OriginCartSchema,
+  OriginCategorySchema,
+  OriginContentSchema,
+  OriginDirectSchema,
+  OriginListSchema,
+  OriginOrderSchema,
+  OriginPdpSchema,
+  OriginProductListSchema,
+  OriginPromotionSchema,
+  OriginQuickOrderSchema,
+  OriginSchema,
+  OriginSearchSchema,
+  QuickOrderKindSchema
+};

package/schemas/models/analytics.model.js

@@ -1,6 +1,5 @@
 import * as z from "zod";
 import { BaseModelSchema } from "./base.model.js";
-const AnalyticsEventSchema = BaseModelSchema.extend({});
 const AnalyticsOutcomeSchema = z.enum(["accepted", "ignored", "rejected"]);
 const AnalyticsProviderOutcomeSchema = z.object({
   provider: z.string(),
@@ -10,7 +9,6 @@ const AnalyticsResultSchema = BaseModelSchema.extend({
   outcomes: z.array(AnalyticsProviderOutcomeSchema)
 });
 export {
-  AnalyticsEventSchema,
   AnalyticsOutcomeSchema,
   AnalyticsProviderOutcomeSchema,
   AnalyticsResultSchema

package/schemas/models/index.js

@@ -1,4 +1,5 @@
 export * from "./analytics.model.js";
+export * from "./analytics/index.js";
 export * from "./base.model.js";
 export * from "./cart.model.js";
 export * from "./category.model.js";

package/schemas/mutations/analytics/events/account.mutation.js

@@ -0,0 +1,66 @@
+import * as z from "zod";
+import { AnalyticsConsentSchema } from "../../../models/analytics/consent.model.js";
+import { AnalyticsChannelSchema, AnalyticsProductRefSchema, AnalyticsStoreRefSchema } from "../../../models/analytics/event-parts.model.js";
+import { IdentitySchema } from "../../../models/identity.model.js";
+import { PersonalizationProfileIdentifierSchema, ProductListIdentifierSchema, ProductVariantIdentifierSchema } from "../../../models/identifiers.model.js";
+import { ProfileSchema } from "../../../models/profile.model.js";
+import { AnalyticsEventMutationBaseSchema } from "./base.mutation.js";
+const AnalyticsMutationUserLoggedInSchema = AnalyticsEventMutationBaseSchema.extend({
+  identity: IdentitySchema.meta({ description: "The identity after login." }),
+  previousMarketingId: PersonalizationProfileIdentifierSchema.optional().meta({ description: "The marketing identifier the visitor had before logging in, so CDPs can merge profiles. Login does not rotate the marketing identifier in core, so the storefront supplies it when it knows it." })
+});
+const AnalyticsMutationUserLoggedOutSchema = AnalyticsEventMutationBaseSchema.extend({});
+const AnalyticsMutationUserRegisteredSchema = AnalyticsEventMutationBaseSchema.extend({
+  identity: IdentitySchema
+});
+const AnalyticsMutationProfileUpdatedSchema = AnalyticsEventMutationBaseSchema.extend({
+  profile: ProfileSchema,
+  changedFields: z.array(z.string()).optional()
+});
+const AnalyticsMutationConsentChangedSchema = AnalyticsEventMutationBaseSchema.extend({
+  consent: AnalyticsConsentSchema.meta({ description: "The new consent. Also applies to subsequent events in this request." })
+});
+const AnalyticsMutationNewsletterSubscribedSchema = AnalyticsEventMutationBaseSchema.extend({
+  channel: AnalyticsChannelSchema.optional()
+});
+const AnalyticsMutationWishlistItemAddedSchema = AnalyticsEventMutationBaseSchema.extend({
+  list: ProductListIdentifierSchema,
+  variant: ProductVariantIdentifierSchema
+});
+const AnalyticsMutationWishlistItemRemovedSchema = AnalyticsEventMutationBaseSchema.extend({
+  list: ProductListIdentifierSchema,
+  variant: ProductVariantIdentifierSchema
+});
+const AnalyticsMutationBackInStockRequestedSchema = AnalyticsEventMutationBaseSchema.extend({
+  variant: ProductVariantIdentifierSchema
+});
+const AnalyticsMutationReviewSubmittedSchema = AnalyticsEventMutationBaseSchema.extend({
+  product: AnalyticsProductRefSchema,
+  rating: z.number().min(0)
+});
+const AnalyticsMutationStoreSelectedSchema = AnalyticsEventMutationBaseSchema.extend({
+  store: AnalyticsStoreRefSchema
+});
+const AnalyticsMutationProductSharedSchema = AnalyticsEventMutationBaseSchema.extend({
+  product: AnalyticsProductRefSchema,
+  channel: AnalyticsChannelSchema.optional()
+});
+const AnalyticsMutationCustomSchema = AnalyticsEventMutationBaseSchema.extend({
+  name: z.string().min(1).meta({ description: "The custom event name. Providers ignore names they do not recognise." }),
+  payload: z.record(z.string(), z.unknown())
+});
+export {
+  AnalyticsMutationBackInStockRequestedSchema,
+  AnalyticsMutationConsentChangedSchema,
+  AnalyticsMutationCustomSchema,
+  AnalyticsMutationNewsletterSubscribedSchema,
+  AnalyticsMutationProductSharedSchema,
+  AnalyticsMutationProfileUpdatedSchema,
+  AnalyticsMutationReviewSubmittedSchema,
+  AnalyticsMutationStoreSelectedSchema,
+  AnalyticsMutationUserLoggedInSchema,
+  AnalyticsMutationUserLoggedOutSchema,
+  AnalyticsMutationUserRegisteredSchema,
+  AnalyticsMutationWishlistItemAddedSchema,
+  AnalyticsMutationWishlistItemRemovedSchema
+};

package/schemas/mutations/analytics/events/base.mutation.js

@@ -0,0 +1,10 @@
+import * as z from "zod";
+import { OriginSchema } from "../../../models/analytics/origin.model.js";
+import { BaseMutationSchema } from "../../base.mutation.js";
+const AnalyticsEventMutationBaseSchema = BaseMutationSchema.extend({
+  origin: OriginSchema.optional().meta({ description: "Where the visitor encountered the item or surface. Meaningful on product-centred events." }),
+  properties: z.record(z.string(), z.unknown()).optional().meta({ description: "Storefront-only knowledge such as an experiment variant. Not a channel for product data; providers look that up." })
+});
+export {
+  AnalyticsEventMutationBaseSchema
+};

package/schemas/mutations/analytics/events/browse.mutation.js

@@ -0,0 +1,53 @@
+import * as z from "zod";
+import {
+  AnalyticsAutocompleteSuggestionSchema,
+  AnalyticsCarouselSchema,
+  AnalyticsCategoryRefSchema,
+  AnalyticsPageViewSchema,
+  AnalyticsProductRefSchema,
+  AnalyticsPromotionSchema
+} from "../../../models/analytics/event-parts.model.js";
+import { ProductSearchIdentifierSchema } from "../../../models/identifiers.model.js";
+import { AnalyticsEventMutationBaseSchema } from "./base.mutation.js";
+const AnalyticsMutationPageViewedSchema = AnalyticsEventMutationBaseSchema.extend({
+  page: AnalyticsPageViewSchema
+});
+const AnalyticsMutationSearchResultsViewedSchema = AnalyticsEventMutationBaseSchema.extend({
+  search: ProductSearchIdentifierSchema.meta({ description: "The search that produced the results." }),
+  products: z.array(AnalyticsProductRefSchema).meta({ description: "The products shown. An empty list means zero results." })
+});
+const AnalyticsMutationAutocompleteSuggestionSelectedSchema = AnalyticsEventMutationBaseSchema.extend({
+  suggestion: AnalyticsAutocompleteSuggestionSchema,
+  position: z.int().min(0)
+});
+const AnalyticsMutationCategoryViewedSchema = AnalyticsEventMutationBaseSchema.extend({
+  category: AnalyticsCategoryRefSchema,
+  products: z.array(AnalyticsProductRefSchema).optional()
+});
+const AnalyticsMutationProductCarouselViewedSchema = AnalyticsEventMutationBaseSchema.extend({
+  carousel: AnalyticsCarouselSchema,
+  products: z.array(AnalyticsProductRefSchema)
+});
+const AnalyticsMutationProductClickedSchema = AnalyticsEventMutationBaseSchema.extend({
+  product: AnalyticsProductRefSchema
+});
+const AnalyticsMutationProductViewedSchema = AnalyticsEventMutationBaseSchema.extend({
+  product: AnalyticsProductRefSchema
+});
+const AnalyticsMutationPromotionViewedSchema = AnalyticsEventMutationBaseSchema.extend({
+  promotion: AnalyticsPromotionSchema
+});
+const AnalyticsMutationPromotionClickedSchema = AnalyticsEventMutationBaseSchema.extend({
+  promotion: AnalyticsPromotionSchema
+});
+export {
+  AnalyticsMutationAutocompleteSuggestionSelectedSchema,
+  AnalyticsMutationCategoryViewedSchema,
+  AnalyticsMutationPageViewedSchema,
+  AnalyticsMutationProductCarouselViewedSchema,
+  AnalyticsMutationProductClickedSchema,
+  AnalyticsMutationProductViewedSchema,
+  AnalyticsMutationPromotionClickedSchema,
+  AnalyticsMutationPromotionViewedSchema,
+  AnalyticsMutationSearchResultsViewedSchema
+};

package/schemas/mutations/analytics/events/commerce.mutation.js

@@ -0,0 +1,79 @@
+import * as z from "zod";
+import { AnalyticsCouponRejectionReasonSchema, AnalyticsStoreRefSchema } from "../../../models/analytics/event-parts.model.js";
+import { CartItemSchema, CartSchema } from "../../../models/cart.model.js";
+import { CompanySchema } from "../../../models/company.model.js";
+import { ProductVariantIdentifierSchema } from "../../../models/identifiers.model.js";
+import { OrderSchema } from "../../../models/order.model.js";
+import { PaymentMethodSchema } from "../../../models/payment.model.js";
+import { ShippingMethodSchema } from "../../../models/shipping-method.model.js";
+import { AnalyticsEventMutationBaseSchema } from "./base.mutation.js";
+const quantity = () => z.number().positive();
+const AnalyticsMutationCartItemAddedSchema = AnalyticsEventMutationBaseSchema.extend({
+  cart: CartSchema.meta({ description: "The cart after the item was added." }),
+  variant: ProductVariantIdentifierSchema,
+  quantity: quantity().meta({ description: "The quantity that was added." })
+});
+const AnalyticsMutationCartItemRemovedSchema = AnalyticsEventMutationBaseSchema.extend({
+  cart: CartSchema.meta({ description: "The cart after the item was removed." }),
+  // Identifier first: CartItemSchema defaults throw on input that lacks required keys instead of failing the union branch.
+  removed: z.union([ProductVariantIdentifierSchema, CartItemSchema]).meta({ description: "The line the storefront rendered, or its sku. The line is gone from the resulting cart." }),
+  quantity: quantity().optional().meta({ description: "The quantity removed. Defaults to the full quantity of the removed line when that is known." })
+});
+const AnalyticsMutationCartItemQuantityChangedSchema = AnalyticsEventMutationBaseSchema.extend({
+  cart: CartSchema,
+  variant: ProductVariantIdentifierSchema,
+  previousQuantity: z.number().min(0),
+  newQuantity: z.number().min(0)
+});
+const AnalyticsMutationCartViewedSchema = AnalyticsEventMutationBaseSchema.extend({
+  cart: CartSchema
+});
+const AnalyticsMutationCouponAppliedSchema = AnalyticsEventMutationBaseSchema.extend({
+  cart: CartSchema,
+  code: z.string()
+});
+const AnalyticsMutationCouponRejectedSchema = AnalyticsEventMutationBaseSchema.extend({
+  cart: CartSchema,
+  code: z.string(),
+  reason: AnalyticsCouponRejectionReasonSchema.optional()
+});
+const AnalyticsMutationCheckoutStartedSchema = AnalyticsEventMutationBaseSchema.extend({
+  cart: CartSchema
+});
+const AnalyticsMutationShippingInfoAddedSchema = AnalyticsEventMutationBaseSchema.extend({
+  cart: CartSchema,
+  shippingMethod: ShippingMethodSchema.optional(),
+  store: AnalyticsStoreRefSchema.optional().meta({ description: "The pickup store, for click and collect." })
+});
+const AnalyticsMutationPaymentInfoAddedSchema = AnalyticsEventMutationBaseSchema.extend({
+  cart: CartSchema,
+  paymentMethod: PaymentMethodSchema
+});
+const AnalyticsMutationOrderPlacedSchema = AnalyticsEventMutationBaseSchema.extend({
+  order: OrderSchema
+});
+const AnalyticsMutationQuoteRequestedSchema = AnalyticsEventMutationBaseSchema.extend({
+  cart: CartSchema
+});
+const AnalyticsMutationOrderReorderedSchema = AnalyticsEventMutationBaseSchema.extend({
+  order: OrderSchema.meta({ description: "The order the items were reordered from." }),
+  cart: CartSchema.meta({ description: "The cart the items were added to." })
+});
+const AnalyticsMutationCompanyRegisteredSchema = AnalyticsEventMutationBaseSchema.extend({
+  company: CompanySchema
+});
+export {
+  AnalyticsMutationCartItemAddedSchema,
+  AnalyticsMutationCartItemQuantityChangedSchema,
+  AnalyticsMutationCartItemRemovedSchema,
+  AnalyticsMutationCartViewedSchema,
+  AnalyticsMutationCheckoutStartedSchema,
+  AnalyticsMutationCompanyRegisteredSchema,
+  AnalyticsMutationCouponAppliedSchema,
+  AnalyticsMutationCouponRejectedSchema,
+  AnalyticsMutationOrderPlacedSchema,
+  AnalyticsMutationOrderReorderedSchema,
+  AnalyticsMutationPaymentInfoAddedSchema,
+  AnalyticsMutationQuoteRequestedSchema,
+  AnalyticsMutationShippingInfoAddedSchema
+};