freshyo/apps/user-ui/test-case-info.md
2026-10-13 19:10:27 +05:30

623 lines
34 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# user-ui — test case info
Every test case for the user-ui app, grouped by file with the API expectation
each one locks in. Companion to `tests/home-page/README.md` (long-form home-page
detail).
- **Runner**: `jest-expo` + `@testing-library/react-native`
- **Total**: **66 suites / 347 tests** (counted from the files after the region-test sync; not re-run in that pass)
- Per-group counts below are counted from the files (`it`/`test` lines); jest expands
`it.each` cases, so a run reports a few more than the sum of these tables.
- Network is mocked at the layer (`tests/mocks/api.ts`); components, stores, hooks and the router stay real.
## Run
From `apps/user-ui`:
```bash
NODE_ENV=test bun run test # everything
NODE_ENV=test bun run test tests/screens # one folder
NODE_ENV=test bun run test:watch # watch
bun run test:typecheck # tsc over app + tests
```
`NODE_ENV=test` is required (production React rejects `act`).
## Conventions
- **API expectation**: any button that triggers a network call has a case asserting it —
`expectProcedureCalled(fetchMock, '<proc>')`, `lastProcedureInput` for the payload, or the
axios mock's call history for CDN files.
- **Router**: `tests/mocks/router.ts` spies; real-router flows use `tests/helpers/real-router.tsx`
in files that do **not** mock expo-router.
- **State**: zustand stores are module singletons — reset them in `beforeEach`.
---
# home-page (`tests/home-page/`) — 48
### `home.test.tsx` — 18
| # | Test | Asserts |
| --- | --- | --- |
| 1 | requests the products cache url derived from common.essentialConsts | `common.essentialConsts` fetched, then the CDN products URL |
| 2 | shows a tab for every tag | one `tag-tab-*` per tag with its name |
| 3 | shows every product of every tag, expanding each grid once | 6-item preview then Show More reveals the rest |
| 4 | renders a tag with its out-of-stock items last | out-of-stock pushed last, admin order kept within groups |
| 5 | shows the upcoming slots in delivery order | first 5 upcoming slots, delivery then freeze sort |
| 6 | hides a slot whose freeze time has passed | expired-freeze slot absent from the strip |
| 7 | hides a slot whose freeze time has passed in the add-to-cart dialog | expired slot not offered, a valid one still is |
| 8 | shows the load-all button until every product is loaded | `products-show-more` pages 21 at a time |
| 9 | marks exactly the unavailable products out of stock in every tag | badge present iff unavailable |
| 10 | lists the main product list with unavailable items last | mounted head matches the expected order |
| 11 | adds items to the cart | bar counts lines; card swaps to a stepper |
| 12 | updates and removes a cart item through the card quantity stepper | dialog update mode, quantity change, delete |
| 13 | shows the store list and navigates when a store is tapped | push `…/stores` + navigationStore flags |
| 14 | opens the product detail page from a tag grid card | push `…/product-detail/<id>` |
| 15 | opens the product detail page from the main list | push `…/product-detail/<id>` |
| 16 | opens the slot detail page when a slot card is tapped | push `…/slot-view?slotId=<id>` |
| 17 | opens search from the search bar | push `…/search-results` |
| 18 | opens the cart from the floating bar | push `…/home/cart` |
### `navigation.test.tsx` — 3 (real router)
| # | Test | Asserts |
| --- | --- | --- |
| 1 | routes to the product detail screen carrying the id | pathname + `id` param delivered |
| 2 | routes to the slot view carrying the slotId | `/home/slot-view` + `slotId` param |
| 3 | routes to the stores screen | `/stores` stub visible |
### `home-states.test.tsx` — 5
| # | Test | Asserts |
| --- | --- | --- |
| 1 | shows the loading screen while the products request is pending | "Loading products..." |
| 2 | shows the products error state when the products request fails | "Oops!" + "Failed to load products" |
| 3 | shows the app-settings error state when essentialConsts fails | "Failed to load app settings" |
| 4 | shows the empty state when there are no products | "No products available" |
| 5 | shows the empty-category message for a tag with no products | "No products in this category yet" |
### `home-refresh.test.tsx` — 2
| # | Test | Asserts |
| --- | --- | --- |
| 1 | refetches every data source through useManualRefresh | products/stores/slots/consts URLs requested again |
| 2 | refetches every data source through useMarkDataFetchers | same, via the mark-data-fetchers callback |
### `home-slots.test.tsx` — 3
| # | Test | Asserts |
| --- | --- | --- |
| 1 | marks only the slots closing within 4 hours | CLOSING SOON iff freeze < 4h (both branches) |
| 2 | labels each slot with its delivery range and order-by time | delivery range, order-by clock, date line |
| 3 | shows how many products each slot holds | "View all N items" |
### `home-add-to-cart-dialog.test.tsx` — 3
| # | Test | Asserts |
| --- | --- | --- |
| 1 | offers flash delivery and routes to the flash cart when enabled | flash row shown; confirm pushes the flash cart |
| 2 | keeps confirm disabled until a delivery option is chosen | disabled CTA |
| 3 | pre-selects the cart quantity when reopened from the card stepper | Update Item + current quantity |
### `home-floating-cart-bar.test.tsx` — 5
| # | Test | Asserts |
| --- | --- | --- |
| 1 | adds exactly the pinned products and tracks the total and delivery threshold | ₹215 → "₹34 more"; +₹129 → ₹344 • 2 Items → Unlocked |
| 2 | places each pinned product in the first open slot it belongs to | one slot label per line |
| 3 | recomputes the total when the quantity changes | ₹215 → ₹430, still one line |
| 4 | expands into the cart dialog with the line and the subtotal | "Your Cart" + Subtotal |
| 5 | re-slots a stored cart item whose slot no longer exists | `useReconcileCartSlots` rewrites the slotId |
### `next-order-glimpse.test.tsx` — 5
| # | Test | Asserts |
| --- | --- | --- |
| 1 | renders nothing and never requests orders when signed out | no preview; `user.order.getOrders` not called |
| 2 | previews an upcoming order | id, "N items • ₹total", status label |
| 3 | flags a flash order | FLASH + "30-Min Delivery" |
| 4 | ignores cancelled and completed orders | no preview |
| 5 | routes to my-orders when a card is tapped | `router.replace('…/me')` |
### `home-cards.test.tsx` — 4
| # | Test | Asserts |
| --- | --- | --- |
| 1 | never renders a combo-only SKU | id 149 absent everywhere |
| 2 | renders every store with the leading "The " stripped | all stores + name normalisation |
| 3 | strikes through the market price when it is above the selling price | market price shown |
| 4 | shows a fallback when a product image fails to load | "Image failed to load" |
---
# screens (`tests/screens/`) — 133
### `auth.test.tsx` — 9
| # | Test | Asserts |
| --- | --- | --- |
| 1 | renders the mobile step with the submit button | mobile input + CTA |
| 2 | rejects an invalid mobile number without calling the API | validation error, no `user.auth.sendOtp` |
| 3 | sends an OTP and moves to the OTP step | `user.auth.sendOtp` called → OTP step |
| 4 | verifies the OTP and hands the token to the auth context | `user.auth.verifyOtp` → `loginWithToken('tok', user)` |
| 5 | logs in with identifier + password via the password path | `user.auth.login` → `loginWithToken` |
| 6 | opens the terms dialog from the terms link | dialog visible |
| 7 | renders the registration form and links to sign in | `router.push('/(auth)/login')` |
| 8 | shows a spinner while the session is loading | auth layout spinner |
| 9 | renders the stack once loading finishes | no spinner |
### `navigation-shell.test.tsx` — 2 (real router)
| # | Test | Asserts |
| --- | --- | --- |
| 1 | redirects to the home route once auth has settled | pathname `/home` |
| 2 | stays on the entry route and shows a spinner while auth loads | spinner, pathname `/` |
### `flash-gate.test.tsx` — 2
| # | Test | Asserts |
| --- | --- | --- |
| 1 | shows the unavailable screen and routes home when disabled | unavailable copy + `router.replace('…/home')` |
| 2 | renders the slot content when enabled | `common.essentialConsts` fetched, no gate |
### `stores.test.tsx` — 5
| # | Test | Asserts |
| --- | --- | --- |
| 1 | lists every store with its product count | all names + one Explore Store each |
| 2 | navigates to a store detail when Explore Store is pressed | push `…/store-detail/<id>` |
| 3 | deep-links to the store chosen on the home page and clears the flag | focus effect push + flags cleared |
| 4 | shows the error state and refetches on Retry | "Store Fetch Failed" → `stores.json` re-requested |
| 5 | shows the empty state when there are no stores | "No Stores Available" |
### `store-detail.test.tsx` — 4
| # | Test | Asserts |
| --- | --- | --- |
| 1 | renders the store, its tags and products | store meta + "Chicken (3)" + cards |
| 2 | filters by tag and clears the filter | "Chicken items" → Clear → "N products" |
| 3 | navigates to a product detail when a card is pressed | push `…/product-detail/<id>` |
| 4 | shows the error state when the store cannot be loaded | store-not-found copy |
### `search.test.tsx` — 6
| # | Test | Asserts |
| --- | --- | --- |
| 1 | lists all products when the query is empty | "All Products" + cards |
| 2 | filters products by the debounced query | 300ms debounce → filtered header + fewer cards |
| 3 | shows the no-results state for an unmatched query | "No products found" + hint |
| 4 | restores all products when the query is cleared | header back to "All Products" |
| 5 | shows the loading state while products are pending | "Loading products..." |
| 6 | opens the product detail page when a card is pressed | push `…/product-detail/<id>` |
### `order-again.test.tsx` — 6
| # | Test | Asserts |
| --- | --- | --- |
| 1 | renders both section headers | Offers + Combos |
| 2 | shows the empty message for a section with no products | "No offers available right now" |
| 3 | renders a card for every combo | ≥1 card |
| 4 | opens the product detail page when a card is pressed | push `…/order-again/product-detail/<id>` |
| 5 | shows the loading state while products are pending | "Loading offers..." |
| 6 | shows the error state when products fail to load | "Oops!" + "Failed to load offers" |
### `slot-view.test.tsx` — 8
| # | Test | Asserts |
| --- | --- | --- |
| 1 | shows the loading state while slots load | "Loading slot delivery..." |
| 2 | shows the error state when slots fail | "Failed to load slot delivery" |
| 3 | shows the no-slot state for an unknown slot id | "No delivery slot available." |
| 4 | lists the slot products and navigates on press | cards + push product-detail |
| 5 | shows the empty message when a store has no products in the slot | store-filter copy |
| 6 | lists flash-available in-stock products | flash filter |
| 7 | filters products by the search box | no-results copy |
| 8 | shows the empty message when there are no products | "No 1 Hr Delivery products available." |
### `cart-screen.test.tsx` — 11
Signed in by default (login wall when signed out; first-address gate when there are no addresses).
| # | Test | Asserts |
| --- | --- | --- |
| 1 | shows the empty state and Start Shopping navigates home | push `…/home` |
| 2 | renders the seeded line, the bill and queries the cart slots | bill ₹230 + `user.cart.getCartSlots` input `{productIds:[2]}` |
| 3 | queries eligible coupons only when authenticated | `user.coupon.getEligible` + Offers & Coupons |
| 4 | navigates to checkout with the selected slot | push `…/home/checkout` |
| 5 | shows an enabled merge row when every item can use the majority slot | `delivery-slot-merge` → apply → hidden |
| 6 | hides the merge row when one item cannot use the majority slot | no merge row |
| 7 | hides the merge row when only one slot is selected | no merge row |
| 8 | renders the flash cart variant without slot selection | "1 Hr Delivery Cart" |
| 9 | shows the login wall when signed out | "Please log in" + "Log In"; no cart line |
| 10 | shows the add-address gate before the cart when the user has no addresses | "Where should we deliver?" + `cart-address-other`; cart line hidden |
| 11 | shows the add-address gate even when the cart is empty | gate, not "Your cart is empty" |
### `cart-coupons.test.tsx` — 12 (coupon application + discount calculation)
Cart: 2 x product 2 @ 215 = 430. Consts: freeDeliveryThreshold 249, deliveryCharge 15.
| # | Test | Asserts |
| --- | --- | --- |
| 1 | shows the item total and free delivery before a coupon is applied | no `Product Discount` row, "Free" |
| 2 | offers the coupon with its computed saving | option label carries `Save ₹43` (10% of 430) |
| 3 | applies a percentage discount and shows the applied code | `Product Discount -₹43`, `Coupon Applied SAVE10`, To Pay ₹387 |
| 4 | caps a percentage discount at maxValue | 50% of 430 = 215 capped to `-₹50`, ₹380 |
| 5 | applies a flat discount | `-₹100`, ₹330 |
| 6 | caps a flat discount at the item total | flat 1000 on a 430 cart → `-₹430` (never negative) |
| 7 | re-adds the delivery fee when the discount drops the total below the threshold | 430 − 200 = 230 < 249 → ₹245, no "Free" |
| 8 | removes the coupon and the discount again | `Remove coupon` → both rows gone |
| 9 | lists a min-order coupon as ineligible and does not apply it | label carries `Min order ₹1000`; pressing it applies nothing |
| 10 | hides a coupon that has hit its per-user usage limit | "No coupons available" + empty copy |
| 11 | drops the discount when a quantity change takes the cart below the minOrder | select a minOrder-300 coupon at ₹430, decrement to ₹215 → discount gone (`cart-item-1-decrement` / `-value`) |
| 12 | sends the selected coupon id to checkout | push URL contains `&coupons=77` |
### `checkout-crash.test.tsx` — 4 (checkout guards + the resolved bill)
The last case is the regression guard for the Rules-of-Hooks crash that used to make the screen
unrenderable: it asserted the thrown error until the hooks were moved above the guard, and now
asserts the bill instead.
| # | Test | Asserts |
| --- | --- | --- |
| 1 | asks for delivery slots when the cart lines have none | "No items to checkout" + "Please select delivery slots for your items" |
| 2 | reports flash-unavailable lines on the flash checkout | "None of your cart items are available for flash delivery" |
| 3 | shows the empty-cart state when there is nothing to pay for | "Your cart is empty" |
| 4 | renders the bill once the cart resolves to slotted items | header + Item Total ₹215 + To Pay ₹230, no discount (used to throw) |
### `checkout-coupons.test.tsx` — 10 (coupon application + discount calculation)
Cart: 2 x product 2 @ 215 = 430. Consts: freeDeliveryThreshold 249, deliveryCharge 15.
| # | Test | Asserts |
| --- | --- | --- |
| 1 | applies a percentage discount to the item total | `-₹43`, To Pay ₹387, "Free", "You saved ₹68 on this order" |
| 2 | caps a percentage discount at maxValue | 50% of 430 = 215 capped to `-₹50`, ₹380 |
| 3 | applies a flat discount | `-₹100`, ₹330 |
| 4 | caps a flat discount at maxValue | `-₹150`, ₹280 |
| 5 | never discounts below zero — capped at the item total | flat 1000 on a 430 cart → `-₹430` |
| 6 | charges delivery again when the discount drops the total below the threshold | 430 − 200 = 230 < 249 → ₹245 + "Add products worth ₹19 for free delivery" |
| 7 | does not apply a coupon whose minOrder is not met, even from the URL | no `Product Discount` row, "Free" |
| 8 | ignores a coupon that has hit its per-user usage limit | no `Product Discount` row |
| 9 | shows no discount when the URL carries no coupon | no `Product Discount`, "Free" |
| 10 | sends the selected coupon id with the order | `placeOrder` payload `couponId: 77`; `replace('…totalAmount=387')` |
### `checkout.test.tsx` — 2
| # | Test | Asserts |
| --- | --- | --- |
| 1 | shows the empty-cart state and goes back | "Your cart is empty" + `router.back` |
| 2 | redirects to login when unauthenticated | `router.push('/(auth)/login')` |
### `product-detail-routes.test.tsx` — 4
| # | Test | Asserts |
| --- | --- | --- |
| 1 | home route renders ProductDetail with the id | `7:regular` |
| 2 | stores route renders ProductDetail | id passed |
| 3 | order-again route renders ProductDetail | id passed |
| 4 | flash route renders ProductDetail | id passed |
### `order-success.test.tsx` — 3
| # | Test | Asserts |
| --- | --- | --- |
| 1 | renders the confirmation and performs both actions | `dismissTo` + `dismissAll` + push my-orders |
| 2 | shows the order id and total when params are present | "Order #ORD-9" + "Total: ₹500" |
| 3 | renders the confirmation actions | flash variant CTAs |
### `me-hub.test.tsx` — 4
| # | Test | Asserts |
| --- | --- | --- |
| 1 | renders the account sections and menu entries | My Account + entries |
| 2 | navigates to the orders screen | push `…/me/my-orders` |
| 3 | navigates to addresses | push `…/me/addresses` |
| 4 | logs out from the footer button | `logout` called |
### `me-orders.test.tsx` — 5
| # | Test | Asserts |
| --- | --- | --- |
| 1 | renders the fetched orders | `user.order.getOrders` + row |
| 2 | navigates to the order detail when a row is pressed | push `…/my-orders/11` |
| 3 | shows the empty state and Start Shopping navigates home | push `…/home` |
| 4 | shows the error state and retries | error copy + `getOrders` re-requested |
| 5 | retries payment through user.payment.createRazorpayOrder | procedure called |
### `order-detail.test.tsx` — 6
| # | Test | Asserts |
| --- | --- | --- |
| 1 | renders the order, its items and the total | `user.order.getOrderById` + total |
| 2 | shows the error state and goes back | `router.back` |
| 3 | saves special instructions via user.order.updateUserNotes | `{id, userNotes}` |
| 4 | requires a reason before cancelling | alert, no `cancelOrder` |
| 5 | cancels the order with a reason via user.order.cancelOrder | `{id, reason}` |
| 6 | opens the complaint form | complaint textarea visible |
### `me-account.test.tsx` — 16
| # | Test | Asserts |
| --- | --- | --- |
| 1 | lists the addresses and singles out the default | cards + Set Default |
| 2 | shows the empty state with an Add Address action | empty copy |
| 3 | shows the error state and retries | `user.address.getUserAddresses` re-requested |
| 4 | marks an address as default via user.address.updateAddress | `{id, isDefault: true}` |
| 5 | deletes an address after confirming via user.address.deleteAddress | `{id}` |
| 6 | renders personal and general sections | SAVE20 + both sections |
| 7 | redeems a code via user.coupon.redeemReservedCoupon | `{secretCode: 'SECRET1'}` |
| 8 | shows the empty sections when there are no coupons | both empty copies |
| 9 | renders complaints and support contacts | item + Pending + Need Help? |
| 10 | opens the dialer from Call Us | `Linking.openURL('tel:…')` |
| 11 | shows the empty state and Continue Shopping navigates home | push `…/home` |
| 12 | shows the error state | "Failed to load complaints" |
| 13 | renders the profile form and logs out | `logout` called |
| 14 | requires a mobile number before deleting the account | alert, no `deleteAccount` |
| 15 | deletes the account via user.auth.deleteAccount | `{mobile}` |
| 16 | renders the policy and goes back | terms content |
---
# components (`tests/components/`) — 70
### `product-card.test.tsx` — 5
| # | Test | Asserts |
| --- | --- | --- |
| 1 | renders the name, price, struck market price and unit | all four |
| 2 | shows the out-of-stock overlay when unavailable | badge |
| 3 | queues the product when the add icon is pressed (dialog mode) | `cartStore.addedToCartProduct` |
| 4 | shows the image-error fallback | "Image failed to load" |
| 5 | calls onPress when the card is tapped | callback |
### `product-detail.test.tsx` — 4
| # | Test | Asserts |
| --- | --- | --- |
| 1 | shows the loading state | "Loading product details..." |
| 2 | renders the product and loads its reviews | `getProductDetails{id}` + `getProductReviews` + flash badge |
| 3 | shows the error state when the product fails to load | "Product not found or error loading" |
| 4 | queues the add-to-cart dialog from the Add to Cart button | `cartStore.addedToCartProduct` |
### `payment-and-order.test.tsx` — 6
| # | Test | Asserts |
| --- | --- | --- |
| 1 | renders the bill and an enabled Place Order button | Bill Details + ₹230 + enabled |
| 2 | blocks ordering without an address | error banner + disabled CTA |
| 3 | places a COD order and redirects to order success, clearing the cart | `placeOrder` payload, `replace('…order-success…')`, cart cleared |
| 4 | shows an error when placing the order fails | alert |
| 5 | renders the product discount and the savings banner when a coupon is applied | `Product Discount -₹43`, ₹387, "You saved ₹58 on this order" |
| 6 | sends the selected coupon id with the order | `placeOrder` payload `couponId: 77` |
### `order-menu.test.tsx` — 4
| # | Test | Asserts |
| --- | --- | --- |
| 1 | navigates to the order details | push `…/my-orders/42` |
| 2 | saves edited instructions via user.order.updateUserNotes | `{id, userNotes}` |
| 3 | requires a reason before cancelling | alert, no `cancelOrder` |
| 4 | cancels the order with a reason via user.order.cancelOrder | `{id, reason}` |
### `complaint-form.test.tsx` — 3
| # | Test | Asserts |
| --- | --- | --- |
| 1 | renders nothing when closed | null tree |
| 2 | rejects an empty complaint without calling the API | alert, no `complaint.raise` |
| 3 | raises a complaint with the typed body and closes | `{orderId, complaintBody, imageUrls: []}` + close |
### `registration-form.test.tsx` — 5
| # | Test | Asserts |
| --- | --- | --- |
| 1 | renders the registration fields | Create Account + name field |
| 2 | blocks submit with a validation error | "Name is required" |
| 3 | rejects mismatched passwords | "Passwords do not match" |
| 4 | submits the normalised register payload | trimmed/lowercased payload |
| 5 | updates the password in edit mode via user.auth.updatePassword | `{password}` |
### `address-form.test.tsx` — 6
Coordinates are mandatory, so most cases seed the device location (`useLocationStore`) before rendering.
| # | Test | Asserts |
| --- | --- | --- |
| 1 | renders the add-address form without a service-area notice | title + name field; no "We currently serve" |
| 2 | keeps Add Address disabled until a location is attached | disabled CTA + "Attach a location to add address" after the first field is touched |
| 3 | shows the device-source heading once a location is attached | "Current Location Attached" + "Choose Another Location in Map" |
| 4 | validates the required fields | name/phone/line1 errors |
| 5 | creates an address with the region and coordinates derived from the location | `createAddress` payload carries `regionId`, `latitude`/`longitude` and the City name |
| 6 | updates an address in edit mode via user.address.updateAddress | `{id, regionId}` |
### `address-selectors.test.tsx` — 6
| # | Test | Asserts |
| --- | --- | --- |
| 1 | lists the addresses and auto-selects the default | both cards + `onAddressSelect(2)` |
| 2 | selects an address on press | `onAddressSelect(1)` |
| 3 | refreshes the addresses after attaching the current location | `updateAddress` gets the mocked coords, then `getUserAddresses` is fetched a **second** time (fails with the old dotted-string invalidation) |
| 4 | shows the empty state | empty copy + Add Address |
| 5 | shows the earliest slot and changes it from the dialog | slot options → `onSlotChange` |
| 6 | shows the flash header variant | "Delivery in within 1 hour" |
### `location-attacher.test.tsx` — 3
| # | Test | Asserts |
| --- | --- | --- |
| 1 | attaches the current location on success | `onLocationChange(coords)` + attached badge |
| 2 | shows an error when permission is denied | error copy, no callback |
| 3 | does nothing while disabled | no permission request |
### `location-wrapper.test.tsx` — 3
| # | Test | Asserts |
| --- | --- | --- |
| 1 | renders its children once a region is selected | passthrough |
| 2 | shows a spinner while the region is still resolving | "Finding your region..." |
| 3 | asks for an address with a location notice when the location is denied | chooser + "Location access is not granted..." + `open-location-settings` |
### `cart-address-gate.test.tsx` — 3
| # | Test | Asserts |
| --- | --- | --- |
| 1 | offers the current-location and map options | both option cards; current enabled with a device fix |
| 2 | disables the current-location option without a device fix | disabled card + "Turn on location to use this option" |
| 3 | opens the address form from the map option | `address-name` visible |
### `slot-layout.test.tsx` — 2
| # | Test | Asserts |
| --- | --- | --- |
| 1 | renders the delivery-time selector and the cart bar | Delivery Time + No Items In Cart |
| 2 | renders the flash variant header | flash header copy |
### `wrappers.test.tsx` — 4
| # | Test | Asserts |
| --- | --- | --- |
| 1 | renders children when the backend is healthy | `common.healthCheck` ok |
| 2 | shows the service-unavailable state and retries | error copy + `healthCheck` re-requested |
| 3 | prompts to update when the backend version is ahead | "Update Available" |
| 4 | renders children and does not check for updates on dev builds | UpdateChecker inert |
### `static-components.test.tsx` — 10
| # | Test | Asserts |
| --- | --- | --- |
| 1 | renders the full policy with the title by default | title + sections |
| 2 | hides the title when showTitle is false | no title |
| 3 | renders the notice and dismisses via the close button | notice visible |
| 4 | auto-hides after the delay | timer removes it |
| 5 | renders the testing-phase bullets | bullets |
| 6 | renders its children | TabLayoutWrapper |
| 7 | shows the welcome screen once, then the children after Next | first-run gate |
| 8 | renders children when there is no webview html | children |
| 9 | renders the webview when the server provides html | mock webview |
| 10 | shows the exit confirmation on the home screen and swallows the event | alert + returns true |
### `icons.test.tsx` — 5
| # | Test | Asserts |
| --- | --- | --- |
| 1–5 | %s renders focused and unfocused (Home, Cart, Stores, Offers, Me) | each icon renders in both states |
---
# hooks / stores / lib / contexts — 90 (hooks 40, stores 23, contexts 14, lib 13)
### `hooks/cart-query-hooks.test.tsx` — 6
| # | Test | Asserts |
| --- | --- | --- |
| 1 | adds an item to the regular cart | `cart_items` line written |
| 2 | keeps the flash cart separate from the regular cart | flash key only |
| 3 | increments the quantity of an item already in the cart | qty 1 → 3 |
| 4 | updates and removes a cart line | qty → 4, then removed |
| 5 | derives cart items and the total from the central stores | subtotal/total/totalItems |
| 6 | clears the local cart | `clearLocalCart` empties |
### `hooks/prominent-api-hooks.test.tsx` — 6
| # | Test | Asserts |
| --- | --- | --- |
| 1 | exposes essentialConsts from the trpc procedure | threshold 249 |
| 2 | derives the products cache url and merges availability | products + availability URLs, price/marketPrice |
| 3 | derives the stores cache url | stores URL |
| 4 | derives the slots cache url | slots URL |
| 5 | fetches a single store detail | `stores/1.json` + store.id |
| 6 | propagates a products fetch error | error surfaced |
### `hooks/useUploadToObjectStore.test.tsx` — 3
| # | Test | Asserts |
| --- | --- | --- |
| 1 | requests presigned urls and PUTs every image | `common.generateUploadUrls` + 2 PUTs + keys |
| 2 | short-circuits when there are no images | empty result, no request |
| 3 | fails when the URL count does not match the image count | throws |
### `hooks/useAuthenticatedRoute.test.tsx` — 3
| # | Test | Asserts |
| --- | --- | --- |
| 1 | redirects an unauthenticated user to login | `router.push('/(auth)/login')` |
| 2 | does not redirect an authenticated user | no push |
| 3 | does not redirect while auth is still loading | no push |
### `hooks/useProductSlotIdentifier.test.tsx` — 5
| # | Test | Asserts |
| --- | --- | --- |
| 1 | returns the id of the earliest upcoming slot for a product | slot 11 |
| 2 | ignores slots whose delivery is already past | slot 2 |
| 3 | returns null when the product has no slots | null |
| 4 | returns null when there are no slots at all | null |
| 5 | returns null when every slot for the product is in the past | null |
### `hooks/useJWT.test.ts` — 3
| # | Test | Asserts |
| --- | --- | --- |
| 1 | stores, reads and deletes the auth token | token round-trip |
| 2 | stores and reads the user id | userId round-trip |
| 3 | exposes the storage keys | `authToken` / `userId` |
### `hooks/useHideTabNav.test.tsx` — 2
| # | Test | Asserts |
| --- | --- | --- |
| 1 | marks the tab bar hidden for the caller key on focus | `hideTabsNav.cart` |
| 2 | defaults the caller key when none is given | `hideTabsNav.default` |
### `hooks/useColorScheme.test.tsx` — 1
| # | Test | Asserts |
| --- | --- | --- |
| 1 | returns the platform colour scheme | null/light/dark |
### `stores/stores.test.ts` — 11
| # | Test | Asserts |
| --- | --- | --- |
| 1 | appStore tracks tab-bar visibility per caller | set key true/false |
| 2 | addressStore holds the selected checkout address | 7 |
| 3 | cartStore queues and clears the add-to-cart product | queue/clear |
| 4 | flashCartStore queues and clears the flash product | queue/clear |
| 5 | navigationStore tracks the from-home flag and selected store | flags |
| 6 | quickDeliveryStore holds the selected slot | 1849 |
| 7 | storeHeaderStore holds the screen title | title |
| 8 | slotStore holds the quick-delivery slot and store | ids |
| 9 | flashNavigationStore flags navigation back to the cart and resets | flag + reset |
| 10 | centralProductStore indexes products by id | productsById |
| 11 | centralSlotStore builds productSlotsMap from slots + availability | map + flags |
### `stores/region-store.test.ts` — 4
| # | Test | Asserts |
| --- | --- | --- |
| 1 | stores the selected region and bound and bumps the generation | id/region/bound + generation 1 |
| 2 | does not bump the generation for an identical selection | generation stays 1 |
| 3 | clears the region and bumps the generation | nulls + generation 2 |
| 4 | is memory-only (no persist middleware) | `persist` undefined |
### `lib/string-manipulators.test.ts` — 3
| # | Test | Asserts |
| --- | --- | --- |
| 1 | maps pending to the user-facing "Confirmed" | mapping |
| 2 | is case-insensitive | PENDING/Pending |
| 3 | passes every other status through unchanged | packaged/success/cancelled/'' |
### `lib/pending-address.test.ts` — 4
| # | Test | Asserts |
| --- | --- | --- |
| 1 | round-trips a signed-out draft | save → get equals the draft |
| 2 | returns null when there is no draft | null |
| 3 | clears the draft | null after clear |
| 4 | returns null for corrupt stored JSON | null |
### `lib/trpc-client.test.ts` — 2
| # | Test | Asserts |
| --- | --- | --- |
| 1 | emits the force-logout event on a 401 UNAUTHORIZED response | `FORCE_LOGOUT_EVENT` |
| 2 | does not emit the force-logout event on a 500 response | no emit |
### `lib/query-invalidation-keys.test.tsx` — 1
| # | Test | Asserts |
| --- | --- | --- |
| 1 | matches the array path form and ignores the dotted string form | the stored key is `[['user','address','getUserAddresses'], {type}]`; `findAll({queryKey:['user.address.getUserAddresses']})` matches 0, the array form matches 1 (pins the stale-data bug in `CheckoutAddressSelector`) |
### `contexts/auth-context.test.tsx` — 4
| # | Test | Asserts |
| --- | --- | --- |
| 1 | settles to a signed-out state when there is no stored token | `false|false|none` |
| 2 | loginWithToken persists the token and authenticates | token stored + `true|false|5` |
| 3 | logout clears the session and the stored token | signed out + token null |
| 4 | useAuth throws outside an AuthProvider | throws |
---
## Not covered
Thin/global shells only: `app/_layout.tsx`, `(drawer)/_layout.tsx`, the per-route
`_layout.tsx` files, and `services/notif-service`.
**Coupon discount on the checkout page.** FIXED in this pass. `components/checkout-page.tsx`
used to call `trpc.user.coupon.getEligible.useQuery` and four `useMemo`s *after* its
`if (selectedItems.length === 0) return …` guard, so the hook count changed (4 → 9) as soon as
`useGetCart` resolved from `[]` to slotted lines and React threw *"Rendered more hooks than
during the previous render."* — the screen could not render at all with slotted items. The
hooks now sit above the guard, so the `?coupons=<id>` path is reachable and covered by
`checkout-coupons.test.tsx` (10 cases). Eligibility is honoured on both sides — the
`selectedCoupons` memo in each page filters on `isEligible`, so a coupon the cart cannot use is
ignored rather than silently discounted (including one that drifts out of eligibility after
selection, covered by `cart-coupons.test.tsx` case 11).
If you mount this page in a test without an error boundary and it ever throws again, the
runner wedges instead of failing (no output, ~0% CPU, no jest timeout); wrap it as
`checkout-crash.test.tsx` does.
Suites added alongside the parallel review — `cart-money`, `cart-storage`, `order-amounts`,
`product-detail-flash-flag`, `payment-and-order-money`, `force-logout`, `store-staleness`,
`auth-lifecycle` — are documented case-by-case in `tests/KNOWN-GAPS.md`; they are included in
the totals above but not yet in the per-suite tables below.
## Harness reference
| Path | Purpose |
| --- | --- |
| `tests/setup.ts` | Global stubs: axios, native modules (webview/updates/linking/location/notifications/razorpay/secure-store), `@react-navigation/native` focus, auth, storage, refresh hooks; frozen clock |
| `tests/mocks/api.ts` | axios CDN + tRPC stubs; `setupApiMocks({ procedures, products, stores, storeProducts, consts, orders, fail*, pending* })` |
| `tests/mocks/procedures.ts` | `expectProcedureCalled` / `procedureCalls` / `lastProcedureInput` (query + body inputs) |
| `tests/mocks/router.ts` | Mocked expo-router + `routerMock` spies + `searchParamsMock` |
| `tests/mocks/auth.ts` | Overridable auth mock + spies |
| `tests/mocks/native.ts` | Native module stubs |
| `tests/helpers/render.tsx` | `Providers` + `renderWithProviders` |
| `tests/helpers/real-router.tsx` | `renderRoute` (real expo-router) |