skill

type Action struct {
	Id           string                 `json:"id"`           // 스킬의 고유한 식별자입니다.
	Name         string                 `json:"name"`         // 설정된 스킬의 이름입니다.
	Params       map[string]interface{} `json:"params"`       // 사용자의 발화로부터 추출한 파라미터 정보입니다.
	DetailParams map[string]DetailParam `json:"detailParams"` // 사용자의 발화로부터 추출한 엔티티의 상세 정보입니다.
	ClientExtra  map[string]interface{} `json:"clientExtra"`  // 사용자의 발화의 추가적인 정보
}

type BasicCard struct {
	Title       string     `json:"title,omitempty"`
	Description string     `json:"description,omitempty"`
	Thumbnail   *Thumbnail `json:"thumbnail,omitempty"`
	Buttons     []Button   `json:"buttons,omitempty"`
}

type Block struct {
	Id   string `json:"id"`   // 블록 ID
	Name string `json:"name"` // 블록 이름
}

type Bot struct {
	Id   string `json:"id"`   // 봇의 고유한 식별자입니다.
	Name string `json:"name"` // 설정된 봇의 이름입니다.
}

type Button struct {
	Label      string `json:"label"`                // 버튼에 적히는 문구입니다 (최대 8자)
	Action     string `json:"action"`               // 버튼 클릭시 수행될 작업입니다
	WebLinkUrl string `json:"webLinkUrl,omitempty"` // 웹 브라우저를 열고 webLinkUrl 의 주소로 이동합니다 (Action: webLink)
	OsLink     *Link  `json:"osLink,omitempty"`     // osLink 값에 따라서 웹의 주소로 이동하거나 앱을 실행합니다 (Action: osLink)
	// Action: "message" / "block"
	// message => 사용자의 발화로 messageText를 내보냅니다. (바로가기 응답의 메세지 연결 기능과 동일)
	// block => 블록 연결시 사용자의 발화로 노출됩니다.
	MessageText string                 `json:"messageText,omitempty"`
	PhoneNumber string                 `json:"phoneNumber,omitempty"` // phoneNumber에 있는 번호로 전화를 겁니다 (전화번호)
	BlockId     string                 `json:"blockId,omitempty"`     // blockId를 갖는 블록을 호출합니다 (바로가기 응답의 블록 연결 기능과 동일)
	Extra       map[string]interface{} `json:"extra,omitempty"`       // block이나 message action으로 블록 호출시, 스킬 서버에 추가적으로 제공하는 정보
}

type CarouselHeader struct {
	Title       string     `json:"title"`                 // 케로셀 헤드 제목 (최대 2줄, 한 줄에 들어갈 수 있는 글자 수는 기기에 따라 달라집니다.)
	Description string     `json:"description,omitempty"` // 케로셀 헤드 설명 (최대 3줄, 한 줄에 들어갈 수 있는 글자 수는 기기에 따라 달라집니다.)
	Thumbnail   *Thumbnail `json:"thumbnail,omitempty"`   // 케로셀 헤드 배경 이미지 (현재 imageUrl 값만 지원합니다.)
}

type CommerceCard struct {
	Type   string         `json:"type"`             // 케로셀의 타입입니다.	("basicCard" 혹은 "commerceCard")
	Items  []interface{}  `json:"items"`            // 케로셀 아이템입니다 (BasicCard or CommerceCard, 최대 10개)
	Header CarouselHeader `json:"header,omitempty"` // 케로셀의 커버를 제공합니다 (CommerceCard 만 지원하고 있습니다. 추후 BasicCard 도 지원할 예정입니다.)
}

type Component struct {
	SimpleText   *SimpleText   `json:"simpleText,omitempty"`   // 간단 텍스트
	SimpleImage  *SimpleImage  `json:"simpleImage,omitempty"`  // 간단 이미지
	BasicCard    *BasicCard    `json:"basicCard,omitempty"`    // 기본 카드 (캐로샐 가능)
	CommerceCard *CommerceCard `json:"commerceCard,omitempty"` // 커머스 카드 (캐로샐 가능)
	ListCard     *ListCard     `json:"listCard,omitempty"`     // 리스트 카드
}

type Context struct {
	ResponseWriter http.ResponseWriter
	Reqeust        *http.Request
	Payload        *SkillPayload
	// contains filtered or unexported fields
}

type ContextControl struct {
	Values []ContextValue `json:"values"`
}

type ContextValue struct {
	Name     string            `json:"name"`             // 수정하려는 output 컨텍스트의 이름
	LifeSpan string            `json:"lifeSpan"`         // 수정하려는 ouptut 컨텍스트의 lifeSpan
	Params   map[string]string `json:"params,omitempty"` // output 컨텍스트에 저장하는 추가 데이터
}

type DetailParam struct {
	Origin    interface{} `json:"origin"`
	Value     interface{} `json:"value"`
	GroupName string      `json:"groupName"`
}

type HandleFunc func(ctx *Context)

type Handler interface {
	Handle(ctx *Context)
}

type Link struct {
	Mobile  string `json:"mobile,omitempty"`  // ios와 android를 아우르는 mobile link입니다.
	Ios     string `json:"ios,omitempty"`     // ios의 웹이나 앱을 실행하는 link입니다.
	Android string `json:"android,omitempty"` // android의 웹이나 앱을 실행하는 link입니다.
	Pc      string `json:"pc,omitempty"`      // mac과 window를 아우르는 pc link입니다.
	Mac     string `json:"mac,omitempty"`     // mac의 웹이나 앱을 실행하는 link입니다.
	Win     string `json:"win,omitempty"`     // window의 웹이나 앱을 실행하는 link입니다.
	Web     string `json:"web,omitempty"`     // 모든 기기를 아우르는 link입니다.
}

