Skip to content

Deep analysis of cart/Hive implementation (@explore subagent)

Field Value
Source opencode CLI/web
Session ses_292094abdffeOXDq1gHAMdFFHr
Started 2026-04-08 16:39
Messages 6
Parts 35 (text+patch+tool) · 5 reasoning · 16 tool calls
Model —
Directory /home/sambasene/Downloads/TStore-Firebase-main

Analyze the cart and Hive implementation in depth. Read and analyze:

  1. lib/features/shop/features/cart/cart_injection.dart - Cart dependency injection
  2. lib/features/shop/features/cart/data/datasources/cart_local_datasource.dart - Cart local datasource
  3. lib/features/shop/features/cart/data/models/cart_model.dart - Cart model
  4. lib/features/shop/features/cart/presentation/cubits/cart_cubit.dart - Cart cubit
  5. lib/core/hive_boxes/open_boxes.dart - Hive boxes setup

Explain how cart persistence works with Hive, the data flow, and caching strategy.

I’ll read all the specified files to analyze the cart and Hive implementation.

read — {"filePath": "/home/sambasene/Downloads/TStore-Firebase-main/lib/features/shop/features/cart/cart_injection.dart"}

<path>/home/sambasene/Downloads/TStore-Firebase-main/lib/features/shop/features/cart/cart_injection.dart</path>
<type>file</type>
<content>
1: import 'package:get_it/get_it.dart';
2: import 'package:t_store/features/shop/features/cart/data/repositories/cart_repository_impl.dart';
3: import 'package:t_store/features/shop/features/cart/data/source/cart_local_storage_services.dart';
4: import 'package:t_store/features/shop/features/cart/data/source/cart_mangment_service.dart';
5: import 'package:t_store/features/shop/features/cart/domain/repositories/cart_repository.dart';
6: import 'package:t_store/features/shop/features/cart/domain/usecases/add_item_to_cart_usecase.dart';
7: import 'package:t
…[truncated]

read — {"filePath": "/home/sambasene/Downloads/TStore-Firebase-main/lib/features/shop/features/cart/data/datasources/cart_local_datasource.dart"}

read — {"filePath": "/home/sambasene/Downloads/TStore-Firebase-main/lib/features/shop/features/cart/data/models/cart_model.dart"}

read — {"filePath": "/home/sambasene/Downloads/TStore-Firebase-main/lib/features/shop/features/cart/presentation/cubits/cart_cubit.dart"}

<path>/home/sambasene/Downloads/TStore-Firebase-main/lib/features/shop/features/cart/presentation/cubits/cart_cubit.dart</path>
<type>file</type>
<content>
1: import 'package:flutter_bloc/flutter_bloc.dart';
2: import 'package:t_store/features/shop/features/all_products/data/mapper/product_variation_mapper.dart';
3: import 'package:t_store/features/shop/features/all_products/domain/entity/product_entity.dart';
4: import 'package:t_store/features/shop/features/all_products/domain/entity/product_variation_entity.dart';
5: import 'package:t_store/features/shop/features/cart/domain/entities/cart_item_entity.dart';
6: import 'package:t_store/features/shop/features/cart/domain/entities/product_car
…[truncated]

read — {"filePath": "/home/sambasene/Downloads/TStore-Firebase-main/lib/core/hive_boxes/open_boxes.dart"}

