docs: oas (#197)

Adds OpenAPI specification of Storefront and Admin APIs.
Updates docs project.

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

@@ -1,3 +1,23 @@
+/**
+ * @oas [delete] /discounts/{id}/dynamic-codes/{code}
+ * operationId: "DeleteDiscountsDiscountDynamicCodesCode"
+ * summary: "Delete a dynamic code"
+ * description: "Deletes a dynamic code from a Discount."
+ * parameters:
+ *   - (path) id=* {string} The id of the Discount
+ *   - (path) code=* {string} The id of the Discount
+ * tags:
+ *   - Discount
+ * responses:
+ *   200:
+ *     description: OK
+ *     content:
+ *       application/json:
+ *         schema:
+ *           properties:
+ *             discount:
+ *               $ref: "#/components/schemas/discount"
+ */
 export default async (req, res) => {
   const { discount_id, code } = req.params