Barcode scan and AI meal analysis

​

Entry points

​

Barcode scan

​

Lookup

lookupBarcode(code) // GET /v1/trainee/nutrition/barcode/<code>

type BarcodeLookup = { found: true; product: BarcodeProduct } | { found: false };

interface BarcodeProduct {
  barcode: string;
  name: string;
  brand: string | null;
  imageUrl: string | null;
  per100: { kcal: number; protein: number; carbs: number; fat: number };
  serving: { label: string | null; grams: number | null } | null;
  mbpPer100?: MbpTotals;
}

​

Scanning

• The camera is an expo-camera CameraView with barcodeTypes set to ean13, ean8, upc_a and upc_e. Permission comes from useCameraPermissions. Without it the sheet shows a prompt and a grant button.
• The camera fires the same code on every frame. lockRef allows one lookup at a time. It is released when the product is not found or the request fails, and stays locked once a product is shown.
• A torch toggle is shown while the camera is live.
• A failed request and a found: false response both show the same “not found” message.

​

Manual entry and the keyboard

• The modal root is a KeyboardAvoidingView with behavior="padding" on both platforms and keyboardVerticalOffset set to minus the bottom safe-area inset.
• The scan area, the spacer above the product card and the card itself are Pressable wrappers that call Keyboard.dismiss. A number pad has no return key, so tapping outside is how it closes.

​

Product card

• id from localId('scan').
• name is the product name, with the brand appended after a middle dot when there is one.
• eaten: false, unit: 'gram', qty: grams, a per 100 g base and the product itself as barcode, so the amount can be changed later.

​

The iOS dismissal order

​

AI meal analysis

​

Request and response

analyzeMeal(input) // POST /v1/trainee/nutrition/analyze

interface AnalyzeMealInput {
  text?: string;
  image?: string;    // base64
  mimeType?: string;
}

interface MealAnalysis {
  name: string;
  calories: number;
  protein: number;
  carbs: number;
  fat: number;
  note: string;
  items?: MealAnalysisItem[];
  mbp?: MbpTotals;
}

interface MealAnalysisItem {
  name: string;
  grams: number;
  calories: number;
  protein: number;
  carbs: number;
  fat: number;
  mbp?: MbpTotals;
}

​

Taking the photo

1. Runs the asset through shrinkImage(uri, { base64: true }) from src/lib/media/shrinkImage.ts. That helper caps the longest edge at 1600 px and saves a JPEG.
2. If shrinking is unavailable, reads the original file as base64 and keeps its own mime type.
3. Returns { uri, base64, mimeType } or null when the trainee cancels or the read fails.

​

Errors

• When the error is an ApiError whose body has details.easterEgg equal to 'alcohol' or 'cannabis', the app shows an Alert with a dedicated message and does not show a failure.
• Anything else runs the fallback, which shows the generic strings.analyzeFailed message inline or as a toast.

​

When the server sends no MBP

​

Flow 1: quick add from the tab

logQuickMeal(input) // POST /v1/trainee/nutrition/log

interface LogMealInput {
  name?: string;
  note?: string;
  source?: 'PLAN' | 'PHOTO' | 'FREE_TEXT' | 'MANUAL';
  consumedAt?: string;
  photoUrl?: string;
  calories?: number;
  protein?: number;
  carbs?: number;
  fat?: number;
}

• photoUrl comes from uploadFile in src/lib/api/upload.ts (see Tracking and uploads). The uploaded url is cached in a ref so the favorite toggle and the log reuse one upload. A failed upload does not block the log. The meal is saved without a photo.
• consumedAt is only sent when the meal is for yesterday. See the editable window in Day log and sync.

upsertCustomMeal(dateKeyOf(logDateMs), {
  id: localId('meal'),
  label: mealTitle,
  source,
  logId: logged.id,
  items: [{ id: localId('add'), name: mealTitle, kcal, protein, carbs, fat, mbp, eaten: true }],
});

​

Flow 2: replace a plan meal

• Photo replaces the whole meal.
• Barcode adds one product beside what is already there.
• Text analyzes a description and also replaces the whole meal.

1. logQuickMeal with the analysis totals, note: mealLabel, source 'PHOTO' or 'FREE_TEXT', and consumedAt when the date is not today.
2. onLogged with an item whose id is the returned log id and eaten: true.

​

Flow 3: add a food to a meal

• Search. useFoodSearch on a 250 ms debounced query, from 2 characters, showing the first 8 results. A result becomes an item through foodToComponent: default unit and quantity, scalePortion for macros, scaledFoodMbp for MBP, eaten: false. The search row rides along as source so the amount can be changed later.
• Barcode. Opens BarcodeScanSheet.
• Text. One analyze call, then an add button. The item has eaten: false and no amount to change.

​

How results reach the server

​

Related

• Nutrition overview
• Portions and MBP
• Day log and sync