chore(oas): PascalCase for schemas + remove x-resourceId (#2847)

### What

Rename all JSDoc OAS `@schema` and `$ref: #/components/schemas/` from snake_case to PascalCase, `foo_bar -> FooBar`

Extra scope: Remove `x-resourceId` from JSDoc OAS.

### Why

Classes use PascalCase as a convention but the OAS @schemas describing them were using snake_case. OAS code generators tend to use the schema name when generating typed models.

In order to avoid mismatch between source code, the OAS, and the generated client code, it is advised to align OAS @schemas formatting to the classes they represent.

Extra scope: x-resourceId is not a widely used OAS property. It's current usage in our OAS does not provide additional value. Therefore, we recommend to remove it in order to have one less item to maintain.

### How

Good old search & replace. Regex search to further make sure we didn't miss any.

The scope is limited to `@schema` definition and their usage in `$ref: #/components/schemas/`.

### Test

* Ran OAS validator.
* Ran docs build script.

Expect no visible changes to the documentation.

Resolves: CORE-852, CORE-859

packages/medusa/src/api/middlewares/await-middleware.ts

@@ -17,16 +17,15 @@ export default (fn: handler): RequestHandler => {
 }
 
 /**
- * @schema multiple_errors
+ * @schema MultipleErrors
  * title: "Multiple Errors"
- * x-resourceId: multiple_errors
  * type: object
  * properties:
  *  errors:
  *    type: array
  *    description: Array of errors
  *    items:
- *      $ref: "#/components/schemas/error"
+ *      $ref: "#/components/schemas/Error"
  *  message:
  *    type: string
  *    default: "Provided request body contains errors. Please check the data and retry the request"

packages/medusa/src/api/middlewares/error-handler.ts

@@ -79,9 +79,8 @@ export default () => {
 }
 
 /**
- * @schema error
+ * @schema Error
  * title: "Response Error"
- * x-resourceId: error
  * type: object
  * properties:
  *  code:

packages/medusa/src/api/routes/admin/auth/create-session.ts

@@ -65,7 +65,7 @@ import { validator } from "../../../../utils/validator"
  *          type: object
  *          properties:
  *            user:
- *              $ref: "#/components/schemas/user"
+ *              $ref: "#/components/schemas/User"
  *  "400":
  *    $ref: "#/components/responses/400_error"
  *  "401":

packages/medusa/src/api/routes/admin/auth/get-session.ts

@@ -37,7 +37,7 @@ import _ from "lodash"
  *          type: object
  *          properties:
  *            user:
- *              $ref: "#/components/schemas/user"
+ *              $ref: "#/components/schemas/User"
  *  "400":
  *    $ref: "#/components/responses/400_error"
  *  "401":

packages/medusa/src/api/routes/admin/batch/cancel-batch-job.ts

@@ -39,7 +39,7 @@ import { EntityManager } from "typeorm"
  *          type: object
  *          properties:
  *            batch_job:
- *              $ref: "#/components/schemas/batch_job"
+ *              $ref: "#/components/schemas/BatchJob"
  *  "400":
  *    $ref: "#/components/responses/400_error"
  *  "401":

packages/medusa/src/api/routes/admin/batch/confirm-batch-job.ts

@@ -39,7 +39,7 @@ import { EntityManager } from "typeorm"
  *          type: object
  *          properties:
  *            batch_job:
- *              $ref: "#/components/schemas/batch_job"
+ *              $ref: "#/components/schemas/BatchJob"
  *  "400":
  *    $ref: "#/components/responses/400_error"
  *  "401":

packages/medusa/src/api/routes/admin/batch/create-batch-job.ts

@@ -85,7 +85,7 @@ import { validator } from "../../../../utils/validator"
  *           type: object
  *           properties:
  *            batch_job:
- *              $ref: "#/components/schemas/batch_job"
+ *              $ref: "#/components/schemas/BatchJob"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/batch/get-batch-job.ts

@@ -36,7 +36,7 @@
  *          type: object
  *          properties:
  *            batch_job:
- *              $ref: "#/components/schemas/batch_job"
+ *              $ref: "#/components/schemas/BatchJob"
  *  "400":
  *    $ref: "#/components/responses/400_error"
  *  "401":

packages/medusa/src/api/routes/admin/batch/list-batch-jobs.ts

@@ -242,7 +242,7 @@ import { isDefined } from "medusa-core-utils"
  *            batch_jobs:
  *               type: array
  *               items:
- *                 $ref: "#/components/schemas/batch_job"
+ *                 $ref: "#/components/schemas/BatchJob"
  *            count:
  *               type: integer
  *               description: The total number of items available

packages/medusa/src/api/routes/admin/collections/add-products.ts

@@ -52,7 +52,7 @@ import ProductCollectionService from "../../../../services/product-collection"
  *          type: object
  *          properties:
  *            collection:
- *              $ref: "#/components/schemas/product_collection"
+ *              $ref: "#/components/schemas/ProductCollection"
  *  "400":
  *    $ref: "#/components/responses/400_error"
  *  "401":

packages/medusa/src/api/routes/admin/collections/create-collection.ts

@@ -62,7 +62,7 @@ import { EntityManager } from "typeorm"
  *          type: object
  *          properties:
  *            collection:
- *              $ref: "#/components/schemas/product_collection"
+ *              $ref: "#/components/schemas/ProductCollection"
  *  "400":
  *    $ref: "#/components/responses/400_error"
  *  "401":

packages/medusa/src/api/routes/admin/collections/get-collection.ts

@@ -2,6 +2,7 @@ import { Request, Response } from "express"
 
 import ProductCollectionService from "../../../../services/product-collection"
 import { defaultAdminCollectionsRelations } from "."
+
 /**
  * @oas [get] /collections/{id}
  * operationId: "GetCollectionsCollection"
@@ -40,7 +41,7 @@ import { defaultAdminCollectionsRelations } from "."
  *          type: object
  *          properties:
  *            collection:
- *              $ref: "#/components/schemas/product_collection"
+ *              $ref: "#/components/schemas/ProductCollection"
  *  "400":
  *    $ref: "#/components/responses/400_error"
  *  "401":

packages/medusa/src/api/routes/admin/collections/list-collections.ts

@@ -116,7 +116,7 @@ import { Type } from "class-transformer"
  *            collections:
  *               type: array
  *               items:
- *                 $ref: "#/components/schemas/product_collection"
+ *                 $ref: "#/components/schemas/ProductCollection"
  *            count:
  *               type: integer
  *               description: The total number of items available

packages/medusa/src/api/routes/admin/collections/update-collection.ts

@@ -62,7 +62,7 @@ import ProductCollectionService from "../../../../services/product-collection"
  *          type: object
  *          properties:
  *            collection:
- *              $ref: "#/components/schemas/product_collection"
+ *              $ref: "#/components/schemas/ProductCollection"
  *  "400":
  *    $ref: "#/components/responses/400_error"
  *  "401":

packages/medusa/src/api/routes/admin/currencies/list-currencies.ts

@@ -47,7 +47,7 @@ import { FeatureFlagDecorators } from "../../../../utils/feature-flag-decorators
  *             currencies:
  *               type: array
  *               items:
- *                 $ref: "#/components/schemas/currency"
+ *                 $ref: "#/components/schemas/Currency"
  *             count:
  *               type: integer
  *               description: The total number of items available

packages/medusa/src/api/routes/admin/currencies/update-currency.ts

@@ -55,7 +55,7 @@ import TaxInclusivePricingFeatureFlag from "../../../../loaders/feature-flags/ta
  *           type: object
  *           properties:
  *             currency:
- *                 $ref: "#/components/schemas/currency"
+ *                 $ref: "#/components/schemas/Currency"
  */
 export default async (req: ExtendedRequest<Currency>, res) => {
   const code = req.params.code as string

packages/medusa/src/api/routes/admin/customer-groups/add-customers-batch.ts

@@ -77,7 +77,7 @@ import { validator } from "../../../../utils/validator"
  *           type: object
  *           properties:
  *             customer_group:
- *               $ref: "#/components/schemas/customer_group"
+ *               $ref: "#/components/schemas/CustomerGroup"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/customer-groups/create-customer-group.ts

@@ -50,7 +50,7 @@ import { validator } from "../../../../utils/validator"
  *           type: object
  *           properties:
  *             customer_group:
- *               $ref: "#/components/schemas/customer_group"
+ *               $ref: "#/components/schemas/CustomerGroup"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/customer-groups/delete-customers-batch.ts

@@ -77,7 +77,7 @@ import { validator } from "../../../../utils/validator"
  *           type: object
  *           properties:
  *             customer_group:
- *               $ref: "#/components/schemas/customer_group"
+ *               $ref: "#/components/schemas/CustomerGroup"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/customer-groups/get-customer-group-customers.ts

@@ -42,7 +42,7 @@ import CustomerController from "../../../../controllers/customers"
  *             customers:
  *               type: array
  *               items:
- *                  $ref: "#/components/schemas/customer"
+ *                  $ref: "#/components/schemas/Customer"
  *             count:
  *               type: integer
  *               description: The total number of items available

packages/medusa/src/api/routes/admin/customer-groups/get-customer-group.ts

@@ -43,7 +43,7 @@ import { FindParams } from "../../../../types/common"
  *           type: object
  *           properties:
  *             customer_group:
- *               $ref: "#/components/schemas/customer_group"
+ *               $ref: "#/components/schemas/CustomerGroup"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/customer-groups/list-customer-groups.ts

@@ -132,7 +132,7 @@ import { Type } from "class-transformer"
  *             customer_groups:
  *               type: array
  *               items:
- *                 $ref: "#/components/schemas/customer_group"
+ *                 $ref: "#/components/schemas/CustomerGroup"
  *             count:
  *               type: integer
  *               description: The total number of items available

packages/medusa/src/api/routes/admin/customer-groups/update-customer-group.ts

@@ -63,7 +63,7 @@ import { validator } from "../../../../utils/validator"
  *           type: object
  *           properties:
  *             customer_group:
- *               $ref: "#/components/schemas/customer_group"
+ *               $ref: "#/components/schemas/CustomerGroup"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/customers/create-customer.ts

@@ -83,7 +83,7 @@ import { EntityManager } from "typeorm"
  *           type: object
  *           properties:
  *             customer:
- *               $ref: "#/components/schemas/customer"
+ *               $ref: "#/components/schemas/Customer"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/customers/get-customer.ts

@@ -43,7 +43,7 @@ import { validator } from "../../../../utils/validator"
  *           type: object
  *           properties:
  *             customer:
- *               $ref: "#/components/schemas/customer"
+ *               $ref: "#/components/schemas/Customer"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/customers/list-customers.ts

@@ -48,7 +48,7 @@ import customerController from "../../../../controllers/customers"
  *             customers:
  *               type: array
  *               items:
- *                 $ref: "#/components/schemas/customer"
+ *                 $ref: "#/components/schemas/Customer"
  *             count:
  *               type: integer
  *               description: The total number of items available

packages/medusa/src/api/routes/admin/customers/update-customer.ts

@@ -97,7 +97,7 @@ import { validator } from "../../../../utils/validator"
  *           type: object
  *           properties:
  *             customer:
- *               $ref: "#/components/schemas/customer"
+ *               $ref: "#/components/schemas/Customer"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/discounts/add-region.ts

@@ -43,7 +43,7 @@ import { EntityManager } from "typeorm"
  *           type: object
  *           properties:
  *             discount:
- *               $ref: "#/components/schemas/discount"
+ *               $ref: "#/components/schemas/Discount"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/discounts/add-resources-to-condition-batch.ts

@@ -74,7 +74,7 @@ import { FindParams } from "../../../../types/common"
  *           type: object
  *           properties:
  *             discount:
- *               $ref: "#/components/schemas/discount"
+ *               $ref: "#/components/schemas/Discount"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/discounts/create-condition.ts

@@ -92,7 +92,7 @@ import { FindParams } from "../../../../types/common"
  *           type: object
  *           properties:
  *             discount:
- *               $ref: "#/components/schemas/discount"
+ *               $ref: "#/components/schemas/Discount"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/discounts/create-discount.ts

@@ -152,7 +152,7 @@ import { FindParams } from "../../../../types/common"
  *           value: 10,
  *           allocation: AllocationType.ITEM
  *         },
- *         regions: ['reg_XXXXXXXX'],
+ *         regions: ["reg_XXXXXXXX"],
  *         is_dynamic: false,
  *         is_disabled: false
  *       })
