@labdigital/commercetools-mock 2.59.0 → 2.60.0

package/src/repositories/cart/index.ts

@@ -1,6 +1,5 @@
 import type {
 	BusinessUnit,
-	CentPrecisionMoney,
 	InvalidOperationError,
 	MissingTaxRateForCountryError,
 	ShippingMethodDoesNotMatchCartError,
@@ -15,27 +14,22 @@ import type {
 	LineItemDraft,
 	Product,
 	ProductPagedQueryResponse,
-	TaxPortion,
-	TaxedItemPrice,
 } from "@commercetools/platform-sdk";
-import { Decimal } from "decimal.js/decimal";
 import { v4 as uuidv4 } from "uuid";
 import type { Config } from "~src/config";
 import { CommercetoolsError } from "~src/exceptions";
 import { getBaseResourceProperties } from "~src/helpers";
-import { getShippingMethodsMatchingCart } from "~src/shipping";
+import { calculateTaxTotals } from "~src/lib/tax";
+import {
+	createShippingInfoFromMethod,
+	getShippingMethodsMatchingCart,
+} from "~src/shipping";
 import type { Writable } from "~src/types";
 import {
 	AbstractResourceRepository,
 	type RepositoryContext,
 } from "../abstract";
-import {
-	createAddress,
-	createCentPrecisionMoney,
-	createCustomFields,
-	createTypedMoney,
-	roundDecimal,
-} from "../helpers";
+import { createAddress, createCustomFields } from "../helpers";
 import { CartUpdateHandler } from "./actions";
 import {
 	calculateCartTotalPrice,
@@ -166,6 +160,10 @@ export class CartRepository extends AbstractResourceRepository<"cart"> {
 			);
 		}
 
+		const { taxedPrice, taxedShippingPrice } = calculateTaxTotals(resource);
+		resource.taxedPrice = taxedPrice;
+		resource.taxedShippingPrice = taxedShippingPrice;
+
 		return this.saveNew(context, resource);
 	}
 
@@ -284,15 +282,6 @@ export class CartRepository extends AbstractResourceRepository<"cart"> {
 			throw new Error("External tax rate is not supported");
 		}
 
-		const country = resource.shippingAddress?.country;
-
-		if (!country) {
-			throw new CommercetoolsError<InvalidOperationError>({
-				code: "InvalidOperation",
-				message: `The cart with ID '${resource.id}' does not have a shipping address set.`,
-			});
-		}
-
 		// Bit of a hack: calling this checks that the resource identifier is
 		// valid (i.e. id xor key) and that the shipping method exists.
 		this._storage.getByResourceIdentifier<"shipping-method">(
@@ -327,126 +316,12 @@ export class CartRepository extends AbstractResourceRepository<"cart"> {
 			});
 		}
 
