Open Source Platform for DTC, B2B Commerce, Marketplaces & Omnichannel. REST APIs, TypeScript SDKs, and production-ready Next.js storefront. Self-host it. Own your data. No vendor lock-in. Zero platform fees.
Ruby b2b-commercee-commerceecommerceecommerce-apiecommerce-frameworkecommerce-platformheadlessheadless-commerceheadless-ecommercemarketplacemulti-tenantmulti-vendormulti-vendor-ecommerceopen-sourcespree-commerce
import { HttpResponse, http } from 'msw'
import { beforeAll, describe, expect, it } from 'vitest'
import type { Client } from '../src'
import { isOrderGroup } from '../src'
import { createTestClient, TEST_BASE_URL } from './helpers'
import { fixtures } from './mocks/handlers'
import { server } from './mocks/server'
const API_PREFIX = `${TEST_BASE_URL}/api/v3/store`
describe('carts', () => {
let client: Client
beforeAll(() => {
client = createTestClient()
})
const opts = { token: 'user-jwt' }
describe('list', () => {
it('lists all active carts for authenticated user', async () => {
const result = await client.carts.list({ token: 'user-jwt' })
expect(result.data).toHaveLength(1)
expect(result.data[0].id).toBe('cart_1')
expect(result.meta.count).toBe(1)
})
})
describe('get', () => {
it('returns a cart by ID', async () => {
const result = await client.carts.get('cart_1', opts)
expect(result.id).toBe('cart_1')
expect(result.token).toBeDefined()
expect(result.state).toBeDefined()
expect(result.checkout_steps).toBeDefined()
})
it('works with spreeToken for guest checkout', async () => {
const result = await client.carts.get('cart_1', { spreeToken: 'guest-token' })
expect(result).toBeDefined()
})
})
describe('create', () => {
it('creates a new cart', async () => {
const result = await client.carts.create()
expect(result.token).toBe('new-cart-token')
})
})
describe('update', () => {
it('updates cart info', async () => {
const result = await client.carts.update('cart_1', { email: '[email protected]' }, opts)
expect(result.id).toBe('cart_1')
})
})
describe('delete', () => {
it('deletes a cart by ID', async () => {
await expect(client.carts.delete('cart_1', opts)).resolves.toBeUndefined()
})
})
describe('associate', () => {
it('associates guest cart with authenticated user', async () => {
const result = await client.carts.associate('cart_1', {
token: 'user-jwt',
spreeToken: 'guest-token',
})
expect(result).toBeDefined()
})
})
// A cart holding several sellers' goods divides on completion, and the
// group it produced is what comes back.
describe('complete', () => {
it('answers with the order when the cart holds one seller', async () => {
const result = await client.carts.complete('cart_1', opts)
expect(isOrderGroup(result)).toBe(false)
expect(result.id).toBe('or_1')
expect(result.completed_at).toBeDefined()
})
it('answers with the group when the cart divided', async () => {
server.use(
http.post(`${API_PREFIX}/carts/cart_1/complete`, () =>
HttpResponse.json({
...fixtures.order,
id: 'ogrp_1',
orders: [
{ ...fixtures.order, id: 'or_1', number: 'R123456-1' },
{ ...fixtures.order, id: 'or_2', number: 'R123456-2' },
],
}),
),
)
const result = await client.carts.complete('cart_1', opts)
expect(isOrderGroup(result)).toBe(true)
if (!isOrderGroup(result)) throw new Error('expected a group')
expect(result.id).toBe('ogrp_1')
expect(result.orders.map((order) => order.id)).toEqual(['or_1', 'or_2'])
})
})
describe('items', () => {
it('adds an item to the cart', async () => {
const result = await client.carts.items.create(
'cart_1',
{ variant_id: 'var_1', quantity: 2 },
opts,
)
expect(result.id).toBe('cart_1')
})
it('updates a line item', async () => {
const result = await client.carts.items.update('cart_1', 'li_1', { quantity: 5 }, opts)
expect(result.id).toBe('cart_1')
})
it('removes a line item', async () => {
const result = await client.carts.items.delete('cart_1', 'li_1', opts)
expect(result.id).toBe('cart_1')
})
})
describe('discountCodes', () => {
it('applies a discount code', async () => {
const result = await client.carts.discountCodes.apply('cart_1', 'SAVE10', opts)
expect(result.id).toBe('cart_1')
})
it('removes a discount code by code string', async () => {
const result = await client.carts.discountCodes.remove('cart_1', 'SAVE10', opts)
expect(result.id).toBe('cart_1')
})
})
describe('giftCards', () => {
it('applies a gift card', async () => {
const result = await client.carts.giftCards.apply('cart_1', 'GC-ABCD-1234', opts)
expect(result.id).toBe('cart_1')
})
it('removes a gift card by prefixed ID', async () => {
const result = await client.carts.giftCards.remove('cart_1', 'gc_abc123', opts)
expect(result.id).toBe('cart_1')
})
})
describe('fulfillments', () => {
it('selects a delivery rate', async () => {
const result = await client.carts.fulfillments.update(
'cart_1',
'ful_1',
{ selected_delivery_rate_id: 'rate_1' },
opts,
)
expect(result.id).toBe('cart_1')
})
})
describe('storeCredits', () => {
it('applies store credit', async () => {
const result = await client.carts.storeCredits.apply('cart_1', '10.00', opts)
expect(result.id).toBe('cart_1')
})
it('still accepts a number until 6.1', async () => {
const result = await client.carts.storeCredits.apply('cart_1', 25, opts)
expect(result.id).toBe('cart_1')
})
it('removes store credit', async () => {
const result = await client.carts.storeCredits.remove('cart_1', opts)
expect(result.id).toBe('cart_1')
})
})
})