feat: change product price to prices array

BREAKING CHANGE: Products now use `prices` array instead of singular `price`.
This matches the pattern used by payment processors and allows for future
support of metered pricing alongside static prices.

- ProductSchema.price -> ProductSchema.prices (array)
- CheckoutProductSchema.price -> CheckoutProductSchema.prices (array)
- Updated all tests to use new schema structure
- Bump version to 0.1.15

Author: NatElkins

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moneydevkit/api-contract",
-  "version": "0.1.14",
+  "version": "0.1.15",
   "description": "API Contract for moneydevkit",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",

src/contracts/products.ts

@@ -9,12 +9,15 @@ export const ProductPriceSchema = z.object({
 	currency: CurrencySchema,
 });
 
+// Products have a prices array.
+// Currently only one static price (FIXED/CUSTOM/FREE) is supported.
+// Metered prices may be added in the future.
 export const ProductSchema = z.object({
 	id: z.string(),
 	name: z.string(),
 	description: z.string().nullable(),
 	recurringInterval: z.enum(["MONTH", "QUARTER", "YEAR"]).nullable(),
-	price: ProductPriceSchema.nullable(),
+	prices: z.array(ProductPriceSchema),
 });
 
 export const ListProductsOutputSchema = z.object({

src/schemas/product.ts

@@ -8,10 +8,12 @@ export const CheckoutProductPriceSchema = z.object({
 	currency: CurrencySchema,
 });
 
+// Checkout products have a prices array.
+// Currently only one static price (FIXED/CUSTOM/FREE) is supported.
 export const CheckoutProductSchema = z.object({
 	id: z.string(),
 	name: z.string(),
 	description: z.string().nullable(),
 	recurringInterval: z.enum(["MONTH", "QUARTER", "YEAR"]).nullable(),
-	price: CheckoutProductPriceSchema.nullable(),
+	prices: z.array(CheckoutProductPriceSchema),
 });

tests/index.test.ts

@@ -53,12 +53,12 @@ describe('API Contract Index', () => {
           name: 'Test Product',
           description: null,
           recurringInterval: null,
-          price: {
+          prices: [{
             id: 'price_123',
             amountType: 'FIXED' as const,
             priceAmount: 1000,
             currency: 'USD',
-          },
+          }],
         }],
         providedAmount: null,
         totalAmount: null,

tests/schemas/checkout.test.ts

@@ -39,12 +39,12 @@ const mockProduct = {
   name: 'Test Product',
   description: 'A test product',
   recurringInterval: null,
-  price: {
+  prices: [{
     id: 'price_123',
     amountType: 'FIXED' as const,
     priceAmount: 1000,
     currency: 'USD',
-  },
+  }],
 };
 
 const mockInvoice = {

tests/schemas/product.test.ts

@@ -16,7 +16,7 @@ const baseProductData = {
 	name: "Test Product",
 	description: null,
 	recurringInterval: null,
-	price: baseProductPriceData,
+	prices: [baseProductPriceData],
 };
 
 describe("Product Schemas", () => {
@@ -148,12 +148,14 @@ describe("Product Schemas", () => {
 		test("should validate product with a custom price", () => {
 			const productWithCustomPrice = {
 				...baseProductData,
-				price: {
-					...baseProductPriceData,
-					id: "price_2",
-					amountType: "CUSTOM" as const,
-					priceAmount: null,
-				},
+				prices: [
+					{
+						...baseProductPriceData,
+						id: "price_2",
+						amountType: "CUSTOM" as const,
+						priceAmount: null,
+					},
+				],
 			};
 
 			const result = CheckoutProductSchema.safeParse(productWithCustomPrice);
@@ -180,23 +182,23 @@ describe("Product Schemas", () => {
 			expect(result.success).toBe(false);
 		});
 
-		test("should reject product without price field", () => {
-			const productWithoutPrice = {
+		test("should reject product without prices field", () => {
+			const productWithoutPrices = {
 				...baseProductData,
-				price: undefined,
+				prices: undefined,
 			};
 
-			const result = CheckoutProductSchema.safeParse(productWithoutPrice);
+			const result = CheckoutProductSchema.safeParse(productWithoutPrices);
 			expect(result.success).toBe(false);
 		});
 
-		test("should allow product with null price", () => {
-			const productWithNullPrice = {
+		test("should validate product with empty prices array", () => {
+			const productWithEmptyPrices = {
 				...baseProductData,
-				price: null,
+				prices: [],
 			};
 
-			const result = CheckoutProductSchema.safeParse(productWithNullPrice);
+			const result = CheckoutProductSchema.safeParse(productWithEmptyPrices);
 			expect(result.success).toBe(true);
 		});
 
@@ -210,13 +212,15 @@ describe("Product Schemas", () => {
 			expect(result.success).toBe(false);
 		});
 
-		test("should reject product with invalid price object", () => {
+		test("should reject product with invalid price in prices array", () => {
 			const productWithInvalidPrice = {
 				...baseProductData,
-				price: {
-					...baseProductPriceData,
-					amountType: "INVALID_TYPE" as any,
-				},
+				prices: [
+					{
+						...baseProductPriceData,
+						amountType: "INVALID_TYPE" as any,
+					},
+				],
 			};
 
 			const result = CheckoutProductSchema.safeParse(productWithInvalidPrice);
@@ -250,32 +254,38 @@ describe("Product Schemas", () => {
 				{
 					...baseProductData,
 					id: "product_fixed",
-					price: {
-						...baseProductPriceData,
-						id: "price_fixed",
-						amountType: "FIXED" as const,
-						priceAmount: 2999,
-					},
+					prices: [
+						{
+							...baseProductPriceData,
+							id: "price_fixed",
+							amountType: "FIXED" as const,
+							priceAmount: 2999,
+						},
+					],
 				},
 				{
 					...baseProductData,
 					id: "product_custom",
-					price: {
-						...baseProductPriceData,
-						id: "price_custom",
-						amountType: "CUSTOM" as const,
-						priceAmount: null,
-					},
+					prices: [
+						{
+							...baseProductPriceData,
+							id: "price_custom",
+							amountType: "CUSTOM" as const,
+							priceAmount: null,
+						},
+					],
 				},
 				{
 					...baseProductData,
 					id: "product_free",
-					price: {
-						...baseProductPriceData,
-						id: "price_free",
-						amountType: "FREE" as const,
-						priceAmount: 0,
-					},
+					prices: [
+						{
+							...baseProductPriceData,
+							id: "price_free",
+							amountType: "FREE" as const,
+							priceAmount: 0,
+						},
+					],
 				},
 			];