rest

type Item struct {
	// ID is the item identifier.
	// in: body
	ID string `json:"id"`

	// Name is the item name.
	// in: body
	Name string `json:"name"`

	// Description is the item description.
	// in: body
	Description string `json:"description"`

	// OwnerID is the PlayerID of the item owner.
	// in:body
	OwnerID string `json:"ownerID"`

	// LocationID is the LocationID of the item's location.
	// in: body
	LocationID ItemLocationID `json:"locationID"`

	// Created is the time of the item's creation.
	// in: body
	Created arcade.Timestamp `json:"created"`

	// Updated is the time the item was last updated.
	// in: body
	Updated arcade.Timestamp `json:"updated"`
}

type ItemCreateRequest struct {
	ItemRequest
}

type ItemLocationID struct {
	// ID is the location identifier. This can correspond the the ID of a room, player or item.
	// in: body
	ID string `json:"id"`

	// Type is the type of location. This can be "room", "player" or "item".
	Type string `json:"type"`
}

type ItemRequest struct {
	// Name is the name of the item.
	// in: body
	// minimum length: 1
	// maximum length: 256
	Name string `json:"name"`

	// Description is the description of the item.
	// in: body
	// minimum length: 1
	// maximum length: 4096
	Description string `json:"description"`

	// OwnerID is the ID of the owner of the item.
	// in: body
	// minimum length: 1
	// maximum length: 4096
	OwnerID string `json:"ownerID"`

	// LocationID is the ID of the location of the item.
	// in: body
	LocationID ItemLocationID `json:"locationID"`
}

type ItemResponse struct {
	// Item returns the information about an item.
	// in: body
	Item Item `json:"item"`
}

type ItemUpdateRequest struct {
	ItemRequest
}

type ItemsResponse struct {
	// Items returns the information about multiple items.
	// in: body
	Items []Item `json:"items"`
}

type Link struct {
	// ID is the link identifier.
	// in: body
	ID string `json:"id"`

	// Name is the link name.
	// in: body
	Name string `json:"name"`

	// Description is the link description.
	// in: body
	Description string `json:"description"`

	// OwnerID is the PlayerID of the link owner.
	// in:body
	OwnerID string `json:"ownerID"`

	// LocationID is the RoomID of the link's location.
	// in: body
	LocationID string `json:"locationID"`

	// DestinationID is the RoomID of the link's destination.
	// in: body
	DestinationID string `json:"destinationID"`

	// Created is the time of the link's creation.
	// in: body
	Created arcade.Timestamp `json:"created"`

	// Updated is the time the link was last updated.
	// in: body
	Updated arcade.Timestamp `json:"updated"`
}

type LinkCreateRequest struct {
	LinkRequest
}

type LinkRequest struct {
	// Name is the name of the link.
	// in: body
	// minimum length: 1
	// maximum length: 256
	Name string `json:"name"`

	// Description is the description of the link.
	// in: body
	// minimum length: 1
	// maximum length: 4096
	Description string `json:"description"`

	// OwnerID is the ID of the owner of the link.
	// in: body
	// minimum length: 1
	// maximum length: 4096
	OwnerID string `json:"ownerID"`

	// LocationID is the ID of the location of the link.
	// in: body
	LocationID string `json:"locationID"`

	// DestinationID is the ID of the destination of the link.
	// in: body
	DestinationID string `json:"destinationID"`
}

type LinkResponse struct {
	// Link returns the information about a link.
	// in: body
	Link Link `json:"link"`
}

type LinkUpdateRequest struct {
	LinkRequest
}

type LinksResponse struct {
	// Links returns the information about multiple links.
	// in: body
	Links []Link `json:"links"`
}

type Player struct {
	// ID is the player identifier.
	// in: body
	ID string `json:"id"`

	// Name is the player name.
	// in: body
	Name string `json:"name"`

	// Description is the player description.
	// in: body
	Description string `json:"description"`

	// HomeID is the RoomID of the player's home.
	// in:body
	HomeID string `json:"homeID"`

	// LocationID is the RoomID of the player's location.
	// in: body
	LocationID string `json:"locationID"`

	// Created is the time of the player's creation.
	// in: body
	Created arcade.Timestamp `json:"created"`

	// Updated is the time the player was last updated.
	// in: body
	Updated arcade.Timestamp `json:"updated"`
}

type PlayerCreateRequest struct {
	PlayerRequest
}

type PlayerRequest struct {
	// Name is the name of the player.
	// in: body
	// minimum length: 1
	// maximum length: 256
	Name string `json:"name"`

	// Description is the description of the player.
	// in: body
	// minimum length: 1
	// maximum length: 4096
	Description string `json:"description"`

	// HomeID is the ID of the home of the player.
	// in: body
	// minimum length: 1
	// maximum length: 4096
	HomeID string `json:"homeID"`

	// LocationID is the ID of the location of the player.
	// in: body
	LocationID string `json:"locationID"`
}

type PlayerResponse struct {
	// Player returns the information about a player.
	// in: body
	Player Player `json:"player"`
}

type PlayerUpdateRequest struct {
	PlayerRequest
}

type PlayersResponse struct {
	// Players returns the information about multiple players.
	// in: body
	Players []Player `json:"players"`
}

type Room struct {
	// ID is the room identifier.
	// in: body
	ID string `json:"id"`

	// Name is the room name.
	// in: body
	Name string `json:"name"`

	// Description is the room description.
	// in: body
	Description string `json:"description"`

	// OwnerID is the PlayerID of the room owner.
	// in:body
	OwnerID string `json:"ownerID"`

	// ParentID is the RoomID of the room's parent.
	// in: body
	ParentID string `json:"parentID"`

	// Created is the time of the room's creation.
	// in: body
	Created arcade.Timestamp `json:"created"`

	// Updated is the time the room was last updated.
	// in: body
	Updated arcade.Timestamp `json:"updated"`
}

type RoomCreateRequest struct {
	RoomRequest
}

type RoomRequest struct {
	// Name is the name of the room.
	// in: body
	// minimum length: 1
	// maximum length: 256
	Name string `json:"name"`

	// Description is the description of the room.
	// in: body
	// minimum length: 1
	// maximum length: 4096
	Description string `json:"description"`

	// OwnerID is the ID of the owner of the room.
	// in: body
	// minimum length: 1
	// maximum length: 4096
	OwnerID string `json:"ownerID"`

	// ParentID is the ID of the parent of the room.
	// in: body
	ParentID string `json:"parentID"`
}

type RoomResponse struct {
	// Room returns the information about a room.
	// in: body
	Room Room `json:"room"`
}

type RoomUpdateRequest struct {
	RoomRequest
}

type RoomsResponse struct {
	// Rooms returns the information about multiple rooms.
	// in: body
	Rooms []Room `json:"rooms"`
}