@reactionary/core 0.6.1 → 0.6.3

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "@reactionary/core",
-  "version": "0.6.1",
-  "main": "index.js",
-  "types": "src/index.d.ts",
+  "version": "0.6.3",
+  "type": "module",
+  "main": "./index.js",
+  "types": "./src/index.d.ts",
   "dependencies": {
     "zod": "4.1.9",
     "@upstash/redis": "^1.34.9",
-    "node-object-hash": "^3.1.1"
-  },
-  "peerDependencies": {
-    "@opentelemetry/api": "^1.0.0"
+    "@opentelemetry/api": "^1.9.0",
+    "node-object-hash": "^3.1.1",
+    "vitest": "^4.0.9",
+    "@nx/vite": "22.4.5"
   },
-  "type": "module",
   "sideEffects": false
 }

package/src/{providers/analytics.provider.d.ts → capabilities/analytics.capability.d.ts}

@@ -1,8 +1,8 @@
 import type { RequestContext } from '../schemas/session.schema.js';
-import { BaseProvider } from './base.provider.js';
+import { BaseCapability } from './base.capability.js';
 import type { Cache } from '../cache/cache.interface.js';
 import { type AnalyticsMutation, type AnalyticsMutationProductAddToCartEvent, type AnalyticsMutationProductDetailsViewEvent, type AnalyticsMutationProductSummaryClickEvent, type AnalyticsMutationProductSummaryViewEvent, type AnalyticsMutationPurchaseEvent } from '../schemas/index.js';
