Merge pull request #799 from Tria-plc/freight_feature/usermanagement

add per-container handling options for hazardous, reefer, and return…

packages/types/src/freight/contracts.ts

@@ -729,14 +729,22 @@ export interface CreateContainerUnitDto {
   containerNumber: string;
   sealNumber?: string;
   vgmTons: number;
+  /** Per-container handling opt-ins, entered alongside this container's VGM. */
   isHazardous?: boolean;
   isReefer?: boolean;
+  /** This container ships back empty (equipment return). */
+  isReturn?: boolean;
 }
 
 export interface CreateBookingContainerLineDto {
   /** "20ft" | "40ft" — must be in the contract's cargo scope. */
   containerSize: string;
   quantity: number;
+  /**
+   * Line totals, derived from the per-unit switches above. The API recomputes
+   * them from `units` whenever any unit carries a flag, so they are only
+   * authoritative for callers that don't send per-unit flags.
+   */
   hazardousQuantity?: number;
   reeferQuantity?: number;
   /**