-		const taxCategory = this._storage.getByResourceIdentifier<"tax-category">(
-			context.projectKey,
-			method.taxCategory,
-		);
-
-		// TODO: match state in addition to country
-		const taxRate = taxCategory.rates.find((rate) => rate.country === country);
-
-		if (!taxRate) {
-			throw new CommercetoolsError<MissingTaxRateForCountryError>({
-				code: "MissingTaxRateForCountry",
-				message: `Tax category '${taxCategory.id}' is missing a tax rate for country '${country}'.`,
-				taxCategoryId: taxCategory.id,
-			});
-		}
-
-		// There should only be one zone rate matching the address, since
-		// Locations cannot be assigned to more than one zone.
-		// See https://docs.commercetools.com/api/projects/zones#location
-		const zoneRate = method.zoneRates.find((rate) =>
-			rate.zone.obj?.locations.some((loc) => loc.country === country),
+		// Use the shared shipping info creation logic
+		return createShippingInfoFromMethod(
+			context,
+			this._storage,
+			resource,
+			method,
 		);
-
-		if (!zoneRate) {
-			// This shouldn't happen because getShippingMethodsMatchingCart already
-			// filtered out shipping methods without any zones matching the address
-			throw new Error("Zone rate not found");
-		}
-
-		// Shipping rates are defined by currency, and getShippingMethodsMatchingCart
-		// also matches on currency, so there should only be one in the array.
-		// See https://docs.commercetools.com/api/projects/shippingMethods#zonerate
-		const shippingRate = zoneRate.shippingRates[0];
-		if (!shippingRate) {
-			// This shouldn't happen because getShippingMethodsMatchingCart already
-			// filtered out shipping methods without any matching rates
-			throw new Error("Shipping rate not found");
-		}
-
-		const shippingRateTier = shippingRate.tiers.find((tier) => tier.isMatching);
-		if (shippingRateTier && shippingRateTier.type !== "CartValue") {
-			throw new Error("Non-CartValue shipping rate tier is not supported");
-		}
-
-		let shippingPrice = shippingRateTier
-			? createCentPrecisionMoney(shippingRateTier.price)
-			: shippingRate.price;
-
-		// Handle freeAbove: if cart total is above the freeAbove threshold, shipping is free
-		if (
-			shippingRate.freeAbove &&
-			shippingRate.freeAbove.currencyCode ===
-				resource.totalPrice.currencyCode &&
-			resource.totalPrice.centAmount >= shippingRate.freeAbove.centAmount
-		) {
-			shippingPrice = {
-				...shippingPrice,
-				centAmount: 0,
-			};
-		}
-
-		// Calculate tax amounts
-		const totalGross: CentPrecisionMoney = taxRate.includedInPrice
-			? shippingPrice
-			: {
-					...shippingPrice,
-					centAmount: roundDecimal(
-						new Decimal(shippingPrice.centAmount).mul(1 + taxRate.amount),
-						resource.taxRoundingMode,
-					).toNumber(),
-				};
-
-		const totalNet: CentPrecisionMoney = taxRate.includedInPrice
-			? {
-					...shippingPrice,
-					centAmount: roundDecimal(
-						new Decimal(shippingPrice.centAmount).div(1 + taxRate.amount),
-						resource.taxRoundingMode,
-					).toNumber(),
-				}
-			: shippingPrice;
-
-		const taxPortions: TaxPortion[] = [
-			{
-				name: taxRate.name,
-				rate: taxRate.amount,
-				amount: {
-					...shippingPrice,
-					centAmount: totalGross.centAmount - totalNet.centAmount,
-				},
-			},
-		];
-
-		const totalTax: CentPrecisionMoney = {
-			...shippingPrice,
-			centAmount: taxPortions.reduce(
-				(acc, portion) => acc + portion.amount.centAmount,
-				0,
-			),
-		};
-
-		const taxedPrice: TaxedItemPrice = {
-			totalNet,
-			totalGross,
-			taxPortions,
-			totalTax,
-		};
-
-		return {
-			shippingMethod: {
-				typeId: "shipping-method" as const,
-				id: method.id,
-			},
-			shippingMethodName: method.name,
-			price: shippingPrice,
-			shippingRate,
-			taxedPrice,
-			taxRate,
-			taxCategory: method.taxCategory,
-			shippingMethodState: "MatchesCart",
-		};
 	}
 }

package/src/repositories/order/index.test.ts

@@ -2,6 +2,7 @@ import { beforeEach } from "node:test";
 import type {
 	Cart,
 	LineItem,
+	Order,
 	OrderImportDraft,
 } from "@commercetools/platform-sdk";
 import { describe, expect, test } from "vitest";