@@ -172,7 +172,7 @@ import { FindParams } from "../../../../types/common"
  *              "value": 10,
  *              "allocation": "item"
  *           },
- *           "regions": ['reg_XXXXXXXX']
+ *           "regions": ["reg_XXXXXXXX"]
  *       }'
  * security:
  *   - api_token: []
@@ -188,7 +188,7 @@ import { FindParams } from "../../../../types/common"
  *           type: object
  *           properties:
  *             discount:
- *               $ref: "#/components/schemas/discount"
+ *               $ref: "#/components/schemas/Discount"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/discounts/create-dynamic-code.ts

@@ -59,7 +59,7 @@ import { EntityManager } from "typeorm"
  *           type: object
  *           properties:
  *             discount:
- *               $ref: "#/components/schemas/discount"
+ *               $ref: "#/components/schemas/Discount"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/discounts/delete-condition.ts

@@ -57,7 +57,7 @@ import { FindParams } from "../../../../types/common"
  *               default: true
  *             discount:
  *               description: The Discount to which the condition used to belong
- *               $ref: "#/components/schemas/discount"
+ *               $ref: "#/components/schemas/Discount"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/discounts/delete-dynamic-code.ts

@@ -42,7 +42,7 @@ import { EntityManager } from "typeorm"
  *           type: object
  *           properties:
  *             discount:
