chore(oas): [18/n] improve oas schemas (#9311)

Improve OAS schemas [18/n]

www/utils/generated/oas-output/schemas/StoreCartAddress.ts

@@ -1,7 +1,7 @@
 /**
  * @schema StoreCartAddress
  * type: object
- * description: The cart's billing address.
+ * description: The address's details.
  * x-schemaName: StoreCartAddress
  * required:
  *   - id
@@ -11,72 +11,65 @@
  *   id:
  *     type: string
  *     title: id
- *     description: The billing address's ID.
+ *     description: The address's ID.
  *   customer_id:
  *     type: string
  *     title: customer_id
- *     description: The billing address's customer id.
+ *     description: The ID of the customer the address belongs to.
  *   first_name:
  *     type: string
  *     title: first_name
- *     description: The billing address's first name.
+ *     description: The address's first name.
  *   last_name:
  *     type: string
  *     title: last_name
- *     description: The billing address's last name.
+ *     description: The address's last name.
  *   phone:
  *     type: string
  *     title: phone
- *     description: The billing address's phone.
+ *     description: The address's phone.
  *   company:
  *     type: string
  *     title: company
- *     description: The billing address's company.
+ *     description: The address's company.
  *   address_1:
  *     type: string
  *     title: address_1
- *     description: The billing address's address 1.
+ *     description: The address's first line.
  *   address_2:
  *     type: string
  *     title: address_2
- *     description: The billing address's address 2.
+ *     description: The address's second line.
  *   city:
  *     type: string
  *     title: city
- *     description: The billing address's city.
+ *     description: The address's city.
  *   country_code:
  *     type: string
  *     title: country_code
- *     description: The billing address's country code.
+ *     description: The address's country code.
+ *     example: us
  *   province:
  *     type: string
  *     title: province
- *     description: The billing address's province.
+ *     description: The address's province.
  *   postal_code:
  *     type: string
  *     title: postal_code
- *     description: The billing address's postal code.
+ *     description: The address's postal code.
  *   metadata:
  *     type: object
- *     description: The billing address's metadata.
+ *     description: The address's metadata, can hold custom key-value pairs.
  *   created_at:
- *     oneOf:
- *       - type: string
- *         title: created_at
- *         description: The billing address's created at.
- *       - type: string
- *         title: created_at
- *         description: The billing address's created at.
- *         format: date-time
+ *     type: string
+ *     title: created_at
+ *     description: The date the address was created.
+ *     format: date-time
  *   updated_at:
- *     oneOf:
- *       - type: string
- *         title: updated_at
- *         description: The billing address's updated at.
- *       - type: string
- *         title: updated_at
- *         description: The billing address's updated at.
- *         format: date-time
+ *     type: string
+ *     title: updated_at
+ *     description: The date the address was updated.
+ *     format: date-time
  * 
 */