/** * Order lifecycle gaps: coupon-usage rollback, first-order-only poisoning, * refund rows, cancel error swallowing and the (missing) status transition * guards. * * Known bugs are pinned — see tests/BUGS.md. */ import { apiClient, captureError, uniqueSuffix } from '../helpers/api' import { createFutureSlot, createStoreWithSku, registerUserWithAddress, } from '../helpers/fixtures' import { staffSession } from '../helpers/sessions' const couponCode = () => `LC${uniqueSuffix()}`.toUpperCase().replace(/[^A-Z0-9]/g, '').slice(0, 20) describe('order lifecycle gaps', () => { let admin: ReturnType let userToken = '' let addressId = 0 let skuId = 0 let slotId = 0 beforeAll(async () => { const staff = await staffSession() admin = apiClient(staff.token) const store = await createStoreWithSku({ price: 100 }) const slot = await createFutureSlot([store.skuId]) const buyer = await registerUserWithAddress() userToken = buyer.token addressId = buyer.addressId skuId = store.skuId slotId = slot.slotId }) const place = (couponId?: number) => apiClient(userToken).user.order.placeOrder.mutate({ selectedItems: [{ skuId, quantity: 1, slotId }], addressId, paymentMethod: 'cod', ...(couponId ? { couponId } : {}), }) const cancel = (id: number, reason = 'lifecycle test') => apiClient(userToken).user.order.cancelOrder.mutate({ id, reason }) const createCoupon = async (over: Record = {}) => { const created = await admin.admin.coupon.create.mutate({ couponCode: couponCode(), minOrder: 1, isApplyForAll: true, validTill: new Date(Date.now() + 24 * 3600_000).toISOString(), ...over, }) return created[0] } it('pins: cancelling an order does not release its coupon usage', async () => { const coupon = await createCoupon({ flatDiscount: 5, maxLimitForUser: 1 }) const placed = await place(coupon.id) await cancel(placed.data[0].id) // The usage row recorded at placement is not removed on cancel, so the // (now unused) coupon is already exhausted for this user. const error = await captureError(() => place(coupon.id)) expect(error.message).toMatch(/usage limit/i) }) it('pins: a cancelled first order poisons an isFirstOrderOnly coupon', async () => { const buyer = await registerUserWithAddress() const coupon = await createCoupon({ flatDiscount: 5, isFirstOrderOnly: true }) // First order, then immediately cancelled. const first = await apiClient(buyer.token).user.order.placeOrder.mutate({ selectedItems: [{ skuId, quantity: 1, slotId }], addressId: buyer.addressId, paymentMethod: 'cod', }) await apiClient(buyer.token).user.order.cancelOrder.mutate({ id: first.data[0].id, reason: 'changed mind', }) // getOrderCount counts cancelled orders too, so the coupon is now refused. const error = await captureError(() => apiClient(buyer.token).user.order.placeOrder.mutate({ selectedItems: [{ skuId, quantity: 1, slotId }], addressId: buyer.addressId, paymentMethod: 'cod', couponId: coupon.id, }) ) expect(error.message).toMatch(/first order only/i) }) it('applies an isFirstOrderOnly coupon to a genuinely new user', async () => { const buyer = await registerUserWithAddress() const coupon = await createCoupon({ flatDiscount: 5, isFirstOrderOnly: true }) const res = await apiClient(buyer.token).user.order.placeOrder.mutate({ selectedItems: [{ skuId, quantity: 1, slotId }], addressId: buyer.addressId, paymentMethod: 'cod', couponId: coupon.id, }) expect(res.success).toBe(true) }) it('writes a refund row for a cancelled COD order', async () => { const placed = await place() const orderId = placed.data[0].id await cancel(orderId) const detail = await apiClient(userToken).user.order.getOrderById.query({ orderId: String(orderId), }) // COD cancellations record refundStatus 'na'. expect(detail.refundStatus).toBe('na') }) it('pins: cancelling an already-cancelled order reports a generic message', async () => { const placed = await place() const orderId = placed.data[0].id await cancel(orderId) const error = await captureError(() => cancel(orderId)) // The specific "already cancelled" 400 is masked by cancelOrder's catch. expect(error.message).toMatch(/failed to cancel order/i) }) it('propagates the specific notes guard for a cancelled order', async () => { const placed = await place() const orderId = placed.data[0].id await cancel(orderId) const error = await captureError(() => apiClient(userToken).user.order.updateUserNotes.mutate({ id: orderId, userNotes: 'too late', }) ) // updateUserNotes has no catch, so the real message survives. expect(error.message).toMatch(/cannot update notes for cancelled order/i) }) it('pins: a cancelled order can still be marked delivered (no transition guard)', async () => { const placed = await place() const orderId = placed.data[0].id await cancel(orderId) const res = await admin.admin.order.updateDelivered.mutate({ orderId: String(orderId), isDelivered: true, }) expect(res.success).toBe(true) }) it('pins: delivered is reversible', async () => { const placed = await place() const orderId = placed.data[0].id await admin.admin.order.updateDelivered.mutate({ orderId: String(orderId), isDelivered: true }) const res = await admin.admin.order.updateDelivered.mutate({ orderId: String(orderId), isDelivered: false, }) expect(res.success).toBe(true) }) it('rejects a user cancellation of a delivered order', async () => { const placed = await place() const orderId = placed.data[0].id await admin.admin.order.updateDelivered.mutate({ orderId: String(orderId), isDelivered: true }) const error = await captureError(() => cancel(orderId)) expect(error.message).toMatch(/failed to cancel order/i) }) })