type ListCard struct {
	Header  ListItemHeader  `json:"header"`            // 카드의 상단 항목
	Items   []ListItemItems `json:"items"`             // 카드의 각각 아이템 (최대 5개)
	Buttons []Button        `json:"buttons,omitempty"` // 최대 2개
}

type ListItemHeader struct {
	Title    string `json:"title"`    // listCard의 제목
	ImageUrl string `json:"imageUrl"` // listCard 제목의 배경
	Link     Link   `json:"link"`     // 클릭시 작동하는 링크입니다.
}

type ListItemItems struct {
	Title       string `json:"title"`                 // 제목
	Description string `json:"description,omitempty"` // 설명
	ImageUrl    string `json:"imageUrl"`              // 우측 안내 사진
	Link        Link   `json:"link"`                  // 클릭시 작동하는 링크입니다.
}

type MuxHelper struct {
	// contains filtered or unexported fields
}

type Profile struct {
	Nickname string `json:"nickname"` // 프로필 이름
	ImageUrl string `json:"imageUrl"` // 프로필 이미지
}

type QuickReply struct {
	Label       string      `json:"label"`       // 사용자에게 노출될 바로가기 응답의 표시
	Action      string      `json:"action"`      // 바로가기 응답의 기능 (message or block)
	MessageText string      `json:"messageText"` // 사용자 측으로 노출될 발화
	BlockId     string      `json:"blockId"`     // 바로가기 응답이 'block' 일 때 연결될 블록의 id
	Extra       interface{} `json:"extra"`       // 블록을 호출 시 추가적으로 제공하는 정보
}

type SimpleImage struct {
	ImageUrl string `json:"imageUrl"` // 전달하고자 하는 이미지의 url입니다 (URL 형식)
	AltText  string `json:"altText"`  // url이 유효하지 않은 경우, 전달되는 텍스트입니다 (1000자 이내)
}

type SimpleText struct {
	Text string `json:"text"` // 전달하고자 하는 텍스트입니다 (1000자 이내)
}

type SkillPayload struct {
	UserRequest UserRequest `json:"userRequest"`
	Bot         Bot         `json:"bot"`
	Action      Action      `json:"action"`
}

type SkillResponse struct {
	Version  string                 `json:"version"`           // must "2.0"
	Template SkillTemplate          `json:"template"`          // 스킬 응답의 출력 모양을 담고 있는 항목입니다. 출력으로 사용할 요소 그룹, 바로가기 응답 그룹 등을 포함합니다.
	Context  *ContextControl        `json:"context,omitempty"` // 블록의 context 설정을 제어할 수 있습니다.
	Data     map[string]interface{} `json:"data,omitempty"`    //필요에 따라 커스텀한 데이터를 넣을 수 있는 항목입니다.
}

type SkillTemplate struct {
	Outputs      []Component  `json:"outputs"`                // 출력 그룹(outputs)은 여러 종류의 출력 요소(component)를 포함합니다 (1개 이상 3개 이하)
	QuickReplies []QuickReply `json:"quickReplies,omitempty"` // 바로가기 그룹(quickReplies)은 여러 개의 바로가기 요소(quickReply)를 포함합니다 (10개 이하)
}

type Thumbnail struct {
	ImageUrl string `json:"imageUrl"`       //이미지의 url입니다.
	Link     *Link  `json:"link,omitempty"` // 이미지 클릭시 작동하는 link입니다.
	// true: 이미지 영역을 1:1 비율로 두고 이미지의 원본 비율을 유지합니다. 이미지가 없는 영역은 흰색으로 노출합니다.
	// false: 이미지 영역을 2:1 비율로 두고 이미지의 가운데를 크롭하여 노출합니다.
	FixedRatio bool `json:"fixedRatio"`
	Width      int  `json:"width"`  // fixedRatio를 true로 설정할 경우 필요한 값입니다. 실제 이미지 사이즈와 다른 값일 경우 원본이미지와 다르게 표현될 수 있습니다.
	Height     int  `json:"height"` // fixedRatio를 true로 설정할 경우 필요한 값입니다. 실제 이미지 사이즈와 다른 값일 경우 원본이미지와 다르게 표현될 수 있습니다.
}

type User struct {
	Id         string       `json:"id"`         // 사용자를 식별할 수 있는 key로 최대 70자의 값을 가지고 있습니다.
	Type       string       `json:"type"`       // 현재는 botUserKey만 제공합니다.
	Properties UserProperty `json:"properties"` // 추가적으로 제공하는 사용자의 속성 정보입니다.
}

type UserProperty struct {
	PlusFriendUserKey string `json:"plusfriendUserKey"` // 카카오톡 채널에서 제공하는 사용자 식별키 입니다.
	AppUserId         string `json:"appUserId"`         // 봇 설정에서 앱키를 설정한 경우에만 제공되는 사용자 정보입니다.
}

type UserRequest struct {
	Timezone  string `json:"timezone"`  // 사용자의 시간대를 반환합니다.
	Block     Block  `json:"block"`     // 사용자의 발화에 반응한 블록의 정보입니다.
	Utterance string `json:"utterance"` // 봇 시스템에 전달된 사용자의 발화입니다.
	Lang      string `json:"lang"`      // 사용자의 언어를 반환합니다.
	User      User   `json:"user"`      // 사용자의 정보입니다.
}