Tracking and uploads

​

Routes

​

Tracking endpoints

​

Summary shape

export interface MeasurementsSummary {
  count: number;
  sinceDate: string | null;
  currentWeightKg: number | null;
  startWeightKg: number | null;
  goalWeightKg: number | null;
  goal: { pct: number | null; remainingKg: number | null; direction: 'lose' | 'gain' | null };
  trend: { date: string; weightKg: number }[];
  circumferences: {
    key: 'chest' | 'waist' | 'hips' | 'arm' | 'thigh';
    current: number | null; first: number | null; delta: number | null;
  }[];
  log: MeasurementLogRow[];
}

export interface MeasurementLogRow {
  weightEntryId: string | null;
  date: string;
  time: string | null;
  weightKg: number | null;
  deltaKg: number | null;
  isFirst: boolean;
  source: 'app' | 'coach' | 'form' | 'automation' | 'import';
  editable: boolean;
  note: string | null;
  circumferences: Partial<Record<'chest' | 'waist' | 'hips' | 'arm' | 'thigh' | 'neck', number>>;
}

​

Hooks

​

Measurements log screen

1. Header with the number of measurements and, when sinceDate is set, the date of the first one.
2. Current weight card. Shows currentWeightKg, a pill with the change since startWeightKg, the goal weight, and the remaining kilograms when goal.remainingKg is above 0. When a goal and goal.pct exist, a progress bar is drawn at that percentage. MeasurementsTrendChart is embedded in the card.
3. Circumference tiles, one per entry in summary.circumferences, with the current value and the delta.
4. New measurement button, which opens the sheet in create mode.
5. Filter chips: all, weight only (weightKg !== null), circumferences only (the row has at least one circumference).
6. Log rows. Each row shows the date (prefixed with the today label when it matches todayIsoDate()), the source label, time and note, the weight with its delta, and circumference chips. Rows with editable: false are not pressable.

​

Good and bad colouring

• Weight: gaining is true when a goal exists and is above the start weight. When gaining, an increase is good. Otherwise a decrease is good.
• Circumference tiles: for arm, an increase is good. For every other key, a decrease is good.
• A zero or missing delta is neutral.

​

Trend chart

​

Measurement sheet

​

Inputs

​

What gets saved

1. If weight is on, logWeight({ weightKg, note }).
2. If circumferences changed, logMeasurements(changes). The note goes here as notes only when weight is off.
3. For each picked photo, uploadFile(...) and then logProgressPhoto({ url: fileUrl, pose }). Photos are uploaded one after another.

1. If the row has a weightEntryId and weight is on, updateEntry.mutateAsync({ id, input: { weightKg, note } }). An empty note is sent as null.
2. If circumferences changed, logMeasurements({ ...changes, date: editRow.date }). The note is attached only when the row has no weight entry.

​

Profile health tiles

​

Steps screen

​

Progress screen

• trend points are rounded to one decimal and sorted by date ascending.
• currentWeightKg falls back to the last trend point, then 0. startWeightKg falls back to the first trend point, then the current weight.
• streak defaults to { current: 0, best: 0, activeToday: false, lastWorkoutOn: null }.
• weeklyCompliancePct stays null only when the server sends an explicit null. A missing key becomes 0, for older backends.
• filePlan goes through normalizeFilePlanFlags.

​

Upload pipeline

export interface UploadSource {
  uri: string;
  name: string;
  mimeType: string;
}

export async function uploadFile(
  input: UploadSource & { onProgress?: (fraction: number) => void },
): Promise<{ fileUrl: string }>;

​

Request

POST /v1/trainee/uploads
Authorization: Bearer YOUR_SESSION_TOKEN
Content-Type: image/jpeg
x-file-type: image/jpeg
x-file-name: front.jpg
X-Timestamp: 1700000000000
X-Nonce: a-random-string

• headerFileName(name) passes a name through only if it is printable ASCII. Otherwise it sends upload. plus the original extension when that is alphanumeric, or jpg. A Hebrew file name therefore never reaches a header.
• headerMime(mimeType) passes a well-formed type/subtype through and replaces anything else with application/octet-stream. This blocks header injection through a crafted name or type.

​

Image shrinking

• A source whose mimeType does not start with image/, or is image/gif, is returned unchanged. Videos are never touched.
• Otherwise shrinkImage(uri) decodes the image, resizes it only when its longer edge is above 1600 px (landscape is bounded by width, portrait by height), and saves a JPEG at quality 0.7.
• The result is { uri: shrunkUri, mimeType: 'image/jpeg', name } with the extension replaced by jpg. A HEIC photo becomes a JPEG.
• If shrinking is unavailable or fails, the original source is uploaded as is.

1. Missing native module. loadManipulator() probes requireOptionalNativeModule('ExpoImageManipulator') and only then does a dynamic import('expo-image-manipulator'). On a store binary built before the module was added, the probe returns nothing and the original file is uploaded. This is why shrinking needs a new native build but the code is safe to ship over the air.
2. Uri only. ImageManipulator.manipulate() must receive the uri string. The code comment records that passing a native shared object, such as an expo-image ref, crashes the app on iOS with expo-modules-jsi 57.0.0.

​

Retry policy

const UPLOAD_ATTEMPTS = 3;
const RETRY_DELAYS_MS = [1000, 3000];
const RETRYABLE_STATUSES = new Set([0, 408, 429, 502, 503, 504]);

• A thrown upload task or an empty response becomes ApiError with status 0, which is retryable. That covers a dropped connection.
• The image is prepared once, before the loop, so retries resend the same shrunk file.
• Before each retry onProgress(0) is called so progress bars restart, then the loop waits 1 second, then 3 seconds.
• After the third failed attempt the last error is thrown.
• Any other status, including 500, 400 and 413, fails on the first attempt.

​

The 413 case

• Form upload fields set the status tooLarge, show the file-too-large string and offer only a replacement, not a retry.
• useTechniqueVideo shows the same string.

​

Preview and retry in forms

​

Avatar upload