[patch] Add support for endpoint for listing customer's redeemables

.changeset/hungry-roses-cross.md

@@ -0,0 +1,5 @@
+---
+'@voucherify/sdk': patch
+---
+
+New endpoint support - `customer-redeemable`

packages/sdk/README.md

@@ -654,6 +654,7 @@ Methods are provided within `client.customers.*` namespace.
 - [Update Customers in bulk](#update-customers-in-bulk)
 - [Update Customers' Metadata in bulk](#update-customers-metadata-in-bulk)
 - [Import and Update Customers using CSV](#import-and-update-customers-using-csv)
+- [List Redeemables](#list-redeemables)
 
 #### [Create Customer](https://docs.voucherify.io/reference/create-customer)
 
@@ -759,6 +760,12 @@ client.customers.updateInBulk(customers)
 client.customers.updateMetadataInBulk(sourceIdsAndMetadata)
 ```
 
+#### [List Redeemables](https://docs.voucherify.io/reference/list-customer-redeemables)
+
+```javascript
+client.customers.listRedeemables(id, params)
+```
+
 ---
 
 ### Consents

packages/sdk/src/Customers.ts

@@ -131,6 +131,13 @@ class Customers {
 
 		return this.client.post<AAT.AsyncActionCreateResponse>(`/customers/importCSV`, form, undefined, headers)
 	}
+
+	/**
+	 * @see https://docs.voucherify.io/reference/list-customer-redeemables
+	 */
+	public listRedeemables(id: string, params?: T.CustomerRedeemablesListQueryParams) {
+		return this.client.get<T.CustomerRedeemablesListResponse>(`/customers/${encode(id)}/redeemables`, params)
+	}
 }
 
 export { Customers }

packages/sdk/src/types/Customers.ts

@@ -1,4 +1,6 @@
 // Legacy code
+import { DiscountUnit, DiscountAmount, DiscountPercent, DiscountFixed } from './DiscountVoucher'
+
 export interface SimpleCustomer {
 	id: string
 	name?: string
@@ -121,6 +123,95 @@ export interface CustomerActivitiesListResponse {
 	data: Record<string, any>[]
 }
 
+export interface CustomerRedeemablesListQueryParams {
+	limit?: number
+	order?: 'created_at' | '-created_at' | 'id' | '-id'
+	starting_after_id?: string
+	filters?: Record<string, any>
+}
+
+export interface CustomerRedeemablesListResponse {
+	object: 'list'
+	total: number
+	data_ref: 'data'
+	data: CustomerRedeemable[]
+	has_more: boolean
+	more_starting_after?: string
+}
+
+export interface CustomerRedeemable {
+	id: string
+	created_at: string
+	redeemable_id: string
+	redeemable_object: string
+	customer_id: string
+	holder_role: 'OWNER' | 'REFERRER' | 'REFEREE'
+	campaign_id: string
+	campaign_type: 'LOYALTY_PROGRAM' | 'PROMOTION' | 'DISCOUNT_COUPONS' | 'GIFT_VOUCHERS' | 'REFERRAL_PROGRAM'
+	voucher_type: 'GIFT_VOUCHER' | 'DISCOUNT_VOUCHER' | 'LOYALTY_CARD'
+	redeemable: RedeemableContainer
+}
+
+export interface RedeemableContainerVoucher {
+	id: string
+	code: string
+	campaign?: string
+	camapign_id?: string
+	category_id?: string
+	type: 'GIFT_VOUCHER' | 'DISCOUNT_VOUCHER' | 'LOYALTY_CARD'
+	discount?: DiscountAmount | DiscountPercent | DiscountUnit | DiscountFixed
+	gift?: {
+		amount: number
+		balance: number
+	}
+	loyalty_card?: {
+		points: number
+		balance: number
+	}
+	start_date?: string
+	expiration_date?: string
+	validity_timeframe?: {
+		interval: string
+		duration: string
+	}
+	validity_day_of_week?: number[]
+	publish?: {
+		object: 'list'
+		count: number
+		url: string
+	}
+	redemption?: {
+		object: 'list'
+		quantity?: number
+		redeemed_quantity: number
+		url: string
+	}
+	active: boolean
+	additional_info?: string
+	metadata?: Record<string, any>
+	assets: {
+		qr: {
+			id: string
+			url: string
+		}
+		barcode: {
+			id: string
+			url: string
+		}
+	}
+	is_referral_code: boolean
+	holder_id?: string
+	updated_at?: string
+	created_at: string
+	object: 'voucher'
+}
+
+export interface RedeemableContainer {
+	type: 'voucher'
+	voucher?: RedeemableContainerVoucher
+	status: 'ACTIVE' | 'USED' | 'DISABLED' | 'NOT_ACTIVE' | 'EXPIRED' | 'NO_BALANCE'
+}
+
 export type CustomersCreateBody = CustomerRequest
 export type CustomersCreateResponse = CustomerObject | CustomerUnconfirmed
 

packages/sdk/test/customers.spec.ts

@@ -1,6 +1,7 @@
 import { voucherifyClient as client } from './client'
 import { generateRandomString } from './utils/generateRandomString'
 import { generateCustomerCSV } from './utils/generateCustomerCSV'
+import { CustomerRequest, DiscountVouchersTypesEnum, DistributionsPublicationsCreateParams } from '@voucherify/sdk'
 
 jest.setTimeout(15000)
 
@@ -173,4 +174,34 @@ describe('Customers API', () => {
 		}
 		expect(updatedCustomerWithNoAddress.address).toEqual(removedAddress)
 	})
+
+	it('Should return redeemable for customer', async () => {
+		const createdCustomer: CustomerRequest = await client.customers.create({ source_id: generateRandomString() })
+
+		const discountCampaign = await client.campaigns.create({
+			campaign_type: 'DISCOUNT_COUPONS',
+			name: generateRandomString(),
+			type: 'AUTO_UPDATE',
+			voucher: {
+				code_config: {
+					length: 3,
+				},
+				type: 'DISCOUNT_VOUCHER',
+				discount: {
+					amount_off: 0,
+					type: DiscountVouchersTypesEnum.AMOUNT,
+				},
+			},
+		})
+
+		const distributionsPublicationsCreateParams: DistributionsPublicationsCreateParams = {
+			customer: createdCustomer,
+			campaign: discountCampaign,
+		}
+
+		await client.distributions.publications.create(distributionsPublicationsCreateParams)
+
+		const redeemables = await client.customers.listRedeemables(createdCustomer.id as string)
+		expect(redeemables.data).toBeDefined()
+	})
 })