@reactionary/source 0.3.18 → 0.6.2

package/core/src/factories/product.factory.ts

@@ -0,0 +1,21 @@
+import type * as z from 'zod';
+import type { ProductSchema } from '../schemas/models/product.model.js';
+import type { RequestContext } from '../schemas/session.schema.js';
+
+export type AnyProductSchema = z.ZodType<z.output<typeof ProductSchema>>;
+
+export interface ProductFactory<TProductSchema extends AnyProductSchema = AnyProductSchema> {
+  productSchema: TProductSchema;
+  parseProduct(context: RequestContext, data: unknown): z.output<TProductSchema>;
+}
+
+export type ProductFactoryOutput<TFactory extends ProductFactory> = ReturnType<
+  TFactory['parseProduct']
+>;
+
+export type ProductFactoryWithOutput<TFactory extends ProductFactory> = Omit<
+  TFactory,
+  'parseProduct'
+> & {
+  parseProduct(context: RequestContext, data: unknown): ProductFactoryOutput<TFactory>;
+};

package/core/src/factories/profile.factory.ts

@@ -0,0 +1,23 @@
+import type * as z from 'zod';
+import type { ProfileSchema } from '../schemas/models/profile.model.js';
+import type { RequestContext } from '../schemas/session.schema.js';
+
+export type AnyProfileSchema = z.ZodType<z.output<typeof ProfileSchema>>;
+
+export interface ProfileFactory<
+  TProfileSchema extends AnyProfileSchema = AnyProfileSchema,
+> {
+  profileSchema: TProfileSchema;
+  parseProfile(context: RequestContext, data: unknown): z.output<TProfileSchema>;
+}
+
+export type ProfileFactoryOutput<TFactory extends ProfileFactory> = ReturnType<
+  TFactory['parseProfile']
+>;
+
+export type ProfileFactoryWithOutput<TFactory extends ProfileFactory> = Omit<
+  TFactory,
+  'parseProfile'
+> & {
+  parseProfile(context: RequestContext, data: unknown): ProfileFactoryOutput<TFactory>;
+};

package/core/src/factories/store.factory.ts

@@ -0,0 +1,21 @@
+import type * as z from 'zod';
+import type { StoreSchema } from '../schemas/models/store.model.js';
+import type { RequestContext } from '../schemas/session.schema.js';
+
+export type AnyStoreSchema = z.ZodType<z.output<typeof StoreSchema>>;
+
+export interface StoreFactory<TStoreSchema extends AnyStoreSchema = AnyStoreSchema> {
+  storeSchema: TStoreSchema;
+  parseStore(context: RequestContext, data: unknown): z.output<TStoreSchema>;
+}
+
+export type StoreFactoryOutput<TFactory extends StoreFactory> = ReturnType<
+  TFactory['parseStore']
+>;
+
+export type StoreFactoryWithOutput<TFactory extends StoreFactory> = Omit<
+  TFactory,
+  'parseStore'
+> & {
+  parseStore(context: RequestContext, data: unknown): StoreFactoryOutput<TFactory>;
+};

package/core/src/index.ts

@@ -1,6 +1,8 @@
 export * from './cache/index.js';
 export * from './client/index.js';
 export * from './decorators/index.js';
+export * from './factories/index.js';
 export * from './providers/index.js';
 export * from './schemas/index.js';
-export * from './initialization.js';
+export * from './initialization.js';
+export type { InferType } from './zod-utils.js';

package/core/src/providers/cart.provider.ts

@@ -9,7 +9,10 @@ import { BaseProvider } from "./base.provider.js";
 /**
  * @group Providers
  */
