@reactionary/core 0.8.0 → 0.9.1

package/capabilities/feature-flag.capability.js

@@ -0,0 +1,25 @@
+import { BaseCapability } from "./base.capability.js";
+class FeatureFlagCapability extends BaseCapability {
+  getResourceName() {
+    return "feature-flags";
+  }
+  isEnabled(flags, key, variant) {
+    const flag = flags.find((f) => f.identifier.key === key);
+    if (!flag) {
+      return false;
+    }
+    if (flag.type === "boolean") {
+      return flag.enabled;
+    }
+    if (variant) {
+      if (flag.type === "multivariate") {
+        return flag.variants.some((v) => v.name === variant && v.enabled);
+      }
+      return false;
+    }
+    return false;
+  }
+}
+export {
+  FeatureFlagCapability
+};

package/capabilities/index.js

@@ -3,20 +3,22 @@ export * from "./base.capability.js";
 export * from "./cart.capability.js";
 export * from "./category.capability.js";
 export * from "./checkout.capability.js";
+export * from "./company-registration.capability.js";
+export * from "./company.capability.js";
+export * from "./employee-invitation.capability.js";
+export * from "./employee.capability.js";
+export * from "./feature-flag.capability.js";
 export * from "./identity.capability.js";
 export * from "./inventory.capability.js";
+export * from "./personalization-profile.capability.js";
+export * from "./order-search.capability.js";
+export * from "./order.capability.js";
 export * from "./price.capability.js";
-export * from "./product.capability.js";
-export * from "./profile.capability.js";
-export * from "./product-search.capability.js";
-export * from "./product-recommendations.capability.js";
 export * from "./product-associations.capability.js";
-export * from "./product-reviews.capability.js";
 export * from "./product-list.capability.js";
+export * from "./product-recommendations.capability.js";
+export * from "./product-reviews.capability.js";
+export * from "./product-search.capability.js";
+export * from "./product.capability.js";
+export * from "./profile.capability.js";
 export * from "./store.capability.js";
-export * from "./order.capability.js";
-export * from "./order-search.capability.js";
-export * from "./company-registration.capability.js";
-export * from "./employee.capability.js";
-export * from "./employee-invitation.capability.js";
-export * from "./company.capability.js";

package/capabilities/personalization-profile.capability.js

@@ -0,0 +1,9 @@
+import { BaseCapability } from "./base.capability.js";
+class PersonalizationProfileCapability extends BaseCapability {
+  getResourceName() {
+    return "personalization-profile";
+  }
+}
+export {
+  PersonalizationProfileCapability
+};

package/factories/index.js

@@ -5,8 +5,10 @@ export * from "./company-registration.factory.js";
 export * from "./company.factory.js";
 export * from "./employee-invitation.factory.js";
 export * from "./employee.factory.js";
+export * from "./feature-flag.factory.js";
 export * from "./identity.factory.js";
 export * from "./inventory.factory.js";
+export * from "./personalization-profile.factory.js";
 export * from "./order.factory.js";
 export * from "./order-search.factory.js";
 export * from "./price.factory.js";

package/initialization.js

@@ -18,8 +18,12 @@ function createInitialRequestContext() {
         identity: {
           type: "Anonymous"
         },
-        lastUpdated: /* @__PURE__ */ new Date(),
-        personalizationKey: crypto.randomUUID()
+        lastUpdated: /* @__PURE__ */ new Date()
+      },
+      marketingContext: {
+        identifier: { key: "" },
+        segments: [],
+        blurb: ""
       }
     },
     correlationId: "",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reactionary/core",
-  "version": "0.8.0",
+  "version": "0.9.1",
   "type": "module",
   "main": "./index.js",
   "types": "./src/index.d.ts",

package/schemas/capabilities.schema.js

