[idea] support openapi/swagger about mappersmith HOT 5 OPEN

forge({
  host: 'https://petstore.swagger.io/v2',
  resources: {
    Pet: {
      uploadImage: {
        method: 'post',
        path: '/pet/{petId}/uploadImage',
      },
      // No good name can be auto generated, relying on PUT = update
      update: {
        method: 'put',
        path: '/pet',
      },
      // No good name can be auto generated, relying on POST = create
      create: {
        method: 'post',
        path: '/pet',
      },
      findByStatus: {
        method: 'get',
        // Hard to express the required query parameters,
        // it would be better to hand roll it and require the user to provide the query parameters
        // path: '/pet/findByStatus/{status}',
        // even though that does not map to the actual API that we are auto-generating for
        path: '/pet/findByStatus',
      },
      // Probably need to suffix with "ByPetId" to distinguish it from potential GET /pet (if it existed)
      // Relying on GET = get, adding a (By + {petId}) camelized to separate it from vanilla "get" as mentioned above
      getByPetId: {
        method: 'get',
        path: '/pet/{petId}',
      },
      // This is another POST request, but it's not a good name.
      // Need to distinguish it from the other POST request "create".
      // But it looks strange to use Pet.createById vs Pet.create, and to add salt to injury
			// the swagger docs call this request "update pet" even though it is a post request, should have been a PUT
      createByPetId: {
        method: 'post',
        path: '/pet/{petId}',
      },
      // Similarly
      deleteByPetId: {
        method: 'delete',
        path: '/pet/{petId}',
      },
    },
    Store: {
      createOrder: {
        method: 'post',
        path: '/store/order',
      },
      getOrderByOrderId: {
        method: 'get',
        path: '/store/order/{orderId}',
      },
      deleteOrderByOrderId: {
        method: 'delete',
        path: '/store/order/{orderId}',
      },
      getStoreInventory: {
        method: 'get',
        path: '/store/inventory',
      },
    },
  },
});