-export abstract class CartProvider extends BaseProvider {
+export abstract class CartProvider<
+  TCart extends Cart = Cart,
+  TCartIdentifier extends CartIdentifier = CartIdentifier,
+> extends BaseProvider {
 
   /**
    * Get cart by ID.
@@ -18,7 +21,7 @@ export abstract class CartProvider extends BaseProvider {
    * @param payload
    * @param session
    */
-  public abstract getById(payload: CartQueryById): Promise<Result<Cart, NotFoundError>>;
+  public abstract getById(payload: CartQueryById): Promise<Result<TCart, NotFoundError>>;
 
 
   /**
@@ -27,7 +30,7 @@ export abstract class CartProvider extends BaseProvider {
    * 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
    */
-  public abstract getActiveCartId(): Promise<Result<CartIdentifier, NotFoundError>>;
+  public abstract getActiveCartId(): Promise<Result<TCartIdentifier, NotFoundError>>;
 
 
   /**
@@ -39,7 +42,7 @@ export abstract class CartProvider extends BaseProvider {
    * @param payload
    * @param session
    */
-  public abstract add(payload: CartMutationItemAdd): Promise<Result<Cart>>;
+  public 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.
@@ -48,7 +51,7 @@ export abstract class CartProvider extends BaseProvider {
    * @param payload
    * @param session
    */
-  public abstract remove(payload: CartMutationItemRemove): Promise<Result<Cart>>;
+  public 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.
@@ -59,7 +62,7 @@ export abstract class CartProvider extends BaseProvider {
    * @param payload
    * @param session
    */
-  public abstract changeQuantity(payload: CartMutationItemQuantityChange): Promise<Result<Cart>>;
+  public abstract changeQuantity(payload: CartMutationItemQuantityChange): Promise<Result<TCart>>;
 
 
   /**
@@ -78,7 +81,7 @@ export abstract class CartProvider extends BaseProvider {
    * @param payload
    * @param session
    */
-  public abstract applyCouponCode(payload: CartMutationApplyCoupon): Promise<Result<Cart>>;
+  public abstract applyCouponCode(payload: CartMutationApplyCoupon): Promise<Result<TCart>>;
 
 
   /**
@@ -88,7 +91,7 @@ export abstract class CartProvider extends BaseProvider {
    * @param payload
    * @param session
    */
-  public abstract removeCouponCode(payload: CartMutationRemoveCoupon): Promise<Result<Cart>>;
+  public abstract removeCouponCode(payload: CartMutationRemoveCoupon): Promise<Result<TCart>>;
 
   /**
    * Changes the currency of the cart.
@@ -97,10 +100,9 @@ export abstract class CartProvider extends BaseProvider {
    * @param newCurrency
    * @param session
    */
-  public abstract changeCurrency(payload: CartMutationChangeCurrency): Promise<Result<Cart>>;
+  public abstract changeCurrency(payload: CartMutationChangeCurrency): Promise<Result<TCart>>;
 
   protected override getResourceName(): string {
     return 'cart';
   }
 }
-

package/core/src/providers/category.provider.ts

@@ -13,7 +13,10 @@ import { BaseProvider } from "./base.provider.js";
  *
  * @group Foo
  */
-export abstract class CategoryProvider extends BaseProvider {
+export abstract class CategoryProvider<
+  TCategory extends Category = Category,
+  TCategoryPaginatedResult extends CategoryPaginatedResult = CategoryPaginatedResult,
+> extends BaseProvider {
   /**
    * Get a single category by its ID. Cannot return null, because HOW did you come across a categories ID that does not exist?
    *
@@ -29,7 +32,7 @@ export abstract class CategoryProvider extends BaseProvider {
    * @param id
    * @param session
    */
-  public abstract getById(payload: CategoryQueryById): Promise<Result<Category, NotFoundError>>;
+  public abstract getById(payload: CategoryQueryById): Promise<Result<TCategory, NotFoundError>>;
 
   /**
    * Gets a single category by its seo slug
@@ -38,7 +41,7 @@ export abstract class CategoryProvider extends BaseProvider {
    * @param slug the slug
    * @param session
    */
-  public abstract getBySlug(payload: CategoryQueryBySlug): Promise<Result<Category, NotFoundError>>;
+  public abstract getBySlug(payload: CategoryQueryBySlug): Promise<Result<TCategory, NotFoundError>>;
 
   /**
    * Gets the breadcrumb path to the category, i.e. all parents up to the root.
@@ -48,7 +51,7 @@ export abstract class CategoryProvider extends BaseProvider {
    * @param id
    * @param session
    */
-  public abstract getBreadcrumbPathToCategory(payload: CategoryQueryForBreadcrumb): Promise<Result<Category[]>>;
+  public abstract getBreadcrumbPathToCategory(payload: CategoryQueryForBreadcrumb): Promise<Result<TCategory[]>>;
 
   // hmm, this is not really good enough.... We need a type we can pass in that will allow us to specify the precise return type, but otoh we also need
   // to be able to verify and assert the output type. FIXME
@@ -63,7 +66,7 @@ export abstract class CategoryProvider extends BaseProvider {
    * @param id The ID of the parent category.
    * @param session The session information.
    */
-  public abstract findChildCategories(payload: CategoryQueryForChildCategories): Promise<Result<CategoryPaginatedResult>>;
+  public abstract findChildCategories(payload: CategoryQueryForChildCategories): Promise<Result<TCategoryPaginatedResult>>;
 
   /**
    * Returns all top categories, i.e. categories without a parent.
@@ -72,7 +75,7 @@ export abstract class CategoryProvider extends BaseProvider {
    * @param paginationOptions
    * @param session
    */
-  public abstract findTopCategories( payload: CategoryQueryForTopCategories): Promise<Result<CategoryPaginatedResult>>;
+  public abstract findTopCategories( payload: CategoryQueryForTopCategories): Promise<Result<TCategoryPaginatedResult>>;
 
 
   protected override getResourceName(): string {
@@ -80,4 +83,3 @@ export abstract class CategoryProvider extends BaseProvider {
   }
 
 }
-

package/core/src/providers/checkout.provider.ts

@@ -5,7 +5,11 @@ import type { CheckoutQueryById, CheckoutQueryForAvailablePaymentMethods, Checko
 import type { Result } from "../schemas/result.js";
 import type { NotFoundError } from "../schemas/index.js";
 
-export abstract class CheckoutProvider extends BaseProvider {
+export abstract class CheckoutProvider<
+  TCheckout extends Checkout = Checkout,
+  TShippingMethod extends ShippingMethod = ShippingMethod,
+  TPaymentMethod extends PaymentMethod = PaymentMethod,
+> extends BaseProvider {
 
   /**
    * 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,
@@ -17,7 +21,7 @@ export 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
    */
-  public abstract initiateCheckoutForCart(payload: CheckoutMutationInitiateCheckout): Promise<Result<Checkout>>;
+  public abstract initiateCheckoutForCart(payload: CheckoutMutationInitiateCheckout): Promise<Result<TCheckout>>;
 
 
   /**
@@ -27,7 +31,7 @@ export abstract class CheckoutProvider extends BaseProvider {
    * @param payload
    * @param reqCtx
    */
-  public abstract getById(payload:  CheckoutQueryById): Promise<Result<Checkout, NotFoundError>>;
+  public abstract getById(payload:  CheckoutQueryById): Promise<Result<TCheckout, NotFoundError>>;
 
   /**
    * Updates the shipping address for the checkout and recalculates the shipping methods and totals.
@@ -37,7 +41,7 @@ export 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.
    */
-  public abstract setShippingAddress(payload: CheckoutMutationSetShippingAddress): Promise<Result<Checkout>>;
+  public 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.
@@ -47,7 +51,7 @@ export abstract class CheckoutProvider extends BaseProvider {
    * @param checkoutId The checkout you want to get shipping methods for.
    * @param reqCtx
    */
-  public abstract getAvailableShippingMethods(payload: CheckoutQueryForAvailableShippingMethods): Promise<Result<ShippingMethod[]>>;
+  public 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.
@@ -57,7 +61,7 @@ export abstract class CheckoutProvider extends BaseProvider {
    * @param checkoutId The checkout you want to get payment methods for.
    * @param reqCtx
    */
-  public abstract getAvailablePaymentMethods(payload: CheckoutQueryForAvailablePaymentMethods): Promise<Result<PaymentMethod[]>>;
+  public abstract getAvailablePaymentMethods(payload: CheckoutQueryForAvailablePaymentMethods): Promise<Result<TPaymentMethod[]>>;
 
 
   /**
@@ -65,7 +69,7 @@ export abstract class CheckoutProvider extends BaseProvider {
    *
    * Usecase: User has chosen a payment method, and you need to start the payment process.
    */
-  public abstract addPaymentInstruction(payload: CheckoutMutationAddPaymentInstruction): Promise<Result<Checkout>>;
+  public 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.
@@ -73,7 +77,7 @@ export abstract class CheckoutProvider extends BaseProvider {
    * Usecase: User has decided to change payment method, or has cancelled the payment process.
    * @param paymentInstructionId
    */
-  public abstract removePaymentInstruction(payload: CheckoutMutationRemovePaymentInstruction): Promise<Result<Checkout>>;
+  public abstract removePaymentInstruction(payload: CheckoutMutationRemovePaymentInstruction): Promise<Result<TCheckout>>;
 
 
 
@@ -87,7 +91,7 @@ export abstract class CheckoutProvider extends BaseProvider {
    * @param shippingMethodId
    * @param pickupPoint
    */
-  public abstract setShippingInstruction(payload: CheckoutMutationSetShippingInstruction): Promise<Result<Checkout>>;
+  public abstract setShippingInstruction(payload: CheckoutMutationSetShippingInstruction): Promise<Result<TCheckout>>;
 
   /**
    * Finalizes the checkout process. This typically involves creating an order from the checkout and processing payment.
@@ -97,7 +101,7 @@ export abstract class CheckoutProvider extends BaseProvider {
    * @param payload
    * @param reqCtx
    */
-  public abstract finalizeCheckout(payload: CheckoutMutationFinalizeCheckout): Promise<Result<Checkout>>;
+  public abstract finalizeCheckout(payload: CheckoutMutationFinalizeCheckout): Promise<Result<TCheckout>>;
 
 
   public override getResourceName(): string {

package/core/src/providers/identity.provider.ts

@@ -4,18 +4,18 @@ import type { IdentityQuerySelf } from "../schemas/queries/identity.query.js";
 import type { Result } from "../schemas/result.js";
 import { BaseProvider } from "./base.provider.js";
 
-export abstract class IdentityProvider extends BaseProvider {
-  public abstract getSelf(payload: IdentityQuerySelf): Promise<Result<Identity>>;
-  public abstract login(payload: IdentityMutationLogin): Promise<Result<Identity>>;
-  public abstract logout(payload: IdentityMutationLogout): Promise<Result<Identity>>;
-  public abstract register(payload: IdentityMutationRegister): Promise<Result<Identity>>;
+export abstract class IdentityProvider<TIdentity extends Identity = Identity> extends BaseProvider {
+  public abstract getSelf(payload: IdentityQuerySelf): Promise<Result<TIdentity>>;
+  public abstract login(payload: IdentityMutationLogin): Promise<Result<TIdentity>>;
+  public abstract logout(payload: IdentityMutationLogout): Promise<Result<TIdentity>>;
+  public abstract register(payload: IdentityMutationRegister): Promise<Result<TIdentity>>;
 
   protected override getResourceName(): string {
     return 'identity';
   }
 
-  protected updateIdentityContext(identity: Identity) {
+  protected updateIdentityContext(identity: TIdentity) {
     this.context.session.identityContext.lastUpdated = new Date();
-    this.context.session.identityContext.identity = identity;
+    this.context.session.identityContext.identity = identity as Identity;
   }
 }

package/core/src/providers/inventory.provider.ts

@@ -5,20 +5,20 @@ import type { InventoryQueryBySKU } from '../schemas/queries/inventory.query.js'
 import type { Result } from '../schemas/result.js';
 import { BaseProvider } from './base.provider.js';
 
-export abstract class InventoryProvider extends BaseProvider {
-  public abstract getBySKU(payload: InventoryQueryBySKU): Promise<Result<Inventory, NotFoundError>>;
+export abstract class InventoryProvider<TInventory extends Inventory = Inventory> extends BaseProvider {
+  public abstract getBySKU(payload: InventoryQueryBySKU): Promise<Result<TInventory, NotFoundError>>;
 
   protected override getResourceName(): string {
     return 'inventory';
   }
 
-  protected createEmptyInventory(key: InventoryIdentifier): Inventory {
+  protected createEmptyInventory(key: InventoryIdentifier): TInventory {
     const inventory = {
         identifier: key,
         quantity: 0,
         status: 'outOfStock'
     } satisfies Inventory;
 
-    return inventory;
+    return inventory as unknown as TInventory;
   }
 }

package/core/src/providers/order-search.provider.ts

@@ -9,7 +9,9 @@ import { BaseProvider } from "./base.provider.js";
  *
  * 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 abstract class OrderSearchProvider extends BaseProvider {
+export abstract class OrderSearchProvider<
+  TOrderSearchResult extends OrderSearchResult = OrderSearchResult,
+> extends BaseProvider {
   protected override getResourceName(): string {
     return 'order-search';
   }
@@ -21,7 +23,7 @@ export 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.
    */
-  public abstract queryByTerm(payload: OrderSearchQueryByTerm): Promise<Result<OrderSearchResult>>;
+  public abstract queryByTerm(payload: OrderSearchQueryByTerm): Promise<Result<TOrderSearchResult>>;
 
 
 

package/core/src/providers/order.provider.ts

@@ -4,7 +4,7 @@ import type { OrderQueryById } from '../schemas/queries/index.js';
 import type { Result } from '../schemas/result.js';
 import type { NotFoundError } from '../schemas/index.js';
 
-export abstract class OrderProvider extends BaseProvider {
+export abstract class OrderProvider<TOrder extends Order = Order> extends BaseProvider {
   /**
    * Get order by ID.
    *
@@ -12,9 +12,9 @@ export abstract class OrderProvider extends BaseProvider {
    * @param payload
    * @param session
    */
-  public abstract getById(payload: OrderQueryById): Promise<Result<Order, NotFoundError>>;
+  public abstract getById(payload: OrderQueryById): Promise<Result<TOrder, NotFoundError>>;
 
-  protected createEmptyOrder(): Order {
+  protected createEmptyOrder(): TOrder {
     const order = {
       identifier: {
         key: '',
@@ -54,7 +54,7 @@ export abstract class OrderProvider extends BaseProvider {
       },
     } satisfies Order;
 
-    return order;
+    return order as unknown as TOrder;
   }
 
   protected override getResourceName(): string {

package/core/src/providers/price.provider.ts

@@ -5,7 +5,7 @@ import type {
 } from '../schemas/queries/price.query.js';
 import { BaseProvider } from './base.provider.js';
 
-export abstract class PriceProvider extends BaseProvider {
+export abstract class PriceProvider<TPrice extends Price = Price> extends BaseProvider {
   /**
    * 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.
@@ -14,7 +14,7 @@ export abstract class PriceProvider extends BaseProvider {
    * @param payload The SKU to query
    * @param session The session information
    */
-  public abstract getListPrice(payload: ListPriceQuery): Promise<Result<Price>>;
+  public abstract getListPrice(payload: ListPriceQuery): Promise<Result<TPrice>>;
 
   /**
    * Get a customer-specific price by SKU.
@@ -25,7 +25,7 @@ export abstract class PriceProvider extends BaseProvider {
    * @param payload The SKU to query
    * @param session The session information
    */
-  public abstract getCustomerPrice(payload: CustomerPriceQuery): Promise<Result<Price>>;
+  public abstract getCustomerPrice(payload: CustomerPriceQuery): Promise<Result<TPrice>>;
 
   /**
    * Utility function to create an empty price result, with a value of -1.
@@ -35,7 +35,7 @@ export abstract class PriceProvider extends BaseProvider {
    * @param currency
    * @returns
    */
-  protected createEmptyPriceResult(sku: string): Price {
+  protected createEmptyPriceResult(sku: string): TPrice {
     const price = {
       identifier: {
         variant: {
@@ -50,7 +50,7 @@ export abstract class PriceProvider extends BaseProvider {
       onSale: false,
     } satisfies Price;
 
-    return price;
+    return price as unknown as TPrice;
   }
 
   protected override getResourceName(): string {

package/core/src/providers/product-associations.provider.ts

@@ -9,7 +9,9 @@ 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 abstract class ProductAssociationsProvider extends BaseProvider {
+export abstract class ProductAssociationsProvider<
+  TProductAssociation extends ProductAssociation = ProductAssociation,
+> extends BaseProvider {
 
   /**
    * Returns a list of product identifiers which are accessories to the given product.
@@ -23,7 +25,7 @@ export abstract class ProductAssociationsProvider extends BaseProvider {
    *
    * TODO:  This should be a PaginatedResult
    */
-  public abstract getAccessories(query: ProductAssociationsGetAccessoriesQuery): Promise<Result<ProductAssociation[]>>;
+  public abstract getAccessories(query: ProductAssociationsGetAccessoriesQuery): Promise<Result<TProductAssociation[]>>;
 
   /**
    * Returns a list of product identifiers which are spareparts to the given product.
@@ -34,7 +36,7 @@ export abstract class ProductAssociationsProvider extends BaseProvider {
    *
    * TODO:  This should be a PaginatedResult
    */
-  public abstract getSpareparts(query: ProductAssociationsGetSparepartsQuery): Promise<Result<ProductAssociation[]>>;
+  public abstract getSpareparts(query: ProductAssociationsGetSparepartsQuery): Promise<Result<TProductAssociation[]>>;
 
 
   /**
@@ -43,7 +45,7 @@ export abstract class ProductAssociationsProvider extends BaseProvider {
    * TODO:  This should be a PaginatedResult
    * @param query
    */
-  public abstract getReplacements(query: ProductAssociationsGetReplacementsQuery): Promise<Result<ProductAssociation[]>>;
+  public abstract getReplacements(query: ProductAssociationsGetReplacementsQuery): Promise<Result<TProductAssociation[]>>;
 
 
   getResourceName(): string {

package/core/src/providers/product-list.provider.ts

@@ -13,7 +13,12 @@ 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 abstract class ProductListProvider extends BaseProvider {
+export abstract class ProductListProvider<
+  TProductList extends ProductList = ProductList,
+  TProductListItem extends ProductListItem = ProductListItem,
+  TProductListPaginatedResult extends ProductListPaginatedResult = ProductListPaginatedResult,
+  TProductListItemPaginatedResult extends ProductListItemPaginatedResult = ProductListItemPaginatedResult,
+> extends BaseProvider {
 
   protected getResourceName(): string {
     return 'product-lists';
@@ -24,7 +29,7 @@ export abstract class ProductListProvider extends BaseProvider {
    * you might have stored the identifier from an earlier session or looked it up previously.
    * @param payload
    */
-  public abstract getById(payload: ProductListQueryById): Promise<Result<ProductList>>;
+  public abstract getById(payload: ProductListQueryById): Promise<Result<TProductList>>;
 
 
   /**
@@ -33,7 +38,7 @@ export abstract class ProductListProvider extends BaseProvider {
    *
    * @param query
    */
-  public abstract queryLists(query: ProductListQuery): Promise<Result<ProductListPaginatedResult>>;
+  public abstract queryLists(query: ProductListQuery): Promise<Result<TProductListPaginatedResult>>;
 
 
   /**
@@ -44,14 +49,14 @@ export abstract class ProductListProvider extends BaseProvider {
    * which the customer can then add the product to.
    * @param mutation
    */
-  public abstract addList(mutation: ProductListMutationCreate): Promise<Result<ProductList>>;
+  public 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
    */
-  public abstract updateList(mutation: ProductListMutationUpdate): Promise<Result<ProductList>>;
+  public 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
@@ -63,13 +68,13 @@ export abstract class ProductListProvider extends BaseProvider {
    * Usecase: in the frontend you want to show a list of the products in the customers wishlist.
    * @param query
    */
-  public abstract queryListItems(query: ProductListItemsQuery): Promise<Result<ProductListItemPaginatedResult>>;
+  public abstract queryListItems(query: ProductListItemsQuery): Promise<Result<TProductListItemPaginatedResult>>;
 
   /**
    * Usecase: Add a new product-variant to a list
    * @param mutation
    */
-  public abstract addItem(mutation: ProductListItemMutationCreate): Promise<Result<ProductListItem>>;
+  public abstract addItem(mutation: ProductListItemMutationCreate): Promise<Result<TProductListItem>>;
 
   /**
    * Usecase: Remove a product-variant from a list.
@@ -81,6 +86,6 @@ export abstract class ProductListProvider extends BaseProvider {
    * Usecase: Update the quantity of a product-variant in a list.
    * @param mutation
    */
-  public abstract updateItem(mutation: ProductListItemMutationUpdate): Promise<Result<ProductListItem>>;
+  public abstract updateItem(mutation: ProductListItemMutationUpdate): Promise<Result<TProductListItem>>;
 
 }

package/core/src/providers/product-reviews.provider.ts

@@ -8,7 +8,11 @@ import { type ProductRatingIdentifier } from '../schemas/models/identifiers.mode
  * Reviews contain ratings along with textual feedback, author information, and verification status.
  * This provider also handles aggregated rating summaries for products.
  */
-export abstract class ProductReviewsProvider extends BaseProvider {
+export abstract class ProductReviewsProvider<
+  TProductRatingSummary extends ProductRatingSummary = ProductRatingSummary,
+  TProductReviewPaginatedResult extends ProductReviewPaginatedResult = ProductReviewPaginatedResult,
+  TProductReview extends ProductReview = ProductReview,
+> extends BaseProvider {
   /**
    * Get the rating summary for a product, including average rating and distribution.
    *
@@ -17,7 +21,7 @@ export abstract class ProductReviewsProvider extends BaseProvider {
    */
   public abstract getRatingSummary(
     query: ProductReviewsGetRatingSummaryQuery
-  ): Promise<Result<ProductRatingSummary>>;
+  ): Promise<Result<TProductRatingSummary>>;
 
   /**
    * Get a paginated list of reviews for a product.
@@ -27,7 +31,7 @@ export abstract class ProductReviewsProvider extends BaseProvider {
    */
   public abstract findReviews(
     query: ProductReviewsListQuery
-  ): Promise<Result<ProductReviewPaginatedResult>>;
+  ): Promise<Result<TProductReviewPaginatedResult>>;
   /**
    * Submit a review for a product.
    *
@@ -36,7 +40,7 @@ export abstract class ProductReviewsProvider extends BaseProvider {
    */
   public abstract submitReview(
     mutation: ProductReviewMutationSubmit
-  ): Promise<Result<ProductReview>>;
+  ): Promise<Result<TProductReview>>;
 
 
   protected createEmptyProductRatingSummary(key: ProductRatingIdentifier): ProductRatingSummary {