@@ -16,7 +16,9 @@ const CapabilitiesSchema = z.looseObject({
   price: z.boolean(),
   category: z.boolean(),
   store: z.boolean(),
-  profile: z.boolean()
+  profile: z.boolean(),
+  featureFlag: z.boolean(),
+  personalizationProfile: z.boolean()
 });
 export {
   CapabilitiesSchema

package/schemas/models/feature-flags.model.js

@@ -0,0 +1,27 @@
+import { BaseModelSchema } from "./base.model.js";
+import * as z from "zod";
+import { FeatureFlagIdentifierSchema } from "./identifiers.model.js";
+const BaseFeatureFlagSchema = BaseModelSchema.extend({
+  identifier: FeatureFlagIdentifierSchema
+});
+const BooleanFeatureFlagSchema = BaseFeatureFlagSchema.extend({
+  type: z.literal("boolean").meta({ description: "The type of feature flag, which is boolean in this case." }),
+  enabled: z.boolean().meta({ description: "Indicates whether the feature flag is enabled or not." })
+});
+const MultivariateFeatureFlagSchema = BaseFeatureFlagSchema.extend({
+  type: z.literal("multivariate").meta({ description: "The type of feature flag, which is multivariate in this case." }),
+  variants: z.array(z.object({
+    name: z.string().meta({ description: "The name of the variant." }),
+    enabled: z.boolean().meta({ description: "Indicates whether the variant is enabled or not." })
+  })).meta({ description: "The variants for the multivariate feature flag." })
+});
+const FeatureFlagSchema = z.discriminatedUnion("type", [
+  BooleanFeatureFlagSchema,
+  MultivariateFeatureFlagSchema
+]);
+export {
+  BaseFeatureFlagSchema,
+  BooleanFeatureFlagSchema,
+  FeatureFlagSchema,
+  MultivariateFeatureFlagSchema
+};

package/schemas/models/identifiers.model.js

@@ -115,6 +115,7 @@ const ProductSearchIdentifierSchema = z.looseObject({
   paginationOptions: PaginationOptionsSchema.meta({ description: "Pagination options for the search results." }),
   categoryFilter: FacetValueIdentifierSchema.optional().meta({ description: "An optional category filter applied to the search results." }),
   company: CompanyIdentifierSchema.optional().meta({ description: "The identifier for the company to search products within. This can be used to filter products by specific companies, which can be useful for B2B use cases." })
+  //  personalizationProfile: PersonalizationProfileSchema.optional().meta({ description: 'The marketing profile of the user performing the search. This can be used to provide personalized search results based on the user\'s segments and other attributes defined in their marketing profile.' }),
 });
 const OrderSearchIdentifierSchema = z.looseObject({
   term: z.string().meta({ description: "The search term used to find orders. Not all providers may support term-based search for orders." }),
@@ -178,6 +179,12 @@ const CartSearchIdentifierSchema = z.looseObject({
   company: CompanyIdentifierSchema.optional().meta({ description: "The identifier for the company to search carts within. This can be used to filter carts by specific companies, which can be useful for B2B use cases." }),
   paginationOptions: PaginationOptionsSchema.meta({ description: "Pagination options for the search results." })
 });
+const PersonalizationProfileIdentifierSchema = z.looseObject({
+  key: z.string().meta({ description: "The unique identifier for the personalization profile." })
+});
+const FeatureFlagIdentifierSchema = z.looseObject({
+  key: z.string().meta({ description: "The unique identifier for the feature flag." })
+});
 export {
   AddressIdentifierSchema,
   CartIdentifierSchema,
@@ -198,6 +205,7 @@ export {
   EmployeeSearchIdentifierSchema,
   FacetIdentifierSchema,
   FacetValueIdentifierSchema,
+  FeatureFlagIdentifierSchema,
   FulfillmentCenterIdentifierSchema,
   IdentityIdentifierSchema,
   InventoryIdentifierSchema,
@@ -208,6 +216,7 @@ export {
   OrderStatusSchema,
   PaymentInstructionIdentifierSchema,
   PaymentMethodIdentifierSchema,
+  PersonalizationProfileIdentifierSchema,
   PickupPointIdentifierSchema,
   PriceIdentifierSchema,
   ProductAssociationsIdentifierSchema,

package/schemas/models/index.js

@@ -26,3 +26,5 @@ export * from "./company.model.js";
 export * from "./company-registration.model.js";
 export * from "./employee.model.js";
 export * from "./employee-invitation.model.js";
+export * from "./feature-flags.model.js";
+export * from "./personalization-profile.model.js";

package/schemas/models/personalization-profile.model.js

@@ -0,0 +1,10 @@
+import * as z from "zod";
+import { PersonalizationProfileIdentifierSchema } from "./identifiers.model.js";
+const PersonalizationProfileSchema = z.looseObject({
+  identifier: PersonalizationProfileIdentifierSchema.meta({ description: "The identifier object for the marketing profile. This should contain a unique key that identifies the marketing profile." }),
+  segments: z.array(z.string()).default(() => []).meta({ description: "The segments that the marketing profile belongs to. This can be used for targeting specific segments with feature flags or other marketing activities." }),
+  blurb: z.string().default("").meta({ description: "A short description or blurb about the marketing profile. This can be used for informational purposes or to provide context about the marketing profile." })
+});
+export {
+  PersonalizationProfileSchema
+};

package/schemas/mutations/analytics/base-event.mutation.js

@@ -0,0 +1,8 @@
+import { PersonalizationProfileSchema } from "../../models/personalization-profile.model.js";
+import { BaseMutationSchema } from "../base.mutation.js";
+const AnalyticsBaseMutationSchema = BaseMutationSchema.extend({
+  personalizationProfile: PersonalizationProfileSchema.optional().meta({ description: "The personalization profile of the user associated with the event. This can be used to provide personalized experiences based on the user's segments and other attributes defined in their personalization profile, if any" })
+});
+export {
+  AnalyticsBaseMutationSchema
+};

package/schemas/mutations/analytics/index.js

@@ -16,6 +16,7 @@ export * from "./product-details-view.mutation.js";
 export * from "./product-summary-click.mutation.js";
 export * from "./product-summary-view.mutation.js";
 export * from "./purchase.mutation.js";
+export * from "./base-event.mutation.js";
 export {
   AnalyticsMutationSchema
 };

package/schemas/mutations/analytics/product-add-to-cart.mutation.js

@@ -1,10 +1,10 @@
 import * as z from "zod";
 import {
-  ProductSearchIdentifierSchema,
-  ProductIdentifierSchema
+  ProductIdentifierSchema,
+  ProductSearchIdentifierSchema
 } from "../../models/identifiers.model.js";
-import { BaseMutationSchema } from "../base.mutation.js";
-const AnalyticsMutationProductAddToCartEventSchema = BaseMutationSchema.extend({
+import { AnalyticsBaseMutationSchema } from "./base-event.mutation.js";
+const AnalyticsMutationProductAddToCartEventSchema = AnalyticsBaseMutationSchema.extend({
   event: z.literal("product-cart-add"),
   source: z.discriminatedUnion("type", [
     z.object({

package/schemas/mutations/analytics/product-details-view.mutation.js

@@ -1,7 +1,8 @@
 import * as z from "zod";
 import { ProductIdentifierSchema } from "../../models/identifiers.model.js";
 import { BaseMutationSchema } from "../base.mutation.js";
-const AnalyticsMutationProductDetailsViewEventSchema = BaseMutationSchema.extend({
+import { AnalyticsBaseMutationSchema } from "./base-event.mutation.js";
+const AnalyticsMutationProductDetailsViewEventSchema = AnalyticsBaseMutationSchema.extend({
   event: z.literal("product-details-view"),
   product: ProductIdentifierSchema
 });

package/schemas/mutations/analytics/product-summary-click.mutation.js

@@ -4,7 +4,8 @@ import {
 } from "../../models/identifiers.model.js";
 import { BaseMutationSchema } from "../base.mutation.js";
 import * as z from "zod";
-const AnalyticsMutationProductSummaryClickEventSchema = BaseMutationSchema.extend({
+import { AnalyticsBaseMutationSchema } from "./base-event.mutation.js";
+const AnalyticsMutationProductSummaryClickEventSchema = AnalyticsBaseMutationSchema.extend({
   event: z.literal("product-summary-click"),
   product: ProductIdentifierSchema,
   source: z.discriminatedUnion("type", [

package/schemas/mutations/analytics/product-summary-view.mutation.js

@@ -4,7 +4,8 @@ import {
 } from "../../models/identifiers.model.js";
 import { BaseMutationSchema } from "../base.mutation.js";
 import * as z from "zod";
-const AnalyticsMutationProductSummaryViewEventSchema = BaseMutationSchema.extend({
+import { AnalyticsBaseMutationSchema } from "./base-event.mutation.js";
+const AnalyticsMutationProductSummaryViewEventSchema = AnalyticsBaseMutationSchema.extend({
   event: z.literal("product-summary-view"),
   source: z.discriminatedUnion("type", [
     z.object({

package/schemas/mutations/analytics/purchase.mutation.js

@@ -1,7 +1,8 @@
 import * as z from "zod";
 import { BaseMutationSchema } from "../base.mutation.js";
 import { OrderSchema } from "../../models/order.model.js";
-const AnalyticsMutationPurchaseEventSchema = BaseMutationSchema.extend({
+import { AnalyticsBaseMutationSchema } from "./base-event.mutation.js";
+const AnalyticsMutationPurchaseEventSchema = AnalyticsBaseMutationSchema.extend({
   event: z.literal("purchase"),
   order: OrderSchema
 });

package/schemas/queries/feature-flag.query.js

@@ -0,0 +1,11 @@
+import * as z from "zod";
+import { FeatureFlagIdentifierSchema } from "../models/identifiers.model.js";
+import { PersonalizationProfileSchema } from "../models/personalization-profile.model.js";
+import { BaseQuerySchema } from "./base.query.js";
+const FeatureFlagQueryGetFlagsSchema = BaseQuerySchema.extend({
+  featureFlagIdentifiers: z.array(FeatureFlagIdentifierSchema).meta({ description: "The identifiers of the feature flags to retrieve." }),
+  personalizationProfile: PersonalizationProfileSchema.optional().meta({ description: "The marketing profile to use for evaluating the feature flags." })
+});
+export {
+  FeatureFlagQueryGetFlagsSchema
+};

package/schemas/queries/index.js

@@ -20,3 +20,5 @@ export * from "./company-registration.query.js";
 export * from "./employee.query.js";
 export * from "./employee-invitation.query.js";
 export * from "./company.query.js";
+export * from "./feature-flag.query.js";
+export * from "./personalization-profile.query.js";

package/schemas/queries/personalization-profile.query.js

@@ -0,0 +1,10 @@
+import { IdentitySchema } from "../models/identity.model.js";
+import { ProfileSchema } from "../models/profile.model.js";
+import { BaseQuerySchema } from "./base.query.js";
+const PersonalizationProfileQueryGetProfileSchema = BaseQuerySchema.extend({
+  identity: IdentitySchema,
+  profile: ProfileSchema.optional()
+});
+export {
+  PersonalizationProfileQueryGetProfileSchema
+};

package/schemas/queries/product-recommendations.query.js

@@ -1,9 +1,11 @@
 import * as z from "zod";
 import { CategoryIdentifierSchema, ProductIdentifierSchema } from "../models/identifiers.model.js";
 import { BaseQuerySchema } from "./base.query.js";
+import { PersonalizationProfileSchema } from "../models/personalization-profile.model.js";
 const ProductRecommendationBaseQuerySchema = BaseQuerySchema.extend({
   numberOfRecommendations: z.number().min(1).max(12).meta({ description: "The number of recommendations requested. The provider may return fewer than this number, but should not return more." }),
-  labels: z.array(z.string()).optional().meta({ description: "The customer segments, quirks, chirps or other labels to which the recommendations can optimize themselves to be relevant. This can be used by the provider to personalize the recommendations based on the preferences and behaviors of users in these segments." })
+  personalizationProfile: PersonalizationProfileSchema.optional().meta({ description: "The marketing profile to use for personalizing the recommendations. This can be used by the provider to tailor the recommendations based on the preferences and behaviors of users in this marketing profile." }),
+  labels: z.array(z.string()).optional().meta({ description: "extra, quirks, chirps or other labels to which the recommendations can optimize themselves to be relevant. This can be used by the provider to personalize the recommendations based on the preferences and behaviors of users in these segments." })
 });
 const ProductRecommendationsByCollectionQuerySchema = ProductRecommendationBaseQuerySchema.extend({
   collectionName: z.string().meta({ description: "The name of the collection for which to get product recommendations. This is to access either manually curated lists, or interface marketing rules engines that define zones by name" }),

package/schemas/queries/product-search.query.js

@@ -2,8 +2,10 @@ import * as z from "zod";
 import { CategorySchema } from "../models/category.model.js";
 import { ProductSearchIdentifierSchema } from "../models/identifiers.model.js";
 import { BaseQuerySchema } from "./base.query.js";
+import { PersonalizationProfileSchema } from "../models/personalization-profile.model.js";
 const ProductSearchQueryByTermSchema = BaseQuerySchema.extend({
-  search: ProductSearchIdentifierSchema
+  search: ProductSearchIdentifierSchema,
+  personalizationProfile: PersonalizationProfileSchema.optional().meta({ description: "The marketing profile of the user performing the search. This can be used to provide personalized search results based on the user's segments and other attributes defined in their marketing profile." })
 });
 const ProductSearchQueryCreateNavigationFilterSchema = z.looseObject({
   categoryPath: z.array(CategorySchema).meta({ description: "An array representing the breadcrumb path to a category, from root to the specific category." })

package/schemas/session.schema.js

@@ -2,17 +2,18 @@ import * as z from "zod";
 import { WebStoreIdentifierSchema } from "./models/identifiers.model.js";
 import { CurrencySchema } from "./models/currency.model.js";
 import { IdentitySchema } from "./models/identity.model.js";
+import { PersonalizationProfileSchema } from "./models/personalization-profile.model.js";
 const LanguageContextSchema = z.looseObject({
   locale: z.string().default("en-US").meta({ description: "The locale for the current request, in IETF BCP 47 format (e.g. en-US, fr-FR). This can be used for localization and internationalization purposes." }),
   currencyCode: CurrencySchema.default(() => CurrencySchema.parse({}))
 });
 const IdentityContextSchema = z.looseObject({
   identity: IdentitySchema,
-  personalizationKey: z.string(),
   lastUpdated: z.coerce.date()
 });
 const SessionSchema = z.looseObject({
-  identityContext: IdentityContextSchema
+  identityContext: IdentityContextSchema,
+  marketingContext: PersonalizationProfileSchema.default(() => PersonalizationProfileSchema.parse({}))
 });
 const TaxJurisdictionSchema = z.object({
   countryCode: z.string().default("US"),
@@ -25,7 +26,7 @@ const RequestContextSchema = z.looseObject({
   languageContext: LanguageContextSchema.default(() => LanguageContextSchema.parse({})).describe("ReadOnly. The language and locale context for the current request."),
   storeIdentifier: WebStoreIdentifierSchema.default(() => WebStoreIdentifierSchema.parse({})).describe("ReadOnly. The identifier of the current web store making the request."),
   taxJurisdiction: TaxJurisdictionSchema.default(() => TaxJurisdictionSchema.parse({})).describe("ReadOnly. The tax jurisdiction for the current request, typically derived from the store location or carts billing address"),
-  companyIdentifier: z.string().optional().meta({ description: "The company associated with the request, if applicable. This can be used to segment requests and apply different logic or rules based on the business unit." }),
+  //    companyIdentifier: z.string().optional().meta({ description: 'The company associated with the request, if applicable. This can be used to segment requests and apply different logic or rules based on the business unit.' }),
   correlationId: z.string().default("").meta({ description: "A unique identifier for the request, can be used for tracing and logging purposes." }),
   isBot: z.boolean().default(false).meta({ description: "Indicates if the request is made by a bot or crawler." }),
   clientIp: z.string().default("").meta({ description: "The IP address of the client making the request, if available. Mostly for logging purposes" }),

package/src/capabilities/feature-flag.capability.d.ts

@@ -0,0 +1,9 @@
+import type { FeatureFlag } from "../schemas/models/feature-flags.model.js";
+import type { FeatureFlagQueryGetFlags } from "../schemas/queries/feature-flag.query.js";
+import type { Result } from "../schemas/result.js";
+import { BaseCapability } from "./base.capability.js";
+export declare abstract class FeatureFlagCapability<TFeatureFlag extends FeatureFlag = FeatureFlag> extends BaseCapability {
+    protected getResourceName(): string;
+    abstract getFlags(payload: FeatureFlagQueryGetFlags): Promise<Result<TFeatureFlag[]>>;
+    isEnabled(flags: TFeatureFlag[], key: string, variant?: string): boolean;
+}

package/src/capabilities/index.d.ts

@@ -3,20 +3,22 @@ export * from './base.capability.js';
 export * from './cart.capability.js';
 export * from './category.capability.js';
 export * from './checkout.capability.js';
+export * from './company-registration.capability.js';
+export * from './company.capability.js';
+export * from './employee-invitation.capability.js';
+export * from './employee.capability.js';
+export * from './feature-flag.capability.js';
 export * from './identity.capability.js';
 export * from './inventory.capability.js';
+export * from './personalization-profile.capability.js';
+export * from './order-search.capability.js';
+export * from './order.capability.js';
 export * from './price.capability.js';
-export * from './product.capability.js';
-export * from './profile.capability.js';
-export * from './product-search.capability.js';
-export * from './product-recommendations.capability.js';
 export * from './product-associations.capability.js';
-export * from './product-reviews.capability.js';
 export * from './product-list.capability.js';
+export * from './product-recommendations.capability.js';
+export * from './product-reviews.capability.js';
+export * from './product-search.capability.js';
+export * from './product.capability.js';
+export * from './profile.capability.js';
 export * from './store.capability.js';
-export * from './order.capability.js';
-export * from './order-search.capability.js';
-export * from './company-registration.capability.js';
-export * from './employee.capability.js';
-export * from './employee-invitation.capability.js';
-export * from './company.capability.js';

package/src/capabilities/personalization-profile.capability.d.ts

@@ -0,0 +1,9 @@
+import type { PersonalizationProfile } from "../schemas/models/personalization-profile.model.js";
+import type { PersonalizationProfileQueryGetProfile } from "../schemas/queries/personalization-profile.query.js";
+import type { NotFoundError } from "../schemas/errors/not-found.error.js";
+import type { Result } from "../schemas/result.js";
+import { BaseCapability } from "./base.capability.js";
+export declare abstract class PersonalizationProfileCapability<TPersonalizationProfile extends PersonalizationProfile = PersonalizationProfile> extends BaseCapability {
+    protected getResourceName(): string;
+    abstract getPersonalizationProfile(payload: PersonalizationProfileQueryGetProfile): Promise<Result<TPersonalizationProfile, NotFoundError>>;
+}

package/src/client/client.d.ts

@@ -12,6 +12,8 @@ import type { ProductRecommendationsCapability } from "../capabilities/product-r
 import type { ProductAssociationsCapability } from "../capabilities/product-associations.capability.js";
 import type { ProductReviewsCapability } from "../capabilities/product-reviews.capability.js";
 import type { EmployeeInvitationCapability } from "../capabilities/employee-invitation.capability.js";
+import type { FeatureFlagCapability } from "../capabilities/feature-flag.capability.js";
+import type { PersonalizationProfileCapability } from "../capabilities/personalization-profile.capability.js";
 export interface Client {
     product: ProductCapability;
     productSearch: ProductSearchCapability;
@@ -35,4 +37,6 @@ export interface Client {
     employee: EmployeeCapability;
     company: CompanyCapability;
     employeeInvitation: EmployeeInvitationCapability;
+    featureFlag: FeatureFlagCapability;
+    personalizationProfile: PersonalizationProfileCapability;
 }

package/src/factories/feature-flag.factory.d.ts

@@ -0,0 +1,12 @@
+import type * as z from 'zod';
+import type { FeatureFlagSchema } from '../schemas/models/feature-flags.model.js';
+import type { RequestContext } from '../schemas/session.schema.js';
+export type AnyFeatureFlagSchema = z.ZodType<z.output<typeof FeatureFlagSchema>>;
+export interface FeatureFlagFactory<TFeatureFlagSchema extends AnyFeatureFlagSchema = AnyFeatureFlagSchema> {
+    featureFlagSchema: TFeatureFlagSchema;
+    parseFeatureFlag(context: RequestContext, data: unknown): z.output<TFeatureFlagSchema>;
+}
+export type FeatureFlagFactoryOutput<TFactory extends FeatureFlagFactory> = ReturnType<TFactory['parseFeatureFlag']>;
+export type FeatureFlagFactoryWithOutput<TFactory extends FeatureFlagFactory> = Omit<TFactory, 'parseFeatureFlag'> & {
+    parseFeatureFlag(context: RequestContext, data: unknown): FeatureFlagFactoryOutput<TFactory>;
+};

package/src/factories/index.d.ts

@@ -5,8 +5,10 @@ export * from './company-registration.factory.js';
 export * from './company.factory.js';
 export * from './employee-invitation.factory.js';
 export * from './employee.factory.js';
+export * from './feature-flag.factory.js';
 export * from './identity.factory.js';
 export * from './inventory.factory.js';
+export * from './personalization-profile.factory.js';
 export * from './order.factory.js';
 export * from './order-search.factory.js';
 export * from './price.factory.js';

package/src/factories/personalization-profile.factory.d.ts

@@ -0,0 +1,12 @@
+import type * as z from 'zod';
+import type { PersonalizationProfileSchema } from '../schemas/models/personalization-profile.model.js';
+import type { RequestContext } from '../schemas/session.schema.js';
+export type AnyPersonalizationProfileSchema = z.ZodType<z.output<typeof PersonalizationProfileSchema>>;
+export interface PersonalizationProfileFactory<TPersonalizationProfileSchema extends AnyPersonalizationProfileSchema = AnyPersonalizationProfileSchema> {
+    personalizationProfileSchema: TPersonalizationProfileSchema;
+    parsePersonalizationProfile(context: RequestContext, data: unknown): z.output<TPersonalizationProfileSchema>;
+}
+export type PersonalizationProfileFactoryOutput<TFactory extends PersonalizationProfileFactory> = ReturnType<TFactory['parsePersonalizationProfile']>;
+export type PersonalizationProfileFactoryWithOutput<TFactory extends PersonalizationProfileFactory> = Omit<TFactory, 'parsePersonalizationProfile'> & {
+    parsePersonalizationProfile(context: RequestContext, data: unknown): PersonalizationProfileFactoryOutput<TFactory>;
+};

package/src/schemas/capabilities.schema.d.ts

@@ -19,6 +19,8 @@ export declare const CapabilitiesSchema: z.ZodObject<{
     category: z.ZodBoolean;
     store: z.ZodBoolean;
     profile: z.ZodBoolean;
+    featureFlag: z.ZodBoolean;
+    personalizationProfile: z.ZodBoolean;
 }, z.core.$loose>;
 export type Capabilities = InferType<typeof CapabilitiesSchema>;
 export type ClientFromCapabilities<C extends Partial<Capabilities>> = {

package/src/schemas/models/feature-flags.model.d.ts

@@ -0,0 +1,43 @@
+import type { InferType } from "../../zod-utils.js";
+import * as z from "zod";
+export declare const BaseFeatureFlagSchema: z.ZodObject<{
+    identifier: z.ZodObject<{
+        key: z.ZodString;
+    }, z.core.$loose>;
+}, z.core.$loose>;
+export declare const BooleanFeatureFlagSchema: z.ZodObject<{
+    identifier: z.ZodObject<{
+        key: z.ZodString;
+    }, z.core.$loose>;
+    type: z.ZodLiteral<"boolean">;
+    enabled: z.ZodBoolean;
+}, z.core.$loose>;
+export declare const MultivariateFeatureFlagSchema: z.ZodObject<{
+    identifier: z.ZodObject<{
+        key: z.ZodString;
+    }, z.core.$loose>;
+    type: z.ZodLiteral<"multivariate">;
+    variants: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        enabled: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$loose>;
+export declare const FeatureFlagSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    identifier: z.ZodObject<{
+        key: z.ZodString;
+    }, z.core.$loose>;
+    type: z.ZodLiteral<"boolean">;
+    enabled: z.ZodBoolean;
+}, z.core.$loose>, z.ZodObject<{
+    identifier: z.ZodObject<{
+        key: z.ZodString;
+    }, z.core.$loose>;
+    type: z.ZodLiteral<"multivariate">;
+    variants: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        enabled: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$loose>], "type">;
+export type BooleanFeatureFlag = InferType<typeof BooleanFeatureFlagSchema>;
+export type MultivariateFeatureFlag = InferType<typeof MultivariateFeatureFlagSchema>;
+export type FeatureFlag = InferType<typeof FeatureFlagSchema>;

package/src/schemas/models/identifiers.model.d.ts

@@ -349,6 +349,12 @@ export declare const CartSearchIdentifierSchema: z.ZodObject<{
         pageSize: z.ZodDefault<z.ZodNumber>;
     }, z.core.$loose>;
 }, z.core.$loose>;
+export declare const PersonalizationProfileIdentifierSchema: z.ZodObject<{
+    key: z.ZodString;
+}, z.core.$loose>;
+export declare const FeatureFlagIdentifierSchema: z.ZodObject<{
+    key: z.ZodString;
+}, z.core.$loose>;
 export type CartSearchIdentifier = InferType<typeof CartSearchIdentifierSchema>;
 export type OrderSearchIdentifier = InferType<typeof OrderSearchIdentifierSchema>;
 export type ProductIdentifier = InferType<typeof ProductIdentifierSchema>;
@@ -398,4 +404,6 @@ export type EmployeeSearchIdentifier = InferType<typeof EmployeeSearchIdentifier
 export type EmployeeInvitationIdentifier = InferType<typeof EmployeeInvitationIdentifierSchema>;
 export type EmployeeInvitationSearchIdentifier = InferType<typeof EmployeeInvitationSearchIdentifierSchema>;
 export type CompanySearchIdentifier = InferType<typeof CompanySearchIdentifierSchema>;
-export type IdentifierType = ProductIdentifier | ProductVariantIdentifier | SearchIdentifier | FacetIdentifier | FacetValueIdentifier | CartIdentifier | CartItemIdentifier | PriceIdentifier | CategoryIdentifier | WebStoreIdentifier | InventoryIdentifier | ProductRecommendationIdentifier | FulfillmentCenterIdentifier | IdentityIdentifier | ShippingMethodIdentifier | PaymentMethodIdentifier | AddressIdentifier | PaymentInstructionIdentifier | OrderIdentifier | OrderItemIdentifier | CompanyIdentifier | CompanyRegistrationRequestIdentifier | CheckoutIdentifier | CheckoutItemIdentifier | StoreIdentifier | ProductOptionIdentifier | ProductOptionValueIdentifier | PickupPointIdentifier | ProductAttributeIdentifier | ProductAttributeValueIdentifier | ProductRatingIdentifier | ProductReviewIdentifier | ProductAssociationsIdentifier | ProductListIdentifier | ProductListItemIdentifier | ProductListSearchIdentifier | PromotionIdentifier;
+export type PersonalizationProfileIdentifier = InferType<typeof PersonalizationProfileIdentifierSchema>;
+export type FeatureFlagIdentifier = InferType<typeof FeatureFlagIdentifierSchema>;
+export type IdentifierType = ProductIdentifier | ProductVariantIdentifier | SearchIdentifier | FacetIdentifier | FacetValueIdentifier | CartIdentifier | CartItemIdentifier | PriceIdentifier | CategoryIdentifier | WebStoreIdentifier | InventoryIdentifier | ProductRecommendationIdentifier | FulfillmentCenterIdentifier | IdentityIdentifier | ShippingMethodIdentifier | PaymentMethodIdentifier | AddressIdentifier | PaymentInstructionIdentifier | OrderIdentifier | OrderItemIdentifier | PersonalizationProfileIdentifier | CompanyIdentifier | CompanyRegistrationRequestIdentifier | CheckoutIdentifier | CheckoutItemIdentifier | StoreIdentifier | ProductOptionIdentifier | ProductOptionValueIdentifier | PickupPointIdentifier | ProductAttributeIdentifier | ProductAttributeValueIdentifier | ProductRatingIdentifier | ProductReviewIdentifier | ProductAssociationsIdentifier | ProductListIdentifier | ProductListItemIdentifier | ProductListSearchIdentifier | PromotionIdentifier | EmployeeIdentifier | EmployeeInvitationIdentifier | EmployeeSearchIdentifier | EmployeeInvitationSearchIdentifier | FeatureFlagIdentifier | CompanySearchIdentifier | OrderSearchIdentifier | CartSearchIdentifier | CompanyRegistrationRequestIdentifier | PersonalizationProfileIdentifier;

package/src/schemas/models/index.d.ts

@@ -26,3 +26,5 @@ export * from './company.model.js';
 export * from './company-registration.model.js';
 export * from './employee.model.js';
 export * from './employee-invitation.model.js';
+export * from './feature-flags.model.js';
+export * from './personalization-profile.model.js';

package/src/schemas/models/personalization-profile.model.d.ts

@@ -0,0 +1,10 @@
+import * as z from 'zod';
+import type { InferType } from '../../zod-utils.js';
+export declare const PersonalizationProfileSchema: z.ZodObject<{
+    identifier: z.ZodObject<{
+        key: z.ZodString;
+    }, z.core.$loose>;
+    segments: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    blurb: z.ZodDefault<z.ZodString>;
+}, z.core.$loose>;
+export type PersonalizationProfile = InferType<typeof PersonalizationProfileSchema>;

package/src/schemas/mutations/analytics/base-event.mutation.d.ts

@@ -0,0 +1,11 @@
+import type { InferType } from "../../../zod-utils.js";
+export declare const AnalyticsBaseMutationSchema: import("zod").ZodObject<{
+    personalizationProfile: import("zod").ZodOptional<import("zod").ZodObject<{
+        identifier: import("zod").ZodObject<{
+            key: import("zod").ZodString;
+        }, import("zod/v4/core").$loose>;
+        segments: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodString>>;
+        blurb: import("zod").ZodDefault<import("zod").ZodString>;
+    }, import("zod/v4/core").$loose>>;
+}, import("zod/v4/core").$loose>;
+export type AnalyticsBaseMutation = InferType<typeof AnalyticsBaseMutationSchema>;

package/src/schemas/mutations/analytics/index.d.ts

@@ -1,6 +1,13 @@
 import * as z from 'zod';
 import type { InferType } from '../../../zod-utils.js';
 export declare const AnalyticsMutationSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    personalizationProfile: z.ZodOptional<z.ZodObject<{
+        identifier: z.ZodObject<{
+            key: z.ZodString;
+        }, z.core.$loose>;
+        segments: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        blurb: z.ZodDefault<z.ZodString>;
+    }, z.core.$loose>>;
     event: z.ZodLiteral<"product-summary-view">;
     source: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
         type: z.ZodLiteral<"search">;
@@ -32,6 +39,13 @@ export declare const AnalyticsMutationSchema: z.ZodDiscriminatedUnion<[z.ZodObje
         key: z.ZodString;
     }, z.core.$loose>>;
 }, z.core.$loose>, z.ZodObject<{
+    personalizationProfile: z.ZodOptional<z.ZodObject<{
+        identifier: z.ZodObject<{
+            key: z.ZodString;
+        }, z.core.$loose>;
+        segments: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        blurb: z.ZodDefault<z.ZodString>;
+    }, z.core.$loose>>;
     event: z.ZodLiteral<"product-summary-click">;
     product: z.ZodObject<{
         key: z.ZodString;
@@ -64,11 +78,25 @@ export declare const AnalyticsMutationSchema: z.ZodDiscriminatedUnion<[z.ZodObje
     }, z.core.$strip>], "type">>;
     position: z.ZodNumber;
 }, z.core.$loose>, z.ZodObject<{
+    personalizationProfile: z.ZodOptional<z.ZodObject<{
+        identifier: z.ZodObject<{
+            key: z.ZodString;
+        }, z.core.$loose>;
+        segments: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        blurb: z.ZodDefault<z.ZodString>;
+    }, z.core.$loose>>;
     event: z.ZodLiteral<"product-details-view">;
     product: z.ZodObject<{
         key: z.ZodString;
     }, z.core.$loose>;
 }, z.core.$loose>, z.ZodObject<{
+    personalizationProfile: z.ZodOptional<z.ZodObject<{
+        identifier: z.ZodObject<{
+            key: z.ZodString;
+        }, z.core.$loose>;
+        segments: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        blurb: z.ZodDefault<z.ZodString>;
+    }, z.core.$loose>>;
     event: z.ZodLiteral<"product-cart-add">;
     source: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
         type: z.ZodLiteral<"search">;
@@ -100,6 +128,13 @@ export declare const AnalyticsMutationSchema: z.ZodDiscriminatedUnion<[z.ZodObje
         key: z.ZodString;
     }, z.core.$loose>;
 }, z.core.$loose>, z.ZodObject<{
+    personalizationProfile: z.ZodOptional<z.ZodObject<{
+        identifier: z.ZodObject<{
+            key: z.ZodString;
+        }, z.core.$loose>;
+        segments: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        blurb: z.ZodDefault<z.ZodString>;
+    }, z.core.$loose>>;
     event: z.ZodLiteral<"purchase">;
     order: z.ZodObject<{
         identifier: z.ZodObject<{
@@ -2451,3 +2486,4 @@ export * from './product-details-view.mutation.js';
 export * from './product-summary-click.mutation.js';
 export * from './product-summary-view.mutation.js';
 export * from './purchase.mutation.js';
+export * from './base-event.mutation.js';

package/src/schemas/mutations/analytics/product-add-to-cart.mutation.d.ts

@@ -1,6 +1,13 @@
 import * as z from 'zod';
 import type { InferType } from '../../../zod-utils.js';
 export declare const AnalyticsMutationProductAddToCartEventSchema: z.ZodObject<{
+    personalizationProfile: z.ZodOptional<z.ZodObject<{
+        identifier: z.ZodObject<{
+            key: z.ZodString;
+        }, z.core.$loose>;
+        segments: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        blurb: z.ZodDefault<z.ZodString>;
+    }, z.core.$loose>>;
     event: z.ZodLiteral<"product-cart-add">;
     source: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
         type: z.ZodLiteral<"search">;

package/src/schemas/mutations/analytics/product-details-view.mutation.d.ts

@@ -1,6 +1,13 @@
 import * as z from 'zod';
 import type { InferType } from '../../../zod-utils.js';
 export declare const AnalyticsMutationProductDetailsViewEventSchema: z.ZodObject<{
+    personalizationProfile: z.ZodOptional<z.ZodObject<{
+        identifier: z.ZodObject<{
+            key: z.ZodString;
+        }, z.core.$loose>;
+        segments: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        blurb: z.ZodDefault<z.ZodString>;
+    }, z.core.$loose>>;
     event: z.ZodLiteral<"product-details-view">;
     product: z.ZodObject<{
         key: z.ZodString;

package/src/schemas/mutations/analytics/product-summary-click.mutation.d.ts

@@ -1,6 +1,13 @@
 import type { InferType } from '../../../zod-utils.js';
 import * as z from 'zod';
 export declare const AnalyticsMutationProductSummaryClickEventSchema: z.ZodObject<{
+    personalizationProfile: z.ZodOptional<z.ZodObject<{
+        identifier: z.ZodObject<{
+            key: z.ZodString;
+        }, z.core.$loose>;
+        segments: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        blurb: z.ZodDefault<z.ZodString>;
+    }, z.core.$loose>>;
     event: z.ZodLiteral<"product-summary-click">;
     product: z.ZodObject<{
         key: z.ZodString;

package/src/schemas/mutations/analytics/product-summary-view.mutation.d.ts

@@ -1,6 +1,13 @@
 import type { InferType } from '../../../zod-utils.js';
 import * as z from 'zod';
 export declare const AnalyticsMutationProductSummaryViewEventSchema: z.ZodObject<{
+    personalizationProfile: z.ZodOptional<z.ZodObject<{
+        identifier: z.ZodObject<{
+            key: z.ZodString;
+        }, z.core.$loose>;
+        segments: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        blurb: z.ZodDefault<z.ZodString>;
+    }, z.core.$loose>>;
     event: z.ZodLiteral<"product-summary-view">;
     source: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
         type: z.ZodLiteral<"search">;

package/src/schemas/mutations/analytics/purchase.mutation.d.ts

@@ -1,6 +1,13 @@
 import * as z from 'zod';
 import type { InferType } from '../../../zod-utils.js';
 export declare const AnalyticsMutationPurchaseEventSchema: z.ZodObject<{
+    personalizationProfile: z.ZodOptional<z.ZodObject<{
+        identifier: z.ZodObject<{
+            key: z.ZodString;
+        }, z.core.$loose>;
+        segments: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        blurb: z.ZodDefault<z.ZodString>;
+    }, z.core.$loose>>;
     event: z.ZodLiteral<"purchase">;
     order: z.ZodObject<{
         identifier: z.ZodObject<{

package/src/schemas/queries/feature-flag.query.d.ts

@@ -0,0 +1,15 @@
+import * as z from 'zod';
+import type { InferType } from "../../zod-utils.js";
+export declare const FeatureFlagQueryGetFlagsSchema: z.ZodObject<{
+    featureFlagIdentifiers: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+    }, z.core.$loose>>;
+    personalizationProfile: z.ZodOptional<z.ZodObject<{
+        identifier: z.ZodObject<{
+            key: z.ZodString;
+        }, z.core.$loose>;
+        segments: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        blurb: z.ZodDefault<z.ZodString>;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
+export type FeatureFlagQueryGetFlags = InferType<typeof FeatureFlagQueryGetFlagsSchema>;

package/src/schemas/queries/index.d.ts

@@ -20,3 +20,5 @@ export * from './company-registration.query.js';
 export * from './employee.query.js';
 export * from './employee-invitation.query.js';
 export * from './company.query.js';
+export * from './feature-flag.query.js';
+export * from './personalization-profile.query.js';

package/src/schemas/queries/personalization-profile.query.d.ts

@@ -0,0 +1,67 @@
+import type { InferType } from "../../zod-utils.js";
+export declare const PersonalizationProfileQueryGetProfileSchema: import("zod").ZodObject<{
+    identity: import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
+        type: import("zod").ZodLiteral<"Anonymous">;
+    }, import("zod/v4/core").$loose>, import("zod").ZodObject<{
+        id: import("zod").ZodObject<{
+            userId: import("zod").ZodString;
+        }, import("zod/v4/core").$loose>;
+        type: import("zod").ZodLiteral<"Guest">;
+    }, import("zod/v4/core").$loose>, import("zod").ZodObject<{
+        id: import("zod").ZodObject<{
+            userId: import("zod").ZodString;
+        }, import("zod/v4/core").$loose>;
+        type: import("zod").ZodLiteral<"Registered">;
+    }, import("zod/v4/core").$loose>], "type">;
+    profile: import("zod").ZodOptional<import("zod").ZodObject<{
+        identifier: import("zod").ZodObject<{
+            userId: import("zod").ZodString;
+        }, import("zod/v4/core").$loose>;
+        email: import("zod").ZodEmail;
+        phone: import("zod").ZodString;
+        emailVerified: import("zod").ZodBoolean;
+        phoneVerified: import("zod").ZodBoolean;
+        createdAt: import("zod").ZodString;
+        updatedAt: import("zod").ZodString;
+        shippingAddress: import("zod").ZodOptional<import("zod").ZodObject<{
+            identifier: import("zod").ZodDefault<import("zod").ZodObject<{
+                nickName: import("zod").ZodString;
+            }, import("zod/v4/core").$loose>>;
+            firstName: import("zod").ZodString;
+            lastName: import("zod").ZodString;
+            streetAddress: import("zod").ZodString;
+            streetNumber: import("zod").ZodString;
+            city: import("zod").ZodString;
+            region: import("zod").ZodString;
+            postalCode: import("zod").ZodString;
+            countryCode: import("zod").ZodString;
+        }, import("zod/v4/core").$loose>>;
+        billingAddress: import("zod").ZodOptional<import("zod").ZodObject<{
+            identifier: import("zod").ZodDefault<import("zod").ZodObject<{
+                nickName: import("zod").ZodString;
+            }, import("zod/v4/core").$loose>>;
+            firstName: import("zod").ZodString;
+            lastName: import("zod").ZodString;
+            streetAddress: import("zod").ZodString;
+            streetNumber: import("zod").ZodString;
+            city: import("zod").ZodString;
+            region: import("zod").ZodString;
+            postalCode: import("zod").ZodString;
+            countryCode: import("zod").ZodString;
+        }, import("zod/v4/core").$loose>>;
+        alternateShippingAddresses: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodObject<{
+            identifier: import("zod").ZodDefault<import("zod").ZodObject<{
+                nickName: import("zod").ZodString;
+            }, import("zod/v4/core").$loose>>;
+            firstName: import("zod").ZodString;
+            lastName: import("zod").ZodString;
+            streetAddress: import("zod").ZodString;
+            streetNumber: import("zod").ZodString;
+            city: import("zod").ZodString;
+            region: import("zod").ZodString;
+            postalCode: import("zod").ZodString;
+            countryCode: import("zod").ZodString;
+        }, import("zod/v4/core").$loose>>>;
+    }, import("zod/v4/core").$loose>>;
+}, import("zod/v4/core").$loose>;
+export type PersonalizationProfileQueryGetProfile = InferType<typeof PersonalizationProfileQueryGetProfileSchema>;

package/src/schemas/queries/product-recommendations.query.d.ts

@@ -2,10 +2,24 @@ import * as z from "zod";
 import type { InferType } from "../../zod-utils.js";
 export declare const ProductRecommendationBaseQuerySchema: z.ZodObject<{
     numberOfRecommendations: z.ZodNumber;
+    personalizationProfile: z.ZodOptional<z.ZodObject<{
+        identifier: z.ZodObject<{
+            key: z.ZodString;
+        }, z.core.$loose>;
+        segments: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        blurb: z.ZodDefault<z.ZodString>;
+    }, z.core.$loose>>;
     labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$loose>;
 export declare const ProductRecommendationsByCollectionQuerySchema: z.ZodObject<{
     numberOfRecommendations: z.ZodNumber;
+    personalizationProfile: z.ZodOptional<z.ZodObject<{
+        identifier: z.ZodObject<{
+            key: z.ZodString;
+        }, z.core.$loose>;
+        segments: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        blurb: z.ZodDefault<z.ZodString>;
+    }, z.core.$loose>>;
     labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
     collectionName: z.ZodString;
     sourceProduct: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -17,6 +31,13 @@ export declare const ProductRecommendationsByCollectionQuerySchema: z.ZodObject<
 }, z.core.$loose>;
 export declare const ProductRecommendationProductBasedBaseQuerySchema: z.ZodObject<{
     numberOfRecommendations: z.ZodNumber;
+    personalizationProfile: z.ZodOptional<z.ZodObject<{
+        identifier: z.ZodObject<{
+            key: z.ZodString;
+        }, z.core.$loose>;
+        segments: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        blurb: z.ZodDefault<z.ZodString>;
+    }, z.core.$loose>>;
     labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
     sourceProduct: z.ZodObject<{
         key: z.ZodString;
@@ -24,6 +45,13 @@ export declare const ProductRecommendationProductBasedBaseQuerySchema: z.ZodObje
 }, z.core.$loose>;
 export declare const ProductRecommendationAlgorithmFrequentlyBoughtTogetherQuerySchema: z.ZodObject<{
     numberOfRecommendations: z.ZodNumber;
+    personalizationProfile: z.ZodOptional<z.ZodObject<{
+        identifier: z.ZodObject<{
+            key: z.ZodString;
+        }, z.core.$loose>;
+        segments: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        blurb: z.ZodDefault<z.ZodString>;
+    }, z.core.$loose>>;
     labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
     sourceProduct: z.ZodObject<{
         key: z.ZodString;
@@ -32,6 +60,13 @@ export declare const ProductRecommendationAlgorithmFrequentlyBoughtTogetherQuery
 }, z.core.$loose>;
 export declare const ProductRecommendationAlgorithmSimilarProductsQuerySchema: z.ZodObject<{
     numberOfRecommendations: z.ZodNumber;
+    personalizationProfile: z.ZodOptional<z.ZodObject<{
+        identifier: z.ZodObject<{
+            key: z.ZodString;
+        }, z.core.$loose>;
+        segments: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        blurb: z.ZodDefault<z.ZodString>;
+    }, z.core.$loose>>;
     labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
     sourceProduct: z.ZodObject<{
         key: z.ZodString;
@@ -40,6 +75,13 @@ export declare const ProductRecommendationAlgorithmSimilarProductsQuerySchema: z
 }, z.core.$loose>;
 export declare const ProductRecommendationAlgorithmRelatedProductsQuerySchema: z.ZodObject<{
     numberOfRecommendations: z.ZodNumber;
+    personalizationProfile: z.ZodOptional<z.ZodObject<{
+        identifier: z.ZodObject<{
+            key: z.ZodString;
+        }, z.core.$loose>;
+        segments: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        blurb: z.ZodDefault<z.ZodString>;
+    }, z.core.$loose>>;
     labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
     sourceProduct: z.ZodObject<{
         key: z.ZodString;
@@ -48,6 +90,13 @@ export declare const ProductRecommendationAlgorithmRelatedProductsQuerySchema: z
 }, z.core.$loose>;
 export declare const ProductRecommendationAlgorithmTrendingInCategoryQuerySchema: z.ZodObject<{
     numberOfRecommendations: z.ZodNumber;
+    personalizationProfile: z.ZodOptional<z.ZodObject<{
+        identifier: z.ZodObject<{
+            key: z.ZodString;
+        }, z.core.$loose>;
+        segments: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        blurb: z.ZodDefault<z.ZodString>;
+    }, z.core.$loose>>;
     labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
     algorithm: z.ZodLiteral<"trendingInCategory">;
     sourceCategory: z.ZodObject<{
@@ -56,16 +105,37 @@ export declare const ProductRecommendationAlgorithmTrendingInCategoryQuerySchema
 }, z.core.$loose>;
 export declare const ProductRecommendationAlgorithmPopuplarProductsQuerySchema: z.ZodObject<{
     numberOfRecommendations: z.ZodNumber;
+    personalizationProfile: z.ZodOptional<z.ZodObject<{
+        identifier: z.ZodObject<{
+            key: z.ZodString;
+        }, z.core.$loose>;
+        segments: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        blurb: z.ZodDefault<z.ZodString>;
+    }, z.core.$loose>>;
     labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
     algorithm: z.ZodLiteral<"popular">;
 }, z.core.$loose>;
 export declare const ProductRecommendationAlgorithmTopPicksProductsQuerySchema: z.ZodObject<{
     numberOfRecommendations: z.ZodNumber;
+    personalizationProfile: z.ZodOptional<z.ZodObject<{
+        identifier: z.ZodObject<{
+            key: z.ZodString;
+        }, z.core.$loose>;
+        segments: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        blurb: z.ZodDefault<z.ZodString>;
+    }, z.core.$loose>>;
     labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
     algorithm: z.ZodLiteral<"topPicks">;
 }, z.core.$loose>;
 export declare const ProductRecommendationAlgorithmAlsoViewedProductsQuerySchema: z.ZodObject<{
     numberOfRecommendations: z.ZodNumber;
+    personalizationProfile: z.ZodOptional<z.ZodObject<{
+        identifier: z.ZodObject<{
+            key: z.ZodString;
+        }, z.core.$loose>;
+        segments: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        blurb: z.ZodDefault<z.ZodString>;
+    }, z.core.$loose>>;
     labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
     sourceProduct: z.ZodObject<{
         key: z.ZodString;
@@ -74,6 +144,13 @@ export declare const ProductRecommendationAlgorithmAlsoViewedProductsQuerySchema
 }, z.core.$loose>;
 export declare const ProductRecommendationsQuerySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     numberOfRecommendations: z.ZodNumber;
+    personalizationProfile: z.ZodOptional<z.ZodObject<{
+        identifier: z.ZodObject<{
+            key: z.ZodString;
+        }, z.core.$loose>;
+        segments: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        blurb: z.ZodDefault<z.ZodString>;
+    }, z.core.$loose>>;
     labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
     sourceProduct: z.ZodObject<{
         key: z.ZodString;
@@ -81,6 +158,13 @@ export declare const ProductRecommendationsQuerySchema: z.ZodDiscriminatedUnion<
     algorithm: z.ZodLiteral<"frequentlyBoughtTogether">;
 }, z.core.$loose>, z.ZodObject<{
     numberOfRecommendations: z.ZodNumber;
+    personalizationProfile: z.ZodOptional<z.ZodObject<{
+        identifier: z.ZodObject<{
+            key: z.ZodString;
+        }, z.core.$loose>;
+        segments: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        blurb: z.ZodDefault<z.ZodString>;
+    }, z.core.$loose>>;
     labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
     algorithm: z.ZodLiteral<"trendingInCategory">;
     sourceCategory: z.ZodObject<{
@@ -88,6 +172,13 @@ export declare const ProductRecommendationsQuerySchema: z.ZodDiscriminatedUnion<
     }, z.core.$loose>;
 }, z.core.$loose>, z.ZodObject<{
     numberOfRecommendations: z.ZodNumber;
+    personalizationProfile: z.ZodOptional<z.ZodObject<{
+        identifier: z.ZodObject<{
+            key: z.ZodString;
+        }, z.core.$loose>;
+        segments: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        blurb: z.ZodDefault<z.ZodString>;
+    }, z.core.$loose>>;
     labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
     sourceProduct: z.ZodObject<{
         key: z.ZodString;
@@ -95,6 +186,13 @@ export declare const ProductRecommendationsQuerySchema: z.ZodDiscriminatedUnion<
     algorithm: z.ZodLiteral<"similar">;
 }, z.core.$loose>, z.ZodObject<{
     numberOfRecommendations: z.ZodNumber;
+    personalizationProfile: z.ZodOptional<z.ZodObject<{
+        identifier: z.ZodObject<{
+            key: z.ZodString;
+        }, z.core.$loose>;
+        segments: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        blurb: z.ZodDefault<z.ZodString>;
+    }, z.core.$loose>>;
     labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
     sourceProduct: z.ZodObject<{
         key: z.ZodString;
@@ -102,14 +200,35 @@ export declare const ProductRecommendationsQuerySchema: z.ZodDiscriminatedUnion<
     algorithm: z.ZodLiteral<"related">;
 }, z.core.$loose>, z.ZodObject<{
     numberOfRecommendations: z.ZodNumber;
+    personalizationProfile: z.ZodOptional<z.ZodObject<{
+        identifier: z.ZodObject<{
+            key: z.ZodString;
+        }, z.core.$loose>;
+        segments: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        blurb: z.ZodDefault<z.ZodString>;
+    }, z.core.$loose>>;
     labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
     algorithm: z.ZodLiteral<"popular">;
 }, z.core.$loose>, z.ZodObject<{
     numberOfRecommendations: z.ZodNumber;
+    personalizationProfile: z.ZodOptional<z.ZodObject<{
+        identifier: z.ZodObject<{
+            key: z.ZodString;
+        }, z.core.$loose>;
+        segments: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        blurb: z.ZodDefault<z.ZodString>;
+    }, z.core.$loose>>;
     labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
     algorithm: z.ZodLiteral<"topPicks">;
 }, z.core.$loose>, z.ZodObject<{
     numberOfRecommendations: z.ZodNumber;
+    personalizationProfile: z.ZodOptional<z.ZodObject<{
+        identifier: z.ZodObject<{
+            key: z.ZodString;
+        }, z.core.$loose>;
+        segments: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        blurb: z.ZodDefault<z.ZodString>;
+    }, z.core.$loose>>;
     labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
     sourceProduct: z.ZodObject<{
         key: z.ZodString;
@@ -125,3 +244,4 @@ export type ProductRecommendationAlgorithmRelatedProductsQuery = InferType<typeo
 export type ProductRecommendationAlgorithmSimilarProductsQuery = InferType<typeof ProductRecommendationAlgorithmSimilarProductsQuerySchema>;
 export type ProductRecommendationAlgorithmFrequentlyBoughtTogetherQuery = InferType<typeof ProductRecommendationAlgorithmFrequentlyBoughtTogetherQuerySchema>;
 export type ProductRecommendationAlgorithmAlsoViewedProductsQuery = InferType<typeof ProductRecommendationAlgorithmAlsoViewedProductsQuerySchema>;
+export type ProductRecommendationBaseQuery = InferType<typeof ProductRecommendationBaseQuerySchema>;

package/src/schemas/queries/product-search.query.d.ts

@@ -24,6 +24,13 @@ export declare const ProductSearchQueryByTermSchema: z.ZodObject<{
             taxIdentifier: z.ZodString;
         }, z.core.$loose>>;
     }, z.core.$loose>;
+    personalizationProfile: z.ZodOptional<z.ZodObject<{
+        identifier: z.ZodObject<{
+            key: z.ZodString;
+        }, z.core.$loose>;
+        segments: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        blurb: z.ZodDefault<z.ZodString>;
+    }, z.core.$loose>>;
 }, z.core.$loose>;
 export declare const ProductSearchQueryCreateNavigationFilterSchema: z.ZodObject<{
     categoryPath: z.ZodArray<z.ZodObject<{

package/src/schemas/session.schema.d.ts

@@ -202,7 +202,6 @@ export declare const IdentityContextSchema: z.ZodObject<{
         }, z.core.$loose>;
         type: z.ZodLiteral<"Registered">;
     }, z.core.$loose>], "type">;
-    personalizationKey: z.ZodString;
     lastUpdated: z.ZodCoercedDate<unknown>;
 }, z.core.$loose>;
 export declare const SessionSchema: z.ZodObject<{
@@ -220,9 +219,15 @@ export declare const SessionSchema: z.ZodObject<{
             }, z.core.$loose>;
             type: z.ZodLiteral<"Registered">;
         }, z.core.$loose>], "type">;
-        personalizationKey: z.ZodString;
         lastUpdated: z.ZodCoercedDate<unknown>;
     }, z.core.$loose>;
+    marketingContext: z.ZodDefault<z.ZodObject<{
+        identifier: z.ZodObject<{
+            key: z.ZodString;
+        }, z.core.$loose>;
+        segments: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        blurb: z.ZodDefault<z.ZodString>;
+    }, z.core.$loose>>;
 }, z.core.$loose>;
 export declare const TaxJurisdictionSchema: z.ZodObject<{
     countryCode: z.ZodDefault<z.ZodString>;
@@ -246,9 +251,15 @@ export declare const RequestContextSchema: z.ZodObject<{
                 }, z.core.$loose>;
                 type: z.ZodLiteral<"Registered">;
             }, z.core.$loose>], "type">;
-            personalizationKey: z.ZodString;
             lastUpdated: z.ZodCoercedDate<unknown>;
         }, z.core.$loose>;
+        marketingContext: z.ZodDefault<z.ZodObject<{
+            identifier: z.ZodObject<{
+                key: z.ZodString;
+            }, z.core.$loose>;
+            segments: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            blurb: z.ZodDefault<z.ZodString>;
+        }, z.core.$loose>>;
     }, z.core.$loose>>;
     languageContext: z.ZodDefault<z.ZodObject<{
         locale: z.ZodDefault<z.ZodString>;
@@ -445,7 +456,6 @@ export declare const RequestContextSchema: z.ZodObject<{
         countyCode: z.ZodDefault<z.ZodString>;
         cityCode: z.ZodDefault<z.ZodString>;
     }, z.core.$strip>>;
-    companyIdentifier: z.ZodOptional<z.ZodString>;
     correlationId: z.ZodDefault<z.ZodString>;
     isBot: z.ZodDefault<z.ZodBoolean>;
     clientIp: z.ZodDefault<z.ZodString>;