<path>/home/sambasene/Downloads/TStore-Firebase-main/lib/core/hive_boxes/open_boxes.dart</path>
<type>file</type>
<content>
1: import 'package:firebase_auth/firebase_auth.dart';
2: import 'package:hive/hive.dart';
3:
4: class OpenBoxes {
5: Future<Box> openUserWishlistBox({required String userID}) async {
6: // Open the user's main box
7: Box userBox = await Hive.openBox(userID);
8:
9: if (!Hive.isBoxOpen(userID)) {
10: await Hive.openBox(userID);
11: }
12:
13: // Get or create the wishlist box name
14: String wishlistBoxName =
15: userBox.get('WISHLIST', defaultValue: 'wishlist_$userID');
16: await userBox.put('WISHLIST', wishlistBoxName);
17:
18: if (!Hive.isBoxOpen(wishlistBoxName)) {
…[truncated]

glob — {"path": "/home/sambasene/Downloads/TStore-Firebase-main", "pattern": "**/cart/**/*.dart"}

/home/sambasene/Downloads/TStore-Firebase-main/lib/features/shop/features/cart/domain/usecases/remove_item_from_cart_usecase.dart
/home/sambasene/Downloads/TStore-Firebase-main/lib/features/shop/features/cart/domain/usecases/fetch_cart_items_use_case.dart
/home/sambasene/Downloads/TStore-Firebase-main/lib/features/shop/features/cart/domain/usecases/clear_cart_use_case.dart
/home/sambasene/Downloads/TStore-Firebase-main/lib/features/shop/features/cart/domain/usecases/change_cart_item_quantity_usecase.dart
/home/sambasene/Downloads/TStore-Firebase-main/lib/features/shop/features/cart/domain/usecases/cart_usecases.dart
/home/sambasene/Downloads/TStore-Firebase-main/lib/features/shop/features/ca
…[truncated]

glob — {"path": "/home/sambasene/Downloads/TStore-Firebase-main", "pattern": "**/cart*.dart"}

/home/sambasene/Downloads/TStore-Firebase-main/lib/features/shop/features/cart/presentation/widgets/cart_items_section.dart
/home/sambasene/Downloads/TStore-Firebase-main/lib/features/shop/features/cart/presentation/widgets/cart_items_list.dart
/home/sambasene/Downloads/TStore-Firebase-main/lib/features/shop/features/cart/presentation/widgets/cart_item_card.dart
/home/sambasene/Downloads/TStore-Firebase-main/lib/features/shop/features/cart/presentation/widgets/cart_checkout_button.dart
/home/sambasene/Downloads/TStore-Firebase-main/lib/features/shop/features/cart/presentation/pages/cart_page.dart
/home/sambasene/Downloads/TStore-Firebase-main/lib/features/shop/features/cart/presentation/cubi
…[truncated]

read — {"filePath": "/home/sambasene/Downloads/TStore-Firebase-main/lib/features/shop/features/cart/data/source/cart_local_storage_services.dart"}

<path>/home/sambasene/Downloads/TStore-Firebase-main/lib/features/shop/features/cart/data/source/cart_local_storage_services.dart</path>
<type>file</type>
<content>
1: import 'package:firebase_auth/firebase_auth.dart';
2: import 'package:hive/hive.dart';
3: import 'package:t_store/features/shop/features/cart/data/models/cart_item_model.dart';
4:
5: abstract class CartLocalStorageServices {
6: void storeCartItems({required List<CartItemModel> cartItems});
7: Future<List<CartItemModel>> fetchCartItems();
8: }
9:
10: class CartLocalStorageServicesImpl implements CartLocalStorageServices {
11: static final String _userId = FirebaseAuth.instance.currentUser!.uid;
12: static final String _boxNam
…[truncated]

read — {"filePath": "/home/sambasene/Downloads/TStore-Firebase-main/lib/features/shop/features/cart/data/source/cart_mangment_service.dart"}

<path>/home/sambasene/Downloads/TStore-Firebase-main/lib/features/shop/features/cart/data/source/cart_mangment_service.dart</path>
<type>file</type>
<content>
1: import 'package:firebase_auth/firebase_auth.dart';
2: import 'package:hive/hive.dart';
3: import 'package:t_store/features/shop/features/cart/data/models/cart_item_model.dart';
4: import 'package:t_store/features/shop/features/cart/data/source/cart_local_storage_services.dart';
5:
6: abstract class CartManagementService {
7: Future<void> addItemToCart({required CartItemModel cartItem});
8:
9: Future<void> removeItemFromCart({required String cartItemId});
10:
11: Future<void> changeItemQuantity(
12: {required String itemId, requir
…[truncated]

read — {"filePath": "/home/sambasene/Downloads/TStore-Firebase-main/lib/features/shop/features/cart/data/models/cart_item_model.dart"}

<path>/home/sambasene/Downloads/TStore-Firebase-main/lib/features/shop/features/cart/data/models/cart_item_model.dart</path>
<type>file</type>
<content>
1: import 'package:hive/hive.dart';
2: import 'package:t_store/features/shop/features/cart/data/models/product_cart_item_model.dart';
3:
4: part 'cart_item_model.g.dart';
5:
6: @HiveType(typeId: 2)
7: class CartItemModel {
8: @HiveField(0)
9: final String id;
10: @HiveField(1)
11: final ProductCartItemModel product;
12: @HiveField(2)
13: final int quantity;
14:
15: double get totalPrice => product.variation!.price * quantity;
16:
17: factory CartItemModel.fromJson(Map<String, dynamic> json) {
18: return CartItemModel(
19: product: Produc
…[truncated]

read — {"filePath": "/home/sambasene/Downloads/TStore-Firebase-main/lib/features/shop/features/cart/data/models/product_cart_item_model.dart"}

<path>/home/sambasene/Downloads/TStore-Firebase-main/lib/features/shop/features/cart/data/models/product_cart_item_model.dart</path>
<type>file</type>
<content>
1: import 'package:hive/hive.dart';
2: import 'package:t_store/features/shop/features/all_products/data/models/product_variation_model.dart';
3:
4: part 'product_cart_item_model.g.dart';
5:
6: @HiveType(typeId: 3)
7: class ProductCartItemModel {
8: @HiveField(0)
9: final String? id;
10: @HiveField(1)
11: final String? title;
12: @HiveField(2)
13: final double? price;
14: @HiveField(3)
15: final String? imageUrl;
16: @HiveField(4)
17: final ProductVariationModel? variation;
18: @HiveField(5)
19: final String? brand;
20:
21: Product
…[truncated]

read — {"filePath": "/home/sambasene/Downloads/TStore-Firebase-main/lib/features/shop/features/cart/data/repositories/cart_repository_impl.dart"}

<path>/home/sambasene/Downloads/TStore-Firebase-main/lib/features/shop/features/cart/data/repositories/cart_repository_impl.dart</path>
<type>file</type>
<content>
1: import 'package:dartz/dartz.dart';
2: import 'package:t_store/core/errors/failures.dart';
3: import 'package:t_store/features/shop/features/cart/data/mapper/cart_item_mapper.dart';
4: import 'package:t_store/features/shop/features/cart/data/models/cart_item_model.dart';
5: import 'package:t_store/features/shop/features/cart/data/source/cart_local_storage_services.dart';
6: import 'package:t_store/features/shop/features/cart/data/source/cart_mangment_service.dart';
7: import 'package:t_store/features/shop/features/cart/domain/en
…[truncated]

Let me also read the mappers and entities to complete the picture:

read — {"filePath": "/home/sambasene/Downloads/TStore-Firebase-main/lib/features/shop/features/cart/data/mapper/cart_item_mapper.dart"}

<path>/home/sambasene/Downloads/TStore-Firebase-main/lib/features/shop/features/cart/data/mapper/cart_item_mapper.dart</path>
<type>file</type>
<content>
1: import 'package:t_store/features/shop/features/cart/data/mapper/product_cart_item_mapper.dart';
2: import 'package:t_store/features/shop/features/cart/data/models/cart_item_model.dart';
3: import 'package:t_store/features/shop/features/cart/domain/entities/cart_item_entity.dart';
4:
5: extension CartItemMapper on CartItemModel {
6: /// Converts a [CartItemModel] to a [CartItemEntity].
7: CartItemEntity toEntity() {
8: return CartItemEntity(
9: id: id,
10: product: product.toEntity(),
11: quantity: quantity,
12: );
13: }
14: }
15:
16: /
…[truncated]

read — {"filePath": "/home/sambasene/Downloads/TStore-Firebase-main/lib/features/shop/features/cart/domain/entities/cart_item_entity.dart"}

<path>/home/sambasene/Downloads/TStore-Firebase-main/lib/features/shop/features/cart/domain/entities/cart_item_entity.dart</path>
<type>file</type>
<content>
1: import 'package:t_store/features/shop/features/cart/domain/entities/product_cart_item_entity.dart';
2:
3: class CartItemEntity {
4: final String? id;
5: final ProductCartItemEntity product;
6: final int quantity;
7:
8: double get totalPrice => product.price * quantity;
9:
10: CartItemEntity({this.id, required this.product, required this.quantity});
11:
12: static CartItemEntity empty() {
13: return CartItemEntity(
14: id: '',
15: product: ProductCartItemEntity.empty(),
16: quantity: 0,
17: );
18: }
19:
20: CartItemEntity copyWit
…[truncated]

read — {"filePath": "/home/sambasene/Downloads/TStore-Firebase-main/lib/features/shop/features/cart/domain/entities/product_cart_item_entity.dart"}

<path>/home/sambasene/Downloads/TStore-Firebase-main/lib/features/shop/features/cart/domain/entities/product_cart_item_entity.dart</path>
<type>file</type>
<content>
1: import 'package:t_store/features/shop/features/all_products/data/models/product_variation_model.dart';
2:
3: class ProductCartItemEntity {
4: final String id;
5: final String title;
6: final double price;
7: final String imageUrl;
8: final ProductVariationModel variation;
9: final String brand;
10:
11: ProductCartItemEntity({
12: required this.id,
13: required this.title,
14: required this.price,
15: required this.imageUrl,
16: required this.variation,
17: required this.brand,
18: });
19:
20: ProductCartItemEntity copyWith
…[truncated]

read — {"filePath": "/home/sambasene/Downloads/TStore-Firebase-main/lib/features/shop/features/cart/presentation/cubits/cart_state.dart"}

<path>/home/sambasene/Downloads/TStore-Firebase-main/lib/features/shop/features/cart/presentation/cubits/cart_state.dart</path>
<type>file</type>
<content>
1: import 'package:equatable/equatable.dart';
2: import 'package:t_store/features/shop/features/cart/domain/entities/cart_item_entity.dart';
3:
4: abstract class CartState extends Equatable {
5: const CartState();
6:
7: @override
8: List<Object> get props => [];
9: }
10:
11: class CartInitialState extends CartState {}
12:
13: class CartLoadingState extends CartState {}
14:
15: class CartLoadedState extends CartState {
16: final List<CartItemEntity> cartItems;
17: final double totalPrice;
18:
19: const CartLoadedState(this.cartItems,
…[truncated]

Now I have a complete picture of the cart and Hive implementation. Let me provide an in-depth analysis.


The cart implementation follows a clean architecture pattern with multiple layers:

CartCubit -> Use Cases -> Repository -> Services -> Hive

1. Cart Dependency Injection (cart_injection.dart)

Section titled “1. Cart Dependency Injection (cart_injection.dart)”

The dependency injection sets up a hierarchical chain:

// 1. Singleton: Local storage (low-level, single instance)
getIt.registerLazySingleton<CartLocalStorageServices>(
() => CartLocalStorageServicesImpl(),
);
// 2. Singleton: Management service (depends on local storage)
getIt.registerLazySingleton<CartManagementService>(
() => CartManagementServiceImpl(getIt.get<CartLocalStorageServices>()),
);
// 3. Singleton: Repository (depends on both)
getIt.registerSingleton<CartRepository>(
CartRepositoryImpl(
getIt.get<CartManagementService>(),
getIt.get<CartLocalStorageServices>(),
),
);
// 4-8. Lazy singletons: Use cases (stateless, lightweight)
getIt.registerLazySingleton<FetchCartItemsUseCase>(...);
getIt.registerLazySingleton<AddItemToCartUsecase>(...);
// 9. Factory: Cubit (fresh instance per use - state management)
getIt.registerFactory<CartCubit>(() => CartCubit(getIt.get<CartUsecases>()));

Key Points:

  • CartLocalStorageServices and CartManagementService are lazy singletons (created on first access)
  • CartRepository is a singleton (created at registration)
  • CartCubit is a factory (new instance each time)

2. Hive Box Configuration (cart_local_storage_services.dart)

Section titled “2. Hive Box Configuration (cart_local_storage_services.dart)”
static final String _userId = FirebaseAuth.instance.currentUser!.uid;
static final String _boxName = '${_userId}Cart';
static Box<CartItemModel>? _cartBox;
Future<Box<CartItemModel>> _openBox() async {
_cartBox ??= await Hive.openBox<CartItemModel>(_boxName);
return _cartBox!;
}

Box Naming Strategy:

  • Box name is ${userId}Cart (e.g., abc123Cart)
  • Each user gets their own separate cart box
  • Singleton pattern for _cartBox ensures one box instance per app lifecycle

CartItemModel (typeId: 2):

@HiveType(typeId: 2)
class CartItemModel {
@HiveField(0) final String id;
@HiveField(1) final ProductCartItemModel product;
@HiveField(2) final int quantity;
double get totalPrice => product.variation!.price * quantity;
}

ProductCartItemModel (typeId: 3):

@HiveType(typeId: 3)
class ProductCartItemModel {
@HiveField(0) final String? id;
@HiveField(1) final String? title;
@HiveField(2) final double? price;
@HiveField(3) final String? imageUrl;
@HiveField(4) final ProductVariationModel? variation;
@HiveField(5) final String? brand;
}

4. Cart Management Service - Core Operations

Section titled “4. Cart Management Service - Core Operations”
// Add item - uses variation ID as key (prevents duplicates)
String cartKey = cartItem.product.variation!.id;
if (cartBox.containsKey(cartKey)) {
// Item exists - update quantity only
final updatedCartItem = existingItem?.copyWith(quantity: cartItem.quantity);
await cartBox.put(cartKey, updatedCartItem!);
return;
}
// New item - set ID to match variation ID
final updatedCartItem = cartItem.copyWith(id: cartKey);
await cartBox.put(cartKey, updatedCartItem);

Key behavior:

  • Uses variation ID as the key (not a random ID)
  • Prevents duplicate entries for same product variation
  • Updates quantity if item already exists

User Action (add to cart)
│
▼
CartCubit.addItemToCart()
│
▼
AddItemToCartUsecase
│
▼
CartRepository.addItemToCart()
│
▼
CartManagementService.addItemToCart()
│
▼
Hive Box.put(cartKey, cartItemModel)
│
▼
Returns to UI via Cubit state

Two-level caching:

  1. In-Memory Cache (Cubit level):
List<CartItemEntity> _cartItems = [];
// After any operation:
_cartItems.add(cartItem);
emit(CartLoade
…[truncated]
_5 internal reasoning block(s) omitted — raw thinking is not exported (see archive index)._