- *               $ref: "#/components/schemas/discount"
+ *               $ref: "#/components/schemas/Discount"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/discounts/delete-resources-from-condition-batch.ts

@@ -73,7 +73,7 @@ import { FindParams } from "../../../../types/common"
  *           type: object
  *           properties:
  *             discount:
- *               $ref: "#/components/schemas/discount"
+ *               $ref: "#/components/schemas/Discount"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/discounts/get-condition.ts

@@ -43,7 +43,7 @@ import { FindParams } from "../../../../types/common"
  *           type: object
  *           properties:
  *             discount_condition:
- *               $ref: "#/components/schemas/discount_condition"
+ *               $ref: "#/components/schemas/DiscountCondition"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/discounts/get-discount-by-code.ts

@@ -42,7 +42,7 @@ import { FindParams } from "../../../../types/common"
  *           type: object
  *           properties:
  *             discount:
- *               $ref: "#/components/schemas/discount"
+ *               $ref: "#/components/schemas/Discount"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/discounts/get-discount.ts

@@ -42,7 +42,7 @@ import { FindParams } from "../../../../types/common"
  *           type: object
  *           properties:
  *             discount:
- *               $ref: "#/components/schemas/discount"
+ *               $ref: "#/components/schemas/Discount"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/discounts/list-discounts.ts