-export declare abstract class AnalyticsProvider extends BaseProvider {
+export declare abstract class AnalyticsCapability extends BaseCapability {
     protected getResourceName(): string;
     track(event: AnalyticsMutation): Promise<void>;
     protected processProductSummaryView(event: AnalyticsMutationProductSummaryViewEvent): Promise<void>;
@@ -11,8 +11,8 @@ export declare abstract class AnalyticsProvider extends BaseProvider {
     protected processProductAddToCart(event: AnalyticsMutationProductAddToCartEvent): Promise<void>;
     protected processPurchase(event: AnalyticsMutationPurchaseEvent): Promise<void>;
 }
-export declare class MulticastAnalyticsProvider extends AnalyticsProvider {
-    protected providers: Array<AnalyticsProvider>;
-    constructor(cache: Cache, requestContext: RequestContext, providers: Array<AnalyticsProvider>);
+export declare class MulticastAnalyticsCapability extends AnalyticsCapability {
+    protected capabilities: Array<AnalyticsCapability>;
+    constructor(cache: Cache, requestContext: RequestContext, capabilities: Array<AnalyticsCapability>);
     track(event: AnalyticsMutation): Promise<void>;
 }

package/src/{providers/base.provider.d.ts → capabilities/base.capability.d.ts}

@@ -1,10 +1,10 @@
 import type { Cache } from '../cache/cache.interface.js';
 import { type RequestContext } from '../schemas/session.schema.js';
 /**
- * Base capability provider, responsible for mutations (changes) and queries (fetches)
+ * Base capability abstraction, responsible for mutations (changes) and queries (fetches)
  * for a given business object domain.
  */
-export declare abstract class BaseProvider {
+export declare abstract class BaseCapability {
     protected cache: Cache;
     protected context: RequestContext;
     constructor(cache: Cache, context: RequestContext);

package/src/{providers/cart.provider.d.ts → capabilities/cart.capability.d.ts}

@@ -4,11 +4,11 @@ import type { CartIdentifier } from "../schemas/models/identifiers.model.js";
 import type { CartMutationApplyCoupon, CartMutationChangeCurrency, CartMutationDeleteCart, CartMutationItemAdd, CartMutationItemQuantityChange, CartMutationItemRemove, CartMutationRemoveCoupon } from "../schemas/mutations/cart.mutation.js";
 import type { CartQueryById } from "../schemas/queries/cart.query.js";
 import type { Result } from "../schemas/result.js";
-import { BaseProvider } from "./base.provider.js";
+import { BaseCapability } from "./base.capability.js";
 /**
  * @group Providers
  */
-export declare abstract class CartProvider extends BaseProvider {
+export declare abstract class CartCapability<TCart extends Cart = Cart, TCartIdentifier extends CartIdentifier = CartIdentifier> extends BaseCapability {
     /**
      * Get cart by ID.
      *
@@ -16,14 +16,14 @@ export declare abstract class CartProvider extends BaseProvider {
      * @param payload
      * @param session
      */
-    abstract getById(payload: CartQueryById): Promise<Result<Cart, NotFoundError>>;
+    abstract getById(payload: CartQueryById): Promise<Result<TCart, NotFoundError>>;
     /**
      * Get the active cart id for the user.
      *
      * Usecase: Most common usecase during site load, or after login. You want to get the active cart for the user, so you can display it in the minicart.
      * @param session
      */
-    abstract getActiveCartId(): Promise<Result<CartIdentifier, NotFoundError>>;
+    abstract getActiveCartId(): Promise<Result<TCartIdentifier, NotFoundError>>;
     /**
      * Add item to cart. If no cart exists, create a new one. Returns the updated and recalculated cart.
      * Does not automatically consolidate items, so if you want to have second add of same item to increase quantity,
@@ -33,7 +33,7 @@ export declare abstract class CartProvider extends BaseProvider {
      * @param payload
      * @param session
      */
-    abstract add(payload: CartMutationItemAdd): Promise<Result<Cart>>;
+    abstract add(payload: CartMutationItemAdd): Promise<Result<TCart>>;
     /**
      * Remove item from cart. If the cart is empty after removal, delete the cart. Returns the updated and recalculated cart.
      *
@@ -41,7 +41,7 @@ export declare abstract class CartProvider extends BaseProvider {
      * @param payload
      * @param session
      */
-    abstract remove(payload: CartMutationItemRemove): Promise<Result<Cart>>;
+    abstract remove(payload: CartMutationItemRemove): Promise<Result<TCart>>;
     /**
      * Change quantity of item in cart. If the cart is empty after change, delete the cart. Returns the updated and recalculated cart.
      * Changing quantity to 0 is not allowed. Use the remove call instead. This is done to avoid accidental removal of item.
@@ -51,7 +51,7 @@ export declare abstract class CartProvider extends BaseProvider {
      * @param payload
      * @param session
      */
-    abstract changeQuantity(payload: CartMutationItemQuantityChange): Promise<Result<Cart>>;
+    abstract changeQuantity(payload: CartMutationItemQuantityChange): Promise<Result<TCart>>;
     /**
      * Deletes the entire cart.
      *
@@ -67,7 +67,7 @@ export declare abstract class CartProvider extends BaseProvider {
      * @param payload
      * @param session
      */
-    abstract applyCouponCode(payload: CartMutationApplyCoupon): Promise<Result<Cart>>;
+    abstract applyCouponCode(payload: CartMutationApplyCoupon): Promise<Result<TCart>>;
     /**
      * Removes a coupon code from the cart. Returns the updated and recalculated cart.
      *
@@ -75,7 +75,7 @@ export declare abstract class CartProvider extends BaseProvider {
      * @param payload
      * @param session
      */
-    abstract removeCouponCode(payload: CartMutationRemoveCoupon): Promise<Result<Cart>>;
+    abstract removeCouponCode(payload: CartMutationRemoveCoupon): Promise<Result<TCart>>;
     /**
      * Changes the currency of the cart.
      *
@@ -83,6 +83,6 @@ export declare abstract class CartProvider extends BaseProvider {
      * @param newCurrency
      * @param session
      */
-    abstract changeCurrency(payload: CartMutationChangeCurrency): Promise<Result<Cart>>;
+    abstract changeCurrency(payload: CartMutationChangeCurrency): Promise<Result<TCart>>;
     protected getResourceName(): string;
 }

package/src/{providers/category.provider.d.ts → capabilities/category.capability.d.ts}

@@ -1,16 +1,16 @@
 import type { Category, CategoryPaginatedResult, NotFoundError, Result } from "../schemas/index.js";
 import type { CategoryQueryById, CategoryQueryBySlug, CategoryQueryForBreadcrumb, CategoryQueryForChildCategories, CategoryQueryForTopCategories } from "../schemas/queries/category.query.js";
-import { BaseProvider } from "./base.provider.js";
+import { BaseCapability } from "./base.capability.js";
 /**
- * CategoryProvider
+ * CategoryCapability
  *
- * This provider allows fetching of single or sets of categories.
+ * This capability allows fetching of single or sets of categories.
  *
  * We only allow fetching one hierachy level at a time, for now. This is to avoid development patterns of "fetch 5000 categories in one go.."
  *
  * @group Foo
  */
-export declare abstract class CategoryProvider extends BaseProvider {
+export declare abstract class CategoryCapability<TCategory extends Category = Category, TCategoryPaginatedResult extends CategoryPaginatedResult = CategoryPaginatedResult> extends BaseCapability {
     /**
      * Get a single category by its ID. Cannot return null, because HOW did you come across a categories ID that does not exist?
      *
@@ -26,7 +26,7 @@ export declare abstract class CategoryProvider extends BaseProvider {
      * @param id
      * @param session
      */
-    abstract getById(payload: CategoryQueryById): Promise<Result<Category, NotFoundError>>;
+    abstract getById(payload: CategoryQueryById): Promise<Result<TCategory, NotFoundError>>;
     /**
      * Gets a single category by its seo slug
      *
@@ -34,7 +34,7 @@ export declare abstract class CategoryProvider extends BaseProvider {
      * @param slug the slug
      * @param session
      */
-    abstract getBySlug(payload: CategoryQueryBySlug): Promise<Result<Category, NotFoundError>>;
+    abstract getBySlug(payload: CategoryQueryBySlug): Promise<Result<TCategory, NotFoundError>>;
     /**
      * Gets the breadcrumb path to the category, i.e. all parents up to the root.
      * The returned order is from root to leaf.
@@ -43,7 +43,7 @@ export declare abstract class CategoryProvider extends BaseProvider {
      * @param id
      * @param session
      */
-    abstract getBreadcrumbPathToCategory(payload: CategoryQueryForBreadcrumb): Promise<Result<Category[]>>;
+    abstract getBreadcrumbPathToCategory(payload: CategoryQueryForBreadcrumb): Promise<Result<TCategory[]>>;
     /**
      * Finds all child categories of a given category.
      *
@@ -54,7 +54,7 @@ export declare abstract class CategoryProvider extends BaseProvider {
      * @param id The ID of the parent category.
      * @param session The session information.
      */
-    abstract findChildCategories(payload: CategoryQueryForChildCategories): Promise<Result<CategoryPaginatedResult>>;
+    abstract findChildCategories(payload: CategoryQueryForChildCategories): Promise<Result<TCategoryPaginatedResult>>;
     /**
      * Returns all top categories, i.e. categories without a parent.
      *
@@ -62,6 +62,6 @@ export declare abstract class CategoryProvider extends BaseProvider {
      * @param paginationOptions
      * @param session
      */
-    abstract findTopCategories(payload: CategoryQueryForTopCategories): Promise<Result<CategoryPaginatedResult>>;
+    abstract findTopCategories(payload: CategoryQueryForTopCategories): Promise<Result<TCategoryPaginatedResult>>;
     protected getResourceName(): string;
 }

package/src/{providers/checkout.provider.d.ts → capabilities/checkout.capability.d.ts}

@@ -1,10 +1,10 @@
 import type { Checkout, PaymentMethod, ShippingMethod } from "../schemas/models/index.js";
-import { BaseProvider } from "./base.provider.js";
+import { BaseCapability } from "./base.capability.js";
 import type { CheckoutMutationFinalizeCheckout, CheckoutMutationInitiateCheckout, CheckoutMutationSetShippingAddress, CheckoutMutationAddPaymentInstruction, CheckoutMutationRemovePaymentInstruction, CheckoutMutationSetShippingInstruction } from "../schemas/mutations/checkout.mutation.js";
 import type { CheckoutQueryById, CheckoutQueryForAvailablePaymentMethods, CheckoutQueryForAvailableShippingMethods } from "../schemas/queries/index.js";
 import type { Result } from "../schemas/result.js";
 import type { NotFoundError } from "../schemas/index.js";
-export declare abstract class CheckoutProvider extends BaseProvider {
+export declare abstract class CheckoutCapability<TCheckout extends Checkout = Checkout, TShippingMethod extends ShippingMethod = ShippingMethod, TPaymentMethod extends PaymentMethod = PaymentMethod> extends BaseCapability {
     /**
      * This starts a new checkout session for the given cart. The checkout might duplicate the cart, or just reference it, depending on implementation, but changes to the cart,
      * is not reflected in the checkout, and vice versa. The checkout is a snapshot of the cart at the time of initiation.
@@ -15,7 +15,7 @@ export declare abstract class CheckoutProvider extends BaseProvider {
      * @param billingAddress the billing/shipping address to start with. This affects available shipping methods, and may be required by some payment providers.
      * @param reqCtx
      */
-    abstract initiateCheckoutForCart(payload: CheckoutMutationInitiateCheckout): Promise<Result<Checkout>>;
+    abstract initiateCheckoutForCart(payload: CheckoutMutationInitiateCheckout): Promise<Result<TCheckout>>;
     /**
      * Fetches an existing checkout by its identifier.
      *
@@ -23,7 +23,7 @@ export declare abstract class CheckoutProvider extends BaseProvider {
      * @param payload
      * @param reqCtx
      */
-    abstract getById(payload: CheckoutQueryById): Promise<Result<Checkout, NotFoundError>>;
+    abstract getById(payload: CheckoutQueryById): Promise<Result<TCheckout, NotFoundError>>;
     /**
      * Updates the shipping address for the checkout and recalculates the shipping methods and totals.
      *
@@ -32,7 +32,7 @@ export declare abstract class CheckoutProvider extends BaseProvider {
      * NOTE: Unsure this is really needed.
      * @param shippingAddress The updated shipping address. Note: This may also be the billing address, if your store does not differentiate.
      */
-    abstract setShippingAddress(payload: CheckoutMutationSetShippingAddress): Promise<Result<Checkout>>;
+    abstract setShippingAddress(payload: CheckoutMutationSetShippingAddress): Promise<Result<TCheckout>>;
     /**
      * Returns all available shipping methods for the given checkout. This will typically depend on the shipping address, and possibly also the items in the checkout.
      *
@@ -41,7 +41,7 @@ export declare abstract class CheckoutProvider extends BaseProvider {
      * @param checkoutId The checkout you want to get shipping methods for.
      * @param reqCtx
      */
-    abstract getAvailableShippingMethods(payload: CheckoutQueryForAvailableShippingMethods): Promise<Result<ShippingMethod[]>>;
+    abstract getAvailableShippingMethods(payload: CheckoutQueryForAvailableShippingMethods): Promise<Result<TShippingMethod[]>>;
     /**
      * Returns all available payment methods for the given checkout. This will typically depend mostly on the billing address and jurisdiction.
      *
@@ -50,20 +50,20 @@ export declare abstract class CheckoutProvider extends BaseProvider {
      * @param checkoutId The checkout you want to get payment methods for.
      * @param reqCtx
      */
-    abstract getAvailablePaymentMethods(payload: CheckoutQueryForAvailablePaymentMethods): Promise<Result<PaymentMethod[]>>;
+    abstract getAvailablePaymentMethods(payload: CheckoutQueryForAvailablePaymentMethods): Promise<Result<TPaymentMethod[]>>;
     /**
      * Adds a payment instruction to the checkout. This will typically create a payment intent in the payment provider, and return whatever is needed to continue the payment process, e.g. a client secret for Stripe, or a redirect URL for PayPal.
      *
      * Usecase: User has chosen a payment method, and you need to start the payment process.
      */
-    abstract addPaymentInstruction(payload: CheckoutMutationAddPaymentInstruction): Promise<Result<Checkout>>;
+    abstract addPaymentInstruction(payload: CheckoutMutationAddPaymentInstruction): Promise<Result<TCheckout>>;
     /**
      * Removes a payment instruction from the checkout. This will typically void the payment intent in the payment provider, and remove the payment instruction from the checkout.
      *
      * Usecase: User has decided to change payment method, or has cancelled the payment process.
      * @param paymentInstructionId
      */
-    abstract removePaymentInstruction(payload: CheckoutMutationRemovePaymentInstruction): Promise<Result<Checkout>>;
+    abstract removePaymentInstruction(payload: CheckoutMutationRemovePaymentInstruction): Promise<Result<TCheckout>>;
     /**
      * Sets the shipping method and optional pickup point for the checkout. The pickup point can be a physical store, a locker, or similar.
      * If it is unset, it means home delivery to the shipping address.
@@ -74,7 +74,7 @@ export declare abstract class CheckoutProvider extends BaseProvider {
      * @param shippingMethodId
      * @param pickupPoint
      */
-    abstract setShippingInstruction(payload: CheckoutMutationSetShippingInstruction): Promise<Result<Checkout>>;
+    abstract setShippingInstruction(payload: CheckoutMutationSetShippingInstruction): Promise<Result<TCheckout>>;
     /**
      * Finalizes the checkout process. This typically involves creating an order from the checkout and processing payment.
      *
@@ -83,7 +83,7 @@ export declare abstract class CheckoutProvider extends BaseProvider {
      * @param payload
      * @param reqCtx
      */
-    abstract finalizeCheckout(payload: CheckoutMutationFinalizeCheckout): Promise<Result<Checkout>>;
+    abstract finalizeCheckout(payload: CheckoutMutationFinalizeCheckout): Promise<Result<TCheckout>>;
     getResourceName(): string;
 }
 /**

package/src/{providers/identity.provider.d.ts → capabilities/identity.capability.d.ts}

@@ -2,12 +2,12 @@ import type { Identity } from "../schemas/models/identity.model.js";
 import type { IdentityMutationLogin, IdentityMutationLogout, IdentityMutationRegister } from "../schemas/mutations/identity.mutation.js";
 import type { IdentityQuerySelf } from "../schemas/queries/identity.query.js";
 import type { Result } from "../schemas/result.js";
-import { BaseProvider } from "./base.provider.js";
-export declare abstract class IdentityProvider extends BaseProvider {
-    abstract getSelf(payload: IdentityQuerySelf): Promise<Result<Identity>>;
-    abstract login(payload: IdentityMutationLogin): Promise<Result<Identity>>;
-    abstract logout(payload: IdentityMutationLogout): Promise<Result<Identity>>;
-    abstract register(payload: IdentityMutationRegister): Promise<Result<Identity>>;
+import { BaseCapability } from "./base.capability.js";
+export declare abstract class IdentityCapability<TIdentity extends Identity = Identity> extends BaseCapability {
+    abstract getSelf(payload: IdentityQuerySelf): Promise<Result<TIdentity>>;
+    abstract login(payload: IdentityMutationLogin): Promise<Result<TIdentity>>;
+    abstract logout(payload: IdentityMutationLogout): Promise<Result<TIdentity>>;
+    abstract register(payload: IdentityMutationRegister): Promise<Result<TIdentity>>;
     protected getResourceName(): string;
-    protected updateIdentityContext(identity: Identity): void;
+    protected updateIdentityContext(identity: TIdentity): void;
 }

package/src/capabilities/index.d.ts

@@ -0,0 +1,18 @@
+export * from './analytics.capability.js';
+export * from './base.capability.js';
+export * from './cart.capability.js';
+export * from './category.capability.js';
+export * from './checkout.capability.js';
+export * from './identity.capability.js';
+export * from './inventory.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 './store.capability.js';
+export * from './order.capability.js';
+export * from './order-search.capability.js';

package/src/{providers/inventory.provider.d.ts → capabilities/inventory.capability.d.ts}

@@ -3,9 +3,9 @@ import type { InventoryIdentifier } from '../schemas/models/identifiers.model.js
 import type { Inventory } from '../schemas/models/inventory.model.js';
 import type { InventoryQueryBySKU } from '../schemas/queries/inventory.query.js';
 import type { Result } from '../schemas/result.js';
-import { BaseProvider } from './base.provider.js';
-export declare abstract class InventoryProvider extends BaseProvider {
-    abstract getBySKU(payload: InventoryQueryBySKU): Promise<Result<Inventory, NotFoundError>>;
+import { BaseCapability } from './base.capability.js';
+export declare abstract class InventoryCapability<TInventory extends Inventory = Inventory> extends BaseCapability {
+    abstract getBySKU(payload: InventoryQueryBySKU): Promise<Result<TInventory, NotFoundError>>;
     protected getResourceName(): string;
-    protected createEmptyInventory(key: InventoryIdentifier): Inventory;
+    protected createEmptyInventory(key: InventoryIdentifier): TInventory;
 }

package/src/{providers/order-search.provider.d.ts → capabilities/order-search.capability.d.ts}

@@ -1,14 +1,14 @@
 import type { OrderSearchResult } from "../schemas/models/order-search.model.js";
 import type { OrderSearchQueryByTerm } from "../schemas/queries/order-search.query.js";
 import type { Result } from "../schemas/result.js";
-import { BaseProvider } from "./base.provider.js";
+import { BaseCapability } from "./base.capability.js";
 /**
  * This provider handles order search operations. In some situations you may have different providers for order history listing and detail retrieval.
  * The order search is primarily focused on searching and listing orders based on various criteria, and returns only summary information about each order.
  *
  * Usecase: An e-commerce platform wants to provide customers with a way to search through their past orders using filters like date range, order status, or total amount spent.
  */
-export declare abstract class OrderSearchProvider extends BaseProvider {
+export declare abstract class OrderSearchCapability<TOrderSearchResult extends OrderSearchResult = OrderSearchResult> extends BaseCapability {
     protected getResourceName(): string;
     /**
      * Queries orders based on the provided search criteria.
@@ -17,5 +17,5 @@ export declare abstract class OrderSearchProvider extends BaseProvider {
      * Usecase: A widget on the frontpage after login, shows the last 5 orders placed by the customer.
      * @param payload The search criteria for querying orders.
      */
-    abstract queryByTerm(payload: OrderSearchQueryByTerm): Promise<Result<OrderSearchResult>>;
+    abstract queryByTerm(payload: OrderSearchQueryByTerm): Promise<Result<TOrderSearchResult>>;
 }

package/src/{providers/order.provider.d.ts → capabilities/order.capability.d.ts}

@@ -1,9 +1,9 @@
-import { BaseProvider } from './base.provider.js';
+import { BaseCapability } from './base.capability.js';
 import type { Order } from '../schemas/models/index.js';
 import type { OrderQueryById } from '../schemas/queries/index.js';
 import type { Result } from '../schemas/result.js';
 import type { NotFoundError } from '../schemas/index.js';
-export declare abstract class OrderProvider extends BaseProvider {
+export declare abstract class OrderCapability<TOrder extends Order = Order> extends BaseCapability {
     /**
      * Get order by ID.
      *
@@ -11,7 +11,7 @@ export declare abstract class OrderProvider extends BaseProvider {
      * @param payload
      * @param session
      */
-    abstract getById(payload: OrderQueryById): Promise<Result<Order, NotFoundError>>;
-    protected createEmptyOrder(): Order;
+    abstract getById(payload: OrderQueryById): Promise<Result<TOrder, NotFoundError>>;
+    protected createEmptyOrder(): TOrder;
     protected getResourceName(): string;
 }

package/src/{providers/price.provider.d.ts → capabilities/price.capability.d.ts}

@@ -1,7 +1,7 @@
 import type { Price, Result } from '../schemas/index.js';
 import type { CustomerPriceQuery, ListPriceQuery } from '../schemas/queries/price.query.js';
-import { BaseProvider } from './base.provider.js';
-export declare abstract class PriceProvider extends BaseProvider {
+import { BaseCapability } from './base.capability.js';
+export declare abstract class PriceCapability<TPrice extends Price = Price> extends BaseCapability {
     /**
      * Get a list price price by SKU. This is the most general, undiscounted price and is typically
      * used as the "before" price in most ecommerce setups.
@@ -10,7 +10,7 @@ export declare abstract class PriceProvider extends BaseProvider {
      * @param payload The SKU to query
      * @param session The session information
      */
-    abstract getListPrice(payload: ListPriceQuery): Promise<Result<Price>>;
+    abstract getListPrice(payload: ListPriceQuery): Promise<Result<TPrice>>;
     /**
      * Get a customer-specific price by SKU.
      *
@@ -20,7 +20,7 @@ export declare abstract class PriceProvider extends BaseProvider {
      * @param payload The SKU to query
      * @param session The session information
      */
-    abstract getCustomerPrice(payload: CustomerPriceQuery): Promise<Result<Price>>;
+    abstract getCustomerPrice(payload: CustomerPriceQuery): Promise<Result<TPrice>>;
     /**
      * Utility function to create an empty price result, with a value of -1.
      * This is used when no price is found for a given SKU + currency combination.
@@ -29,6 +29,6 @@ export declare abstract class PriceProvider extends BaseProvider {
      * @param currency
      * @returns
      */
-    protected createEmptyPriceResult(sku: string): Price;
+    protected createEmptyPriceResult(sku: string): TPrice;
     protected getResourceName(): string;
 }

package/src/{providers/product-associations.provider.d.ts → capabilities/product-associations.capability.d.ts}

@@ -1,5 +1,5 @@
 import type { ProductAssociationsGetAccessoriesQuery, ProductAssociationsGetSparepartsQuery, ProductAssociationsGetReplacementsQuery } from "../schemas/queries/product-associations.query.js";
-import { BaseProvider } from "./base.provider.js";
+import { BaseCapability } from "./base.capability.js";
 import type { Result } from '../schemas/result.js';
 import type { ProductAssociation } from '../schemas/models/product-associations.model.js';
 /**
@@ -7,7 +7,7 @@ import type { ProductAssociation } from '../schemas/models/product-associations.
  * accessories, spareparts, and replacements. These associations are typically used to provide recommendations to customers on the product detail page, but can also be used in other contexts such as the cart or post-purchase, but
  * do not carry any personalization concept to them.
  */
-export declare abstract class ProductAssociationsProvider extends BaseProvider {
+export declare abstract class ProductAssociationsCapability<TProductAssociation extends ProductAssociation = ProductAssociation> extends BaseCapability {
     /**
      * Returns a list of product identifiers which are accessories to the given product.
      * Accessories in are products in their own right, but are commonly purchased alongside or recommended as complementary to the main product. Examples of accessories include:
@@ -20,7 +20,7 @@ export declare abstract class ProductAssociationsProvider extends BaseProvider {
      *
      * TODO:  This should be a PaginatedResult
      */
-    abstract getAccessories(query: ProductAssociationsGetAccessoriesQuery): Promise<Result<ProductAssociation[]>>;
+    abstract getAccessories(query: ProductAssociationsGetAccessoriesQuery): Promise<Result<TProductAssociation[]>>;
     /**
      * Returns a list of product identifiers which are spareparts to the given product.
      * Spareparts are products which are necessary for the use of the main product, but are not typically purchased alongside it. Examples of spareparts include:
@@ -30,13 +30,13 @@ export declare abstract class ProductAssociationsProvider extends BaseProvider {
      *
      * TODO:  This should be a PaginatedResult
      */
-    abstract getSpareparts(query: ProductAssociationsGetSparepartsQuery): Promise<Result<ProductAssociation[]>>;
+    abstract getSpareparts(query: ProductAssociationsGetSparepartsQuery): Promise<Result<TProductAssociation[]>>;
     /**
      * This product is replaced by these equivalent or newer products
      *
      * TODO:  This should be a PaginatedResult
      * @param query
      */
-    abstract getReplacements(query: ProductAssociationsGetReplacementsQuery): Promise<Result<ProductAssociation[]>>;
+    abstract getReplacements(query: ProductAssociationsGetReplacementsQuery): Promise<Result<TProductAssociation[]>>;
     getResourceName(): string;
 }

package/src/{providers/product-list.provider.d.ts → capabilities/product-list.capability.d.ts}

@@ -3,7 +3,7 @@ import type { ProductListItemMutationCreate, ProductListItemMutationDelete, Prod
 import type { ProductListQuery, ProductListQueryById } from "../schemas/queries/product-list.query.js";
 import { type ProductListItemsQuery } from "../schemas/queries/product-list.query.js";
 import type { Result } from "../schemas/result.js";
-import { BaseProvider } from "./base.provider.js";
+import { BaseCapability } from "./base.capability.js";
 /**
  * The product list provider is a general purpose provider for creating various types of product lists, such as favorite lists, projects, wishlists, requisitionlists, etc
  * It supports having multiples of each list, so that users can have multiple wishlists for example. The lists are identified by a key, which is passed in the query for the various methods.
@@ -12,21 +12,21 @@ import { BaseProvider } from "./base.provider.js";
  *
  * Some systems might only support single entries of each type, but the general case is to support multiples.
  */
-export declare abstract class ProductListProvider extends BaseProvider {
+export declare abstract class ProductListCapability<TProductList extends ProductList = ProductList, TProductListItem extends ProductListItem = ProductListItem, TProductListPaginatedResult extends ProductListPaginatedResult = ProductListPaginatedResult, TProductListItemPaginatedResult extends ProductListItemPaginatedResult = ProductListItemPaginatedResult> extends BaseCapability {
     protected getResourceName(): string;
     /**
      * Usecase: in the frontend you want to fetch a specific list, for example a specific wishlist, to show the details of the list, such as the name, description, image, etc.
      * you might have stored the identifier from an earlier session or looked it up previously.
      * @param payload
      */
-    abstract getById(payload: ProductListQueryById): Promise<Result<ProductList>>;
+    abstract getById(payload: ProductListQueryById): Promise<Result<TProductList>>;
     /**
      * Usecase: in the frontend you want to see if the customer already has a favorite list or wishlist, to which the product can be added.
      * In complex scenarios you might want to fetch a list of wishlists, and allow customer to pick which one to add the product-variant to.
      *
      * @param query
      */
-    abstract queryLists(query: ProductListQuery): Promise<Result<ProductListPaginatedResult>>;
+    abstract queryLists(query: ProductListQuery): Promise<Result<TProductListPaginatedResult>>;
     /**
      * Usecase: in the frontend, if customer has clicked the "add to favorites list", and you have used the queryLists to find out there is no
      * preexistiing list, you can use this method to create a new favorite list.
@@ -35,13 +35,13 @@ export declare abstract class ProductListProvider extends BaseProvider {
      * which the customer can then add the product to.
      * @param mutation
      */
-    abstract addList(mutation: ProductListMutationCreate): Promise<Result<ProductList>>;
+    abstract addList(mutation: ProductListMutationCreate): Promise<Result<TProductList>>;
     /**
      *
      * Usecase: update name of list, or other metadata related to the list, such as "this is my summer wishlist", or "this is my favorite list for cameras".
      * @param mutation
      */
-    abstract updateList(mutation: ProductListMutationUpdate): Promise<Result<ProductList>>;
+    abstract updateList(mutation: ProductListMutationUpdate): Promise<Result<TProductList>>;
     /**
      * Usecase: customer wants to delete a list, such as "delete my summer wishlist", including all the product list items
      * @param mutation
@@ -51,12 +51,12 @@ export declare abstract class ProductListProvider extends BaseProvider {
      * Usecase: in the frontend you want to show a list of the products in the customers wishlist.
      * @param query
      */
-    abstract queryListItems(query: ProductListItemsQuery): Promise<Result<ProductListItemPaginatedResult>>;
+    abstract queryListItems(query: ProductListItemsQuery): Promise<Result<TProductListItemPaginatedResult>>;
     /**
      * Usecase: Add a new product-variant to a list
      * @param mutation
      */
-    abstract addItem(mutation: ProductListItemMutationCreate): Promise<Result<ProductListItem>>;
+    abstract addItem(mutation: ProductListItemMutationCreate): Promise<Result<TProductListItem>>;
     /**
      * Usecase: Remove a product-variant from a list.
      * @param mutation
@@ -66,5 +66,5 @@ export declare abstract class ProductListProvider extends BaseProvider {
      * Usecase: Update the quantity of a product-variant in a list.
      * @param mutation
      */
-    abstract updateItem(mutation: ProductListItemMutationUpdate): Promise<Result<ProductListItem>>;
+    abstract updateItem(mutation: ProductListItemMutationUpdate): Promise<Result<TProductListItem>>;
 }

package/src/{providers/product-recommendations.provider.d.ts → capabilities/product-recommendations.capability.d.ts}

@@ -1,10 +1,10 @@
 import type { Cache } from '../cache/cache.interface.js';
 import { type ProductRecommendation, type ProductRecommendationsByCollectionQuery, type RequestContext, type Result } from "../schemas/index.js";
 import { type ProductRecommendationAlgorithmAlsoViewedProductsQuery, type ProductRecommendationAlgorithmFrequentlyBoughtTogetherQuery, type ProductRecommendationAlgorithmPopuplarProductsQuery, type ProductRecommendationAlgorithmRelatedProductsQuery, type ProductRecommendationAlgorithmSimilarProductsQuery, type ProductRecommendationAlgorithmTopPicksProductsQuery, type ProductRecommendationAlgorithmTrendingInCategoryQuery, type ProductRecommendationsQuery } from "../schemas/queries/product-recommendations.query.js";
-import { BaseProvider } from "./base.provider.js";
-export declare abstract class ProductRecommendationsProvider extends BaseProvider {
+import { BaseCapability } from "./base.capability.js";
+export declare abstract class ProductRecommendationsCapability extends BaseCapability {
     /**
-     * returns a list of recommended products, based on the selected algorithm and the provided query parameters. The recommendations should be relevant to the product specified in the query, and can be personalized based on the customer segments or contexts provided. The provider should return a list of product variant identifiers that are recommended for the given product, which can then be used to fetch the full product details from the product provider if needed.
+     * returns a list of recommended products, based on the selected algorithm and the provided query parameters. The recommendations should be relevant to the product specified in the query, and can be personalized based on the customer segments or contexts provided. The capability should return a list of product variant identifiers that are recommended for the given product, which can then be used to fetch the full product details from the product capability if needed.
      *   *
      * Usecase:
      *   - PDP - "Customers who viewed this product also viewed"
@@ -24,9 +24,9 @@ export declare abstract class ProductRecommendationsProvider extends BaseProvide
     protected getAlsoViewedProductsRecommendations(query: ProductRecommendationAlgorithmAlsoViewedProductsQuery): Promise<ProductRecommendation[]>;
     protected getResourceName(): string;
 }
-export declare class MulticastProductRecommendationsProvider extends ProductRecommendationsProvider {
-    protected providers: Array<ProductRecommendationsProvider>;
-    constructor(cache: Cache, requestContext: RequestContext, providers: Array<ProductRecommendationsProvider>);
+export declare class MulticastProductRecommendationsCapability extends ProductRecommendationsCapability {
+    protected capabilities: Array<ProductRecommendationsCapability>;
+    constructor(cache: Cache, requestContext: RequestContext, capabilities: Array<ProductRecommendationsCapability>);
     getRecommendations(query: ProductRecommendationsQuery): Promise<Result<ProductRecommendation[]>>;
     getCollection(query: ProductRecommendationsByCollectionQuery): Promise<Result<ProductRecommendation[]>>;
 }

package/src/{providers/product-reviews.provider.d.ts → capabilities/product-reviews.capability.d.ts}

@@ -1,35 +1,35 @@
 import type { Result, ProductReview, ProductRatingSummary, ProductReviewPaginatedResult } from '../schemas/index.js';
 import type { ProductReviewsListQuery, ProductReviewsGetRatingSummaryQuery } from '../schemas/queries/product-reviews.query.js';
 import type { ProductReviewMutationSubmit } from '../schemas/mutations/product-reviews.mutation.js';
-import { BaseProvider } from './base.provider.js';
+import { BaseCapability } from './base.capability.js';
 import { type ProductRatingIdentifier } from '../schemas/models/identifiers.model.js';
 /**
  * The product reviews provider is responsible for providing detailed product reviews from customers.
  * Reviews contain ratings along with textual feedback, author information, and verification status.
  * This provider also handles aggregated rating summaries for products.
  */
-export declare abstract class ProductReviewsProvider extends BaseProvider {
+export declare abstract class ProductReviewsCapability<TProductRatingSummary extends ProductRatingSummary = ProductRatingSummary, TProductReviewPaginatedResult extends ProductReviewPaginatedResult = ProductReviewPaginatedResult, TProductReview extends ProductReview = ProductReview> extends BaseCapability {
     /**
      * Get the rating summary for a product, including average rating and distribution.
      *
      * Usecase: Display rating summary on product detail pages or product listing pages.
      * @param query The product to get ratings for
      */
-    abstract getRatingSummary(query: ProductReviewsGetRatingSummaryQuery): Promise<Result<ProductRatingSummary>>;
+    abstract getRatingSummary(query: ProductReviewsGetRatingSummaryQuery): Promise<Result<TProductRatingSummary>>;
     /**
      * Get a paginated list of reviews for a product.
      *
      * Usecase: Display customer reviews on product detail pages with filtering and sorting options.
      * @param query The query parameters including product, pagination, sorting, and filtering options
      */
-    abstract findReviews(query: ProductReviewsListQuery): Promise<Result<ProductReviewPaginatedResult>>;
+    abstract findReviews(query: ProductReviewsListQuery): Promise<Result<TProductReviewPaginatedResult>>;
     /**
      * Submit a review for a product.
      *
      * Usecase: Allow customers to submit detailed reviews with ratings for products they have purchased.
      * @param mutation The review submission data including rating, title, and content
      */
-    abstract submitReview(mutation: ProductReviewMutationSubmit): Promise<Result<ProductReview>>;
+    abstract submitReview(mutation: ProductReviewMutationSubmit): Promise<Result<TProductReview>>;
     protected createEmptyProductRatingSummary(key: ProductRatingIdentifier): ProductRatingSummary;
     getResourceName(): string;
 }