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
Add Cart API endpoint with spec and default line_items include
Damian Legawiec60f5e369023c
diff --git a/api/app/controllers/spree/api/v3/store/cart_controller.rb b/api/app/controllers/spree/api/v3/store/cart_controller.rbindex 2641a8e5d3..32f4f92775 100644--- a/api/app/controllers/spree/api/v3/store/cart_controller.rb+++ b/api/app/controllers/spree/api/v3/store/cart_controller.rb@@ -12,7 +12,7 @@ module Spreeif @cart.nil?render_error(- code: ERROR_CODES[:not_found],+ code: ERROR_CODES[:record_not_found],message: 'No cart found. Create one with POST /orders',status: :not_found)@@ -56,6 +56,12 @@ module Spreeresult[:token] = resource.token if resource.token.present?resultend++ # Cart always includes line_items by default+ def include_list+ base = super+ base.include?('line_items') ? base : base + ['line_items']+ endendendenddiff --git a/api/spec/controllers/spree/api/v3/store/cart_controller_spec.rb b/api/spec/controllers/spree/api/v3/store/cart_controller_spec.rbnew file mode 100644index 0000000000..3cc49771aa--- /dev/null+++ b/api/spec/controllers/spree/api/v3/store/cart_controller_spec.rb@@ -0,0 +1,168 @@+require 'spec_helper'++RSpec.describe Spree::Api::V3::Store::CartController, type: :controller do+ render_views++ include_context 'API v3 Store'++ before do+ request.headers['X-Spree-Api-Key'] = api_key.token+ end++ describe 'GET #show' do+ context 'with order_token parameter' do+ let(:cart) { create(:order_with_line_items, store: store) }++ it 'returns the cart' do+ get :show, params: { order_token: cart.token }++ expect(response).to have_http_status(:ok)+ expect(json_response['number']).to eq(cart.number)+ expect(json_response['state']).to eq('cart')+ end++ it 'returns cart with line items' do+ get :show, params: { order_token: cart.token }++ expect(json_response['line_items']).to be_present+ expect(json_response['line_items'].size).to eq(cart.line_items.count)+ end++ it 'returns cart token in response' do+ get :show, params: { order_token: cart.token }++ expect(json_response['token']).to eq(cart.token)+ end++ it 'returns not found for invalid token' do+ get :show, params: { order_token: 'invalid_token' }++ expect(response).to have_http_status(:not_found)+ expect(json_response['error']['code']).to eq('record_not_found')+ end++ it 'returns not found for completed order token' do+ completed_order = create(:completed_order_with_totals, store: store)+ get :show, params: { order_token: completed_order.token }++ expect(response).to have_http_status(:not_found)+ expect(json_response['error']['code']).to eq('record_not_found')+ end++ it 'returns not found for other store cart' do+ other_store = create(:store)+ other_cart = create(:order_with_line_items, store: other_store)+ get :show, params: { order_token: other_cart.token }++ expect(response).to have_http_status(:not_found)+ end+ end++ context 'with JWT authentication' do+ before do+ request.headers['Authorization'] = "Bearer #{jwt_token}"+ end++ let!(:cart) { create(:order_with_line_items, user: user, store: store) }++ it 'returns the users cart' do+ get :show++ expect(response).to have_http_status(:ok)+ expect(json_response['number']).to eq(cart.number)+ end++ it 'returns the most recent cart when user has multiple' do+ # The let! cart was created first, so create a newer one+ cart # trigger let!+ newer_cart = nil++ # Create in a Timecop block to ensure proper timestamps+ Timecop.travel(1.hour.from_now) do+ newer_cart = create(:order_with_line_items, user: user, store: store)+ end++ get :show++ expect(response).to have_http_status(:ok)+ expect(json_response['number']).to eq(newer_cart.number)+ end++ it 'returns not found when user has no cart' do+ cart.update!(state: 'complete', completed_at: Time.current)++ get :show++ expect(response).to have_http_status(:not_found)+ expect(json_response['error']['code']).to eq('record_not_found')+ end++ it 'does not return other users cart' do+ other_user_cart = create(:order_with_line_items, store: store)+ cart.update!(state: 'complete', completed_at: Time.current)++ get :show++ expect(response).to have_http_status(:not_found)+ end+ end++ context 'without authentication' do+ it 'returns not found without order_token or JWT' do+ get :show++ expect(response).to have_http_status(:not_found)+ expect(json_response['error']['code']).to eq('record_not_found')+ expect(json_response['error']['message']).to include('No cart found')+ end+ end++ context 'without API key' do+ before { request.headers['X-Spree-Api-Key'] = nil }++ it 'returns unauthorized' do+ get :show++ expect(response).to have_http_status(:unauthorized)+ expect(json_response['error']['code']).to eq('invalid_token')+ end+ end++ context 'response structure' do+ let(:cart) { create(:order_with_line_items, store: store) }++ it 'returns expected cart attributes' do+ get :show, params: { order_token: cart.token }++ expect(json_response).to include(+ 'id',+ 'number',+ 'state',+ 'token',+ 'currency',+ 'item_count',+ 'item_total',+ 'display_item_total',+ 'total',+ 'display_total'+ )+ end++ it 'returns line item attributes' do+ get :show, params: { order_token: cart.token }++ line_item = json_response['line_items'].first+ expect(line_item).to include(+ 'id',+ 'variant_id',+ 'quantity',+ 'name',+ 'price',+ 'display_price',+ 'total',+ 'display_total'+ )+ end+ end+ end+end