@@ -71,7 +71,7 @@ import { optionalBooleanMapper } from "../../../../utils/validators/is-boolean"
  *             discounts:
  *               type: array
  *               items:
- *                 $ref: "#/components/schemas/discount"
+ *                 $ref: "#/components/schemas/Discount"
  *             count:
  *               type: integer
  *               description: The total number of items available

packages/medusa/src/api/routes/admin/discounts/remove-region.ts

@@ -42,7 +42,7 @@ import { EntityManager } from "typeorm"
  *           type: object
  *           properties:
  *             discount:
- *               $ref: "#/components/schemas/discount"
+ *               $ref: "#/components/schemas/Discount"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/discounts/update-condition.ts

@@ -87,7 +87,7 @@ import { FindParams } from "../../../../types/common"
  *           type: object
  *           properties:
  *             discount:
- *               $ref: "#/components/schemas/discount"
+ *               $ref: "#/components/schemas/Discount"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/discounts/update-discount.ts

@@ -162,7 +162,7 @@ import { FindParams } from "../../../../types/common"
  *           type: object
  *           properties:
  *             discount:
- *               $ref: "#/components/schemas/discount"
+ *               $ref: "#/components/schemas/Discount"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/draft-orders/create-draft-order.ts

@@ -25,6 +25,7 @@ import { AddressPayload } from "../../../../types/common"
 import { DraftOrderCreateProps } from "../../../../types/draft-orders"
 import { validator } from "../../../../utils/validator"
 import { IsType } from "../../../../utils/validators/is-type"