@@ -187,6 +188,108 @@ describe("Order repository", () => {
 		expect(result.taxRoundingMode).toEqual(cart.taxRoundingMode);
 		expect(result.totalPrice).toEqual(cart.totalPrice);
 		expect(result.store).toEqual(cart.store);
+		// Test that shippingInfo is copied from cart to order
+		expect(result.shippingInfo).toEqual(cart.shippingInfo);
+	});
+
+	test("should calculate taxed price when creating order from cart", () => {
+		const cart: Cart = {
+			...getBaseResourceProperties(),
+			id: "cart-with-taxed-items",
+			version: 1,
+			cartState: "Active",
+			lineItems: [
+				{
+					id: "li-1",
+					productId: "product-1",
+					variantId: 1,
+					quantity: 1,
+					name: { en: "Test" },
+					variant: {
+						id: 1,
+						sku: "TEST",
+					},
+					price: {
+						value: {
+							type: "centPrecision",
+							currencyCode: "EUR",
+							centAmount: 1000,
+							fractionDigits: 2,
+						},
+					},
+					totalPrice: {
+						type: "centPrecision",
+						currencyCode: "EUR",
+						centAmount: 1000,
+						fractionDigits: 2,
+					},
+					taxedPrice: {
+						totalNet: {
+							type: "centPrecision",
+							currencyCode: "EUR",
+							centAmount: 1000,
+							fractionDigits: 2,
+						},
+						totalGross: {
+							type: "centPrecision",
+							currencyCode: "EUR",
+							centAmount: 1210,
+							fractionDigits: 2,
+						},
+						taxPortions: [
+							{
+								rate: 0.21,
+								amount: {
+									type: "centPrecision",
+									currencyCode: "EUR",
+									centAmount: 210,
+									fractionDigits: 2,
+								},
+							},
+						],
+						totalTax: {
+							type: "centPrecision",
+							currencyCode: "EUR",
+							centAmount: 210,
+							fractionDigits: 2,
+						},
+					},
+				} as unknown as LineItem,
+			],
+			customLineItems: [],
+			totalPrice: {
+				type: "centPrecision",
+				currencyCode: "EUR",
+				centAmount: 1000,
+				fractionDigits: 2,
+			},
+			priceRoundingMode: "HalfEven",
+			refusedGifts: [],
+			shippingMode: "Single",
+			shipping: [],
+			shippingAddress: { country: "NL" },
+			taxMode: "Platform",
+			taxRoundingMode: "HalfEven",
+			taxCalculationMode: "LineItemLevel",
+			origin: "Customer",
+			itemShippingAddresses: [],
+			directDiscounts: [],
+			discountCodes: [],
+			discountOnTotalPrice: undefined,
+			inventoryMode: "None",
+		};
+
+		storage.add("dummy", "cart", cart);
+		const ctx = { projectKey: "dummy" };
+		const result = repository.create(ctx, {
+			cart: { id: cart.id, typeId: "cart" },
+			version: cart.version,
+		});
+
+		expect(result.taxedPrice).toBeDefined();
+		expect(result.taxedPrice?.totalNet.centAmount).toBe(1000);
+		expect(result.taxedPrice?.totalGross.centAmount).toBe(1210);
+		expect(result.taxedPrice?.totalTax?.centAmount).toBe(210);
 	});
 
 	test("create order in store", async () => {
@@ -271,6 +374,89 @@ describe("Order repository", () => {
 		expect(result.paymentState).toBe("Paid");
 	});
 
+	test("should calculate taxed price when importing order", () => {
+		storage.add("dummy", "product", {
+			...getBaseResourceProperties(),
+			id: "product-import",
+			productType: {
+				typeId: "product-type",
+				id: "product-type-id",
+			},
+			masterData: {
+				current: {
+					name: { en: "Imported" },
+					slug: { en: "imported" },
+					categories: [],
+					masterVariant: {
+						id: 1,
+						sku: "IMPORT-SKU",
+						prices: [],
+						attributes: [],
+					},
+					variants: [],
+					searchKeywords: {},
+					attributes: [],
+				},
+				staged: {
+					name: { en: "Imported" },
+					slug: { en: "imported" },
+					categories: [],
+					masterVariant: {
+						id: 1,
+						sku: "IMPORT-SKU",
+						prices: [],
+						attributes: [],
+					},
+					variants: [],
+					searchKeywords: {},
+					attributes: [],
+				},
+				published: false,
+				hasStagedChanges: false,
+			},
+		});
+
+		const draft: OrderImportDraft = {
+			orderNumber: "IMPORT-ORDER-1",
+			totalPrice: {
+				centAmount: 1000,
+				currencyCode: "EUR",
+			},
+			lineItems: [
+				{
+					name: { en: "Imported" },
+					variant: {
+						sku: "IMPORT-SKU",
+					},
+					price: {
+						value: {
+							type: "centPrecision",
+							currencyCode: "EUR",
+							centAmount: 1000,
+							fractionDigits: 2,
+						},
+					},
+					quantity: 1,
+					taxRate: {
+						name: "Standard VAT",
+						amount: 0.21,
+						includedInPrice: false,
+						country: "NL",
+						id: "import-tax-rate",
+						subRates: [],
+					},
+				},
+			],
+			customLineItems: [],
+		};
+
+		const result = repository.import({ projectKey: "dummy" }, draft);
+		expect(result.taxedPrice).toBeDefined();
+		expect(result.taxedPrice?.totalNet.centAmount).toBe(1000);
+		expect(result.taxedPrice?.totalGross.centAmount).toBe(1210);
+		expect(result.taxedPrice?.totalTax?.centAmount).toBe(210);
+	});
+
 	test("import exiting product", async () => {
 		storage.add("dummy", "product", {
 			id: "15fc56ba-a74e-4cf8-b4b0-bada5c101541",
@@ -510,4 +696,308 @@ describe("Order repository", () => {
 	repository.import('dummy', draft)
   })
   */
+
+	describe("shippingInfo functionality", () => {
+		test("createShippingInfo creates basic shipping info", () => {
+			// Create a zone for Netherlands
+			const zone = {
+				...getBaseResourceProperties(),
+				id: "zone-nl",
+				name: "Netherlands Zone",
+				locations: [
+					{
+						country: "NL",
+					},
+				],
+			};
+
+			// Create a shipping method first
+			const shippingMethod = {
+				...getBaseResourceProperties(),
+				id: "shipping-method-123",
+				name: "Express Shipping",
+				active: true,
+				isDefault: false,
+				taxCategory: {
+					typeId: "tax-category" as const,
+					id: "tax-category-123",
+				},
+				zoneRates: [
+					{
+						zone: {
+							typeId: "zone" as const,
+							id: "zone-nl",
+							obj: zone,
+						},
+						shippingRates: [
+							{
+								price: {
+									type: "centPrecision" as const,
+									currencyCode: "EUR",
+									centAmount: 500,
+									fractionDigits: 2,
+								},
+								tiers: [],
+							},
+						],
+					},
+				],
+			};
+
+			const taxCategory = {
+				...getBaseResourceProperties(),
+				id: "tax-category-123",
+				name: "Standard Tax",
+				rates: [
+					{
+						name: "Standard VAT",
+						amount: 0.21,
+						country: "NL",
+						includedInPrice: true,
+					},
+				],
+			};
+
+			storage.add("dummy", "zone", zone);
+			storage.add("dummy", "shipping-method", shippingMethod);
+			storage.add("dummy", "tax-category", taxCategory);
+
+			const order: Order = {
+				...getBaseResourceProperties(),
+				orderNumber: "order-123",
+				orderState: "Open",
+				origin: "Customer",
+				customLineItems: [],
+				lineItems: [],
+				totalPrice: {
+					type: "centPrecision",
+					currencyCode: "EUR",
+					centAmount: 1000,
+					fractionDigits: 2,
+				},
+				lastMessageSequenceNumber: 0,
+				refusedGifts: [],
+				shipping: [],
+				shippingMode: "Single",
+				shippingAddress: {
+					id: "address-123",
+					country: "NL",
+					firstName: "John",
+					lastName: "Doe",
+					streetName: "Main Street",
+					streetNumber: "123",
+					postalCode: "1234AB",
+					city: "Amsterdam",
+				},
+				syncInfo: [],
+				taxCalculationMode: "UnitPriceLevel",
+				taxMode: "Platform",
+				taxRoundingMode: "HalfEven",
+			};
+
+			const ctx = { projectKey: "dummy" };
+			const result = repository.createShippingInfo(ctx, order, {
+				typeId: "shipping-method",
+				id: "shipping-method-123",
+			});
+
+			expect(result).toBeDefined();
+			expect(result.shippingMethod?.id).toBe("shipping-method-123");
+			expect(result.shippingMethodName).toBe("Express Shipping");
+			expect(result.price.currencyCode).toBe("EUR");
+			expect(result.price.centAmount).toBe(500);
+			expect(result.shippingMethodState).toBe("MatchesCart");
+			expect(result.deliveries).toEqual([]);
+			expect(result.taxCategory?.id).toBe("tax-category-123");
+		});
+
+		test("import order with shippingInfo", () => {
+			// Create required resources
+			const zone = {
+				...getBaseResourceProperties(),
+				id: "zone-de",
+				name: "Germany Zone",
+				locations: [
+					{
+						country: "DE",
+					},
+				],
+			};
+
+			const shippingMethod = {
+				...getBaseResourceProperties(),
+				id: "shipping-method-456",
+				name: "Standard Shipping",
+				active: true,
+				isDefault: false,
+				taxCategory: {
+					typeId: "tax-category" as const,
+					id: "tax-category-456",
+				},
+				zoneRates: [
+					{
+						zone: {
+							typeId: "zone" as const,
+							id: "zone-de",
+							obj: zone,
+						},
+						shippingRates: [
+							{
+								price: {
+									type: "centPrecision" as const,
+									currencyCode: "EUR",
+									centAmount: 500,
+									fractionDigits: 2,
+								},
+								tiers: [],
+							},
+						],
+					},
+				],
+			};
+
+			const taxCategory = {
+				...getBaseResourceProperties(),
+				id: "tax-category-456",
+				name: "Standard Tax",
+				rates: [
+					{
+						name: "Standard VAT",
+						amount: 0.19,
+						country: "DE",
+						includedInPrice: true,
+					},
+				],
+			};
+
+			storage.add("dummy", "zone", zone);
+			storage.add("dummy", "shipping-method", shippingMethod);
+			storage.add("dummy", "tax-category", taxCategory);
+
+			const draft: OrderImportDraft = {
+				orderNumber: "imported-order-123",
+				totalPrice: {
+					currencyCode: "EUR",
+					centAmount: 2000,
+				},
+				shippingAddress: {
+					country: "DE",
+					firstName: "Max",
+					lastName: "Mustermann",
+					streetName: "Hauptstraße",
+					streetNumber: "1",
+					postalCode: "10115",
+					city: "Berlin",
+				},
+				shippingInfo: {
+					shippingMethodName: "Standard Shipping",
+					price: {
+						currencyCode: "EUR",
+						centAmount: 500,
+					},
+					shippingRate: {
+						price: {
+							currencyCode: "EUR",
+							centAmount: 500,
+						},
+						tiers: [],
+					},
+					shippingMethod: {
+						typeId: "shipping-method",
+						id: "shipping-method-456",
+					},
+					taxCategory: {
+						typeId: "tax-category",
+						id: "tax-category-456",
+					},
+					taxRate: {
+						name: "Standard VAT",
+						amount: 0.19,
+						country: "DE",
+						includedInPrice: true,
+					},
+					shippingMethodState: "MatchesCart",
+					deliveries: [
+						{
+							key: "delivery-1",
+							items: [],
+							parcels: [
+								{
+									key: "parcel-1",
+									measurements: {
+										heightInMillimeter: 100,
+										lengthInMillimeter: 200,
+										widthInMillimeter: 150,
+										weightInGram: 500,
+									},
+									items: [],
+								},
+							],
+						},
+					],
+				},
+			};
+
+			const ctx = { projectKey: "dummy" };
+			const result = repository.import(ctx, draft);
+
+			expect(result.shippingInfo).toBeDefined();
+			expect(result.shippingInfo?.shippingMethodName).toBe("Standard Shipping");
+			expect(result.shippingInfo?.price.centAmount).toBe(500);
+			expect(result.shippingInfo?.shippingMethod?.id).toBe(
+				"shipping-method-456",
+			);
+			expect(result.shippingInfo?.taxCategory?.id).toBe("tax-category-456");
+			expect(result.shippingInfo?.taxRate?.amount).toBe(0.19);
+			// Note: deliveries from import drafts are not currently supported in native implementation
+			expect(result.shippingInfo?.deliveries).toEqual([]);
+		});
+
+		test("createShippingInfo throws error for non-existent shipping method", () => {
+			const order: Order = {
+				...getBaseResourceProperties(),
+				orderNumber: "order-456",
+				orderState: "Open",
+				origin: "Customer",
+				customLineItems: [],
+				lineItems: [],
+				totalPrice: {
+					type: "centPrecision",
+					currencyCode: "USD",
+					centAmount: 1500,
+					fractionDigits: 2,
+				},
+				lastMessageSequenceNumber: 0,
+				refusedGifts: [],
+				shipping: [],
+				shippingMode: "Single",
+				shippingAddress: {
+					id: "address-456",
+					country: "US",
+					firstName: "Jane",
+					lastName: "Smith",
+					streetName: "Broadway",
+					streetNumber: "456",
+					postalCode: "10001",
+					city: "New York",
+					state: "NY",
+				},
+				syncInfo: [],
+				taxCalculationMode: "UnitPriceLevel",
+				taxMode: "Platform",
+				taxRoundingMode: "HalfEven",
+			};
+
+			const ctx = { projectKey: "dummy" };
+
+			expect(() => {
+				repository.createShippingInfo(ctx, order, {
+					typeId: "shipping-method",
+					id: "non-existent-shipping-method",
+				});
+			}).toThrow(
+				/The shipping method with ID 'non-existent-shipping-method' is not allowed/,
+			);
+		});
+	});
 });