API: parts, carts, and prices

type AnalysisResult = {
  partRevisionId: string        // the ID for all later calls
  fileName: string
  versionNumber: number
  createdAt: string
  originalCadFileType: string
  availableAccessories: string[]

  width: number
  height: number
  length: number
  volume: number
  area: number
  convexHullVolume: number
  minBoundingBoxVolume: number
  shrinkWrapVolume: number
  minimumWallThickness: number | null
  watertight: boolean           // false: the part cannot be purchased instantly
  repaired: boolean             // the mesh was repaired automatically
  baseRotation: number[][]

  thumbnail: Uint8Array | null  // image bytes
  stl: Uint8Array               // gzip-compressed STL mesh, for a 3D viewer
  wallThickness: Uint8Array | null
  bending?: object | null       // sheet metal data
  machining?: object | null     // machining data
}

{ partRevisionId: string; units: MeasurementUnit; processPricesId: string; materialId: number }

type PartManufacturability = {
  partRevisionId: string
  limits: { withinBoundingBoxLimit: boolean; withinWallThicknessLimit: boolean }
  warnings: { hasOptimalWallThickness: boolean }
  values: { boundingBox: [number, number, number] | null; wallThicknessLimit: number | null; wallThicknessWarning: number | null }
}

type MeasurementUnit = 'MILLIMETERS' | 'CENTIMETERS' | 'METRES' | 'INCHES' | 'FEET'

type Cart = {
  cartId: string
  status: 'OPEN' | 'DELETED' | 'CONVERTED'
  items: CartItem[]
  customerId: number | null     // null: a guest cart that is not claimed
  currency: string | null
  notes: string | null
  affiliate: string | null
  discountId: number | null
  billingAddressId: number | null
  toAddressId: number | null
  shippingMethodId: number | null
  rateId: string | null
  createdAt: string
  lastUpdated: string
}

type CartItem = {
  id: number                    // omit when you create an item
  partRevisionId: string
  name: string | null
  quantity: number
  units: MeasurementUnit | null
  processPricesId: string | null
  materialId: number | null
  colorId: number | null
  infillId: number | null
  precisionPricesId: number | null   // NOTE: "precisionId" in pre-order and order lines
  leadTimeId: string | null
  postProcessingIds: number[] | null
  useOriginalOrientation: boolean | null
  files: { id: number; fileName: string | null; contentType: string | null; size: number | null }[] | null
}

type CreateOrder = {
  currency: string                                 // one of acceptedCurrencies
  requisitions: Record<string, CreateRequisition>  // key: a UUID that you select for each line
  shipping: CreateShipping | null
  shippingId: null
  billingAddressId: number | null
  discountId: number | null
  operatorNote: string | null                      // a note to the manufacturer
  affiliate: string | null
  cartId: string | null                            // POST /order only
  intent?: 'CHECKOUT'                              // POST /order only
}

type CreateRequisition = {
  sequence: number              // position of the line, from 0
  partRevisionId: string
  units: MeasurementUnit
  quantity: number
  processPricesId: string
  materialId: number
  infillId: number | null
  precisionId: number | null
  colorId: number | null
  leadTimeId: string | null
  postProcessingIds: number[]
  comments: { conversationType: 'REQUISITION_TAGGED'; message: string }[]
  constraints?: { constraintType: 'FIXED_ORIENTATION' }[]
  name: string | null
}

type CreateShipping =
  | { shippingMode: 'SELF_COLLECTION'; shippingMethodId: number; contactName?: string; contactPhoneNumber?: string }
  | { shippingMode: 'FIXED_PRICE'; shippingMethodId: number; rateId: string; toAddressId: number }
  | { shippingMode: 'CARRIER_ACCOUNT'; shippingMethodId: number; rateId: string; toAddressId: number }
  | { shippingMode: 'CUSTOMER_ACCOUNT'; shippingMethodId: number; toAddressId: number; accountNumber: string }

type PreOrder = {
  quote: Quote
  purchasability: Purchasability
  constraints: Record<string, object[]>
}

type Quote = {
  currency: string
  price: number                 // total
  subtotal: number
  shipping: number
  discount: number
  topUp: number | null          // amount added to reach the minimum order amount
  tax: {
    totalPrice: number
    totalPercentage: number
    components: { shortName: string; longName: string; percentage: number; amount: number }[]
    isTaxAppliedToShipping: boolean
    isTaxExempted: boolean
    isTaxReverseCharged: boolean
  }
  lineItems: { name: string; price: number }[]
  requisitions: Record<string, RequisitionQuote | null>   // null: no instant price for this line
  expectedDispatchDate: string | null
}

type RequisitionQuote = {
  partRevisionId: string
  quantity: number
  price: number
  unitPrice: number
  manufacturingPrice: number
  postProcessingPrice: number
  postProcessingOptions: { id: number; price: number }[]
}

type Purchasability = {
  canBePurchased: boolean       // false: offer "request a quote", not payment
  isPriceReviewRequired: boolean
  withinMaximumOrderValue: boolean
  withinBoundingBoxLimit: boolean
  withinWallThicknessLimit: boolean
  isMaterialPurchasable: boolean
  isPostProcessingPurchasable: boolean
  parts: Record<string, PartManufacturability>
}

type BulkQuote = { quantity: number; price: number; unitPrice: number; savingsPerUnit: number }