+
 /**
  * @oas [post] /draft-orders
  * operationId: "PostDraftOrders"
@@ -53,12 +54,12 @@ import { IsType } from "../../../../utils/validators/is-type"
  *           billing_address:
  *             description: "The Address to be used for billing purposes."
  *             anyOf:
- *               - $ref: "#/components/schemas/address_fields"
+ *               - $ref: "#/components/schemas/AddressFields"
  *               - type: string
  *           shipping_address:
  *             description: "The Address to be used for shipping."
  *             anyOf:
- *               - $ref: "#/components/schemas/address_fields"
+ *               - $ref: "#/components/schemas/AddressFields"
  *               - type: string
  *           items:
  *             description: The Line Items that have been received.
@@ -181,7 +182,7 @@ import { IsType } from "../../../../utils/validators/is-type"
  *           type: object
  *           properties:
  *             draft_order:
- *               $ref: "#/components/schemas/draft-order"
+ *               $ref: "#/components/schemas/DraftOrder"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/draft-orders/create-line-item.ts

@@ -82,7 +82,7 @@ import { validator } from "../../../../utils/validator"
  *           type: object
  *           properties:
  *             draft_order:
- *               $ref: "#/components/schemas/draft-order"
+ *               $ref: "#/components/schemas/DraftOrder"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/draft-orders/delete-line-item.ts

@@ -48,7 +48,7 @@ import { MedusaError } from "medusa-core-utils"
  *           type: object
  *           properties:
  *             draft_order:
- *               $ref: "#/components/schemas/draft-order"
+ *               $ref: "#/components/schemas/DraftOrder"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/draft-orders/get-draft-order.ts

@@ -46,7 +46,7 @@ import { DraftOrder } from "../../../.."
  *           type: object
  *           properties:
  *             draft_order:
- *               $ref: "#/components/schemas/draft-order"
+ *               $ref: "#/components/schemas/DraftOrder"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/draft-orders/list-draft-orders.ts

@@ -53,7 +53,7 @@ import { validator } from "../../../../utils/validator"
  *             draft_orders:
  *               type: array
  *               items:
- *                 $ref: "#/components/schemas/draft-order"
+ *                 $ref: "#/components/schemas/DraftOrder"
  *             count:
  *               type: integer
  *               description: The total number of items available

packages/medusa/src/api/routes/admin/draft-orders/register-payment.ts

@@ -49,7 +49,7 @@ import { EntityManager } from "typeorm"
  *           type: object
  *           properties:
  *             order:
- *               $ref: "#/components/schemas/draft-order"
+ *               $ref: "#/components/schemas/DraftOrder"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/draft-orders/update-draft-order.ts

@@ -19,6 +19,7 @@ import { CartUpdateProps } from "../../../../types/cart"
 import { AddressPayload } from "../../../../types/common"
 import { validator } from "../../../../utils/validator"
 import { IsType } from "../../../../utils/validators/is-type"
+
 /**
  * @oas [post] /admin/draft-orders/{id}
  * operationId: PostDraftOrdersDraftOrder
@@ -49,12 +50,12 @@ import { IsType } from "../../../../utils/validators/is-type"
  *           billing_address:
  *             description: "The Address to be used for billing purposes."
  *             anyOf:
- *               - $ref: "#/components/schemas/address_fields"
+ *               - $ref: "#/components/schemas/AddressFields"
  *               - type: string
  *           shipping_address:
  *             description: "The Address to be used for shipping."
  *             anyOf:
- *               - $ref: "#/components/schemas/address_fields"
+ *               - $ref: "#/components/schemas/AddressFields"
  *               - type: string
  *           discounts:
  *             description: "An array of Discount codes to add to the Draft Order."
@@ -109,7 +110,7 @@ import { IsType } from "../../../../utils/validators/is-type"
  *           type: object
  *           properties:
  *             draft_order:
- *               $ref: "#/components/schemas/draft-order"
+ *               $ref: "#/components/schemas/DraftOrder"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/draft-orders/update-line-item.ts

@@ -75,7 +75,7 @@ import { validator } from "../../../../utils/validator"
  *           type: object
  *           properties:
  *             draft_order:
- *               $ref: "#/components/schemas/draft-order"
+ *               $ref: "#/components/schemas/DraftOrder"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/gift-cards/create-gift-card.ts

@@ -72,7 +72,7 @@ import { EntityManager } from "typeorm"
  *           type: object
  *           properties:
  *             gift_card:
- *               $ref: "#/components/schemas/gift_card"
+ *               $ref: "#/components/schemas/GiftCard"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/gift-cards/get-gift-card.ts

@@ -38,7 +38,7 @@ import { defaultAdminGiftCardFields, defaultAdminGiftCardRelations } from "./"
  *           type: object
  *           properties:
  *             gift_card:
- *               $ref: "#/components/schemas/gift_card"
+ *               $ref: "#/components/schemas/GiftCard"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/gift-cards/list-gift-cards.ts

@@ -48,7 +48,7 @@ import { isDefined } from "medusa-core-utils"
  *             gift_cards:
  *               type: array
  *               items:
- *                 $ref: "#/components/schemas/gift_card"
+ *                 $ref: "#/components/schemas/GiftCard"
  *             count:
  *               type: integer
  *               description: The total number of items available

packages/medusa/src/api/routes/admin/gift-cards/update-gift-card.ts

@@ -72,7 +72,7 @@ import { EntityManager } from "typeorm"
  *           type: object
  *           properties:
  *             gift_card:
- *               $ref: "#/components/schemas/gift_card"
+ *               $ref: "#/components/schemas/GiftCard"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/invites/list-invites.ts

@@ -38,7 +38,7 @@ import InviteService from "../../../../services/invite"
  *             invites:
  *               type: array
  *               items:
- *                 $ref: "#/components/schemas/invite"
+ *                 $ref: "#/components/schemas/Invite"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/notes/create-note.ts

@@ -69,7 +69,7 @@ import { EntityManager } from "typeorm"
  *           type: object
  *           properties:
  *             note:
- *               $ref: "#/components/schemas/note"
+ *               $ref: "#/components/schemas/Note"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/notes/get-note.ts

@@ -38,7 +38,7 @@ import NoteService from "../../../../services/note"
  *           type: object
  *           properties:
  *             note:
- *               $ref: "#/components/schemas/note"
+ *               $ref: "#/components/schemas/Note"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/notes/list-notes.ts

@@ -47,7 +47,7 @@ import { validator } from "../../../../utils/validator"
  *             notes:
  *               type: array
  *               items:
- *                 $ref: "#/components/schemas/note"
+ *                 $ref: "#/components/schemas/Note"
  *             count:
  *               type: integer
  *               description: The total number of items available

packages/medusa/src/api/routes/admin/notes/update-note.ts

@@ -58,7 +58,7 @@ import { EntityManager } from "typeorm"
  *           type: object
  *           properties:
  *             note:
- *               $ref: "#/components/schemas/note"
+ *               $ref: "#/components/schemas/Note"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/notifications/list-notifications.ts

@@ -59,7 +59,7 @@ import { validator } from "../../../../utils/validator"
  *             notifications:
  *               type: array
  *               items:
- *                 $ref: "#/components/schemas/notification"
+ *                 $ref: "#/components/schemas/Notification"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/notifications/resend-notification.ts

@@ -4,8 +4,7 @@ import {
 } from "."
 
 import { EntityManager } from "typeorm"
-import { IsOptional } from "class-validator"
-import { IsString } from "class-validator"
+import { IsOptional, IsString } from "class-validator"
 import { Notification } from "../../../../models"
 import { NotificationService } from "../../../../services"
 import { validator } from "../../../../utils/validator"
@@ -57,7 +56,7 @@ import { validator } from "../../../../utils/validator"
  *           type: object
  *           properties:
  *             notification:
- *               $ref: "#/components/schemas/notification"
+ *               $ref: "#/components/schemas/Notification"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/order-edits/add-line-item.ts

@@ -42,8 +42,8 @@ import {
  *       const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
  *       // must be previously logged in or use api token
  *       medusa.admin.orderEdits.addLineItem(order_edit_id, {
- *         variant_id, 
- *         quantity 
+ *         variant_id,
+ *         quantity
  *       })
  *       .then(({ order_edit }) => {
  *          console.log(order_edit.id)
@@ -69,7 +69,7 @@ import {
  *           type: object
  *           properties:
  *             order_edit:
- *               $ref: "#/components/schemas/order_edit"
+ *               $ref: "#/components/schemas/OrderEdit"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/order-edits/cancel-order-edit.ts

@@ -44,7 +44,7 @@ import {
  *           type: object
  *           properties:
  *             order_edit:
- *               $ref: "#/components/schemas/order_edit"
+ *               $ref: "#/components/schemas/OrderEdit"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/order-edits/confirm-order-edit.ts

@@ -44,7 +44,7 @@ import {
  *           type: object
  *           properties:
  *             order_edit:
- *               $ref: "#/components/schemas/order_edit"
+ *               $ref: "#/components/schemas/OrderEdit"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/order-edits/create-order-edit.ts

@@ -59,7 +59,7 @@ import {
  *           type: object
  *           properties:
  *             order_edit:
- *               $ref: "#/components/schemas/order_edit"
+ *               $ref: "#/components/schemas/OrderEdit"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/order-edits/delete-line-item.ts

@@ -1,7 +1,6 @@
 import { EntityManager } from "typeorm"
 import { OrderEditService } from "../../../../services"
 import { Request, Response } from "express"
-import { IsNumber } from "class-validator"
 import {
   defaultOrderEditFields,
   defaultOrderEditRelations,
@@ -46,7 +45,7 @@ import {
  *           type: object
  *           properties:
  *             order_edit:
- *               $ref: "#/components/schemas/order_edit"
+ *               $ref: "#/components/schemas/OrderEdit"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/order-edits/get-order-edit.ts

@@ -42,7 +42,7 @@ import { FindParams } from "../../../../types/common"
  *           type: object
  *           properties:
  *             order_edit:
- *               $ref: "#/components/schemas/order_edit"
+ *               $ref: "#/components/schemas/OrderEdit"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/order-edits/list-order-edit.ts

@@ -47,7 +47,7 @@ import { IsOptional, IsString } from "class-validator"
  *           properties:
  *             order_edits:
  *               type: array
- *               $ref: "#/components/schemas/order_edit"
+ *               $ref: "#/components/schemas/OrderEdit"
  *             count:
  *               type: integer
  *               description: The total number of items available

packages/medusa/src/api/routes/admin/order-edits/request-confirmation.ts

@@ -1,5 +1,5 @@
 import { EntityManager } from "typeorm"
-import { IsOptional, IsString, IsObject } from "class-validator"
+import { IsOptional, IsString } from "class-validator"
 import {
   OrderEditService,
   OrderService,
@@ -49,7 +49,7 @@ import { PaymentCollectionType } from "../../../../models"
  *           type: object
  *           properties:
  *             order_edit:
- *               $ref: "#/components/schemas/order_edit"
+ *               $ref: "#/components/schemas/OrderEdit"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/order-edits/update-order-edit-line-item.ts

@@ -61,7 +61,7 @@ import {
  *           type: object
  *           properties:
  *             order_edit:
- *               $ref: "#/components/schemas/order_edit"
+ *               $ref: "#/components/schemas/OrderEdit"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/order-edits/update-order-edit.ts

@@ -61,7 +61,7 @@ import {
  *           type: object
  *           properties:
  *             order_edit:
- *               $ref: "#/components/schemas/order_edit"
+ *               $ref: "#/components/schemas/OrderEdit"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/orders/add-shipping-method.ts

@@ -60,7 +60,7 @@ import { EntityManager } from "typeorm"
  *           type: object
  *           properties:
  *             order:
- *               $ref: "#/components/schemas/order"
+ *               $ref: "#/components/schemas/Order"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/orders/archive-order.ts

@@ -39,7 +39,7 @@ import { EntityManager } from "typeorm"
  *           type: object
  *           properties:
  *             order:
- *               $ref: "#/components/schemas/order"
+ *               $ref: "#/components/schemas/Order"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/orders/cancel-claim.ts

@@ -43,7 +43,7 @@ import { MedusaError } from "medusa-core-utils"
  *           type: object
  *           properties:
  *             order:
- *               $ref: "#/components/schemas/order"
+ *               $ref: "#/components/schemas/Order"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/orders/cancel-fulfillment-claim.ts

@@ -48,7 +48,7 @@ import { MedusaError } from "medusa-core-utils"
  *           type: object
  *           properties:
  *             order:
- *               $ref: "#/components/schemas/order"
+ *               $ref: "#/components/schemas/Order"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/orders/cancel-fulfillment-swap.ts

@@ -48,7 +48,7 @@ import { MedusaError } from "medusa-core-utils"
  *           type: object
  *           properties:
  *             order:
- *               $ref: "#/components/schemas/order"
+ *               $ref: "#/components/schemas/Order"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/orders/cancel-fulfillment.ts

@@ -43,7 +43,7 @@ import { MedusaError } from "medusa-core-utils"
  *           type: object
  *           properties:
  *             order:
- *               $ref: "#/components/schemas/order"
+ *               $ref: "#/components/schemas/Order"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/orders/cancel-order.ts

@@ -41,7 +41,7 @@ import { EntityManager } from "typeorm"
  *           type: object
  *           properties:
  *             order:
- *               $ref: "#/components/schemas/order"
+ *               $ref: "#/components/schemas/Order"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/orders/cancel-swap.ts

@@ -43,7 +43,7 @@ import { MedusaError } from "medusa-core-utils"
  *           type: object
  *           properties:
  *             order:
- *               $ref: "#/components/schemas/order"
+ *               $ref: "#/components/schemas/Order"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/orders/capture-payment.ts

@@ -41,7 +41,7 @@ import { EntityManager } from "typeorm"
  *           type: object
  *           properties:
  *             order:
- *               $ref: "#/components/schemas/order"
+ *               $ref: "#/components/schemas/Order"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/orders/complete-order.ts

@@ -39,7 +39,7 @@ import { EntityManager } from "typeorm"
  *           type: object
  *           properties:
  *             order:
- *               $ref: "#/components/schemas/order"
+ *               $ref: "#/components/schemas/Order"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/orders/create-claim-shipment.ts

@@ -66,7 +66,7 @@ import { EntityManager } from "typeorm"
  *           type: object
  *           properties:
  *             order:
- *               $ref: "#/components/schemas/order"
+ *               $ref: "#/components/schemas/Order"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/orders/create-claim.ts

@@ -117,7 +117,7 @@ import { validator } from "../../../../utils/validator"
  *           shipping_address:
  *              type: object
  *              description: "An optional shipping address to send the claim to. Defaults to the parent order's shipping address"
- *              $ref: "#/components/schemas/address"
+ *              $ref: "#/components/schemas/Address"
  *           refund_amount:
  *              description: The amount to refund the Customer when the Claim type is `refund`.
  *              type: integer
@@ -175,7 +175,7 @@ import { validator } from "../../../../utils/validator"
  *           type: object
  *           properties:
  *             order:
- *               $ref: "#/components/schemas/order"
+ *               $ref: "#/components/schemas/Order"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/orders/create-fulfillment.ts

@@ -98,7 +98,7 @@ import { optionalBooleanMapper } from "../../../../utils/validators/is-boolean"
  *           type: object
  *           properties:
  *             order:
- *               $ref: "#/components/schemas/order"
+ *               $ref: "#/components/schemas/Order"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/orders/create-shipment.ts

@@ -75,7 +75,7 @@ import { validator } from "../../../../utils/validator"
  *           type: object
  *           properties:
  *             order:
- *               $ref: "#/components/schemas/order"
+ *               $ref: "#/components/schemas/Order"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/orders/create-swap-shipment.ts

@@ -75,7 +75,7 @@ import { validator } from "../../../../utils/validator"
  *           type: object
  *           properties:
  *             order:
- *               $ref: "#/components/schemas/order"
+ *               $ref: "#/components/schemas/Order"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/orders/create-swap.ts

@@ -152,7 +152,7 @@ import { validator } from "../../../../utils/validator"
  *           type: object
  *           properties:
  *             order:
- *               $ref: "#/components/schemas/order"
+ *               $ref: "#/components/schemas/Order"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/orders/fulfill-claim.ts

@@ -56,7 +56,7 @@ import { validator } from "../../../../utils/validator"
  *           type: object
  *           properties:
  *             order:
- *               $ref: "#/components/schemas/order"
+ *               $ref: "#/components/schemas/Order"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/orders/fulfill-swap.ts

@@ -56,7 +56,7 @@ import { validator } from "../../../../utils/validator"
  *           type: object
  *           properties:
  *             order:
- *               $ref: "#/components/schemas/order"
+ *               $ref: "#/components/schemas/Order"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/orders/get-order.ts

@@ -38,7 +38,7 @@ import { OrderService } from "../../../../services"
  *           type: object
  *           properties:
  *             order:
- *               $ref: "#/components/schemas/order"
+ *               $ref: "#/components/schemas/Order"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/orders/list-orders.ts

@@ -185,7 +185,7 @@ import { pick } from "lodash"
  *             orders:
  *               type: array
  *               items:
- *                 $ref: "#/components/schemas/order"
+ *                 $ref: "#/components/schemas/Order"
  *             count:
  *               type: integer
  *               description: The total number of items available

packages/medusa/src/api/routes/admin/orders/process-swap-payment.ts

@@ -42,7 +42,7 @@ import { EntityManager } from "typeorm"
  *           type: object
  *           properties:
  *             order:
- *               $ref: "#/components/schemas/order"
+ *               $ref: "#/components/schemas/Order"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/orders/refund-payment.ts

@@ -78,7 +78,7 @@ import { EntityManager } from "typeorm"
  *           type: object
  *           properties:
  *             order:
- *               $ref: "#/components/schemas/order"
+ *               $ref: "#/components/schemas/Order"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/orders/request-return.ts

@@ -126,7 +126,7 @@ import { validator } from "../../../../utils/validator"
  *           type: object
  *           properties:
  *             order:
- *               $ref: "#/components/schemas/order"
+ *               $ref: "#/components/schemas/Order"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/orders/update-claim.ts

@@ -142,7 +142,7 @@ import { EntityManager } from "typeorm"
  *           type: object
  *           properties:
  *             order:
- *               $ref: "#/components/schemas/order"
+ *               $ref: "#/components/schemas/Order"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/orders/update-order.ts

@@ -36,16 +36,16 @@ import { validator } from "../../../../utils/validator"
  *           billing_address:
  *             description: Billing address
  *             anyOf:
- *               - $ref: "#/components/schemas/address_fields"
+ *               - $ref: "#/components/schemas/AddressFields"
  *           shipping_address:
  *             description: Shipping address
  *             anyOf:
- *               - $ref: "#/components/schemas/address_fields"
+ *               - $ref: "#/components/schemas/AddressFields"
  *           items:
  *             description: The Line Items for the order
  *             type: array
  *             items:
- *               $ref: "#/components/schemas/line_item"
+ *               $ref: "#/components/schemas/LineItem"
  *           region:
  *             description: ID of the region where the order belongs
  *             type: string
@@ -53,7 +53,7 @@ import { validator } from "../../../../utils/validator"
  *             description: Discounts applied to the order
  *             type: array
  *             items:
- *               $ref: "#/components/schemas/discount"
+ *               $ref: "#/components/schemas/Discount"
  *           customer_id:
  *             description: ID of the customer
  *             type: string
@@ -86,7 +86,7 @@ import { validator } from "../../../../utils/validator"
  *               items:
  *                 type: array
  *                 items:
- *                   $ref: "#/components/schemas/line_item"
+ *                   $ref: "#/components/schemas/LineItem"
  *                 description: Items to ship
  *           no_notification:
  *             description: A flag to indicate if no notifications should be emitted related to the updated order.
@@ -127,7 +127,7 @@ import { validator } from "../../../../utils/validator"
  *           type: object
  *           properties:
  *             order:
- *               $ref: "#/components/schemas/order"
+ *               $ref: "#/components/schemas/Order"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/payment-collections/get-payment-collection.ts

@@ -41,7 +41,7 @@ import { FindParams } from "../../../../types/common"
  *           type: object
  *           properties:
  *             payment_collection:
- *               $ref: "#/components/schemas/payment_collection"
+ *               $ref: "#/components/schemas/PaymentCollection"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/payment-collections/mark-authorized-payment-collection.ts

@@ -39,7 +39,7 @@ import { PaymentCollectionService } from "../../../../services"
  *           type: object
  *           properties:
  *             payment_collection:
- *               $ref: "#/components/schemas/payment_collection"
+ *               $ref: "#/components/schemas/PaymentCollection"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/payment-collections/update-payment-collection.ts

@@ -59,7 +59,7 @@ import { PaymentCollectionService } from "../../../../services"
  *           type: object
  *           properties:
  *             payment_collection:
- *               $ref: "#/components/schemas/payment_collection"
+ *               $ref: "#/components/schemas/PaymentCollection"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

packages/medusa/src/api/routes/admin/payments/capture-payment.ts

@@ -38,7 +38,7 @@ import { PaymentService } from "../../../../services"
  *           type: object
  *           properties:
  *             payment:
- *               $ref: "#/components/schemas/payment"
+ *               $ref: "#/components/schemas/Payment"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":