import { ChatElement } from 'chat-element-json-ts'; import { BasicCardType, Carousel, CarouselHeaderType, CarouselType, CommerceCardType, DefaultCarouselItemArrayType, DefaultContentType, Output, OutputType, QuickReplyType, SkillResponse, SkillResponseType, SkillTemplate, } from '../core-components'; import { BasicCardElementName } from '../core-components/constants'; import { ArrayOfChatElements, CoreComponentTypeName, Unarray } from '../type-utility'; type OutputOrContent = OutputType | AllowedContentType; /** * 배열 안 요소 중, null 또는 undefined인 요소를 제거해주는 함수. * > myArray.filter(notEmpty) 처럼 쓸 수 있음. * https://stackoverflow.com/questions/43118692/typescript-filter-out-nulls-from-an-array * */ function notEmpty(value: TValue | null | undefined | void): value is TValue { return value !== null && value !== undefined; } export class SkillResponseFactoryProps { chats: (OutputOrContent | undefined | null | void)[]; quickReplies?: (QuickReplyType | undefined | null | void)[]; } /** * Content 1개를 받아 Output 1개를 쉽게 생성해주는 함수 * @param content * @returns */ export function OutputFactory = DefaultContentType>( content: AllowedContentType, ): OutputType { return Output({ [content.name]: content, }); } /** * SkillResponse를 생성해주는 헬퍼 함수. Content 배열과 QuickReply 배열을 인자로 받아 완전한 챗봇 응답 데이터를 생성함. * @param SkillResponseFactoryProps * @returns */ export function BaseSkilLResponseFactory({ chats, quickReplies, }: SkillResponseFactoryProps) { return SkillResponse({ version: '2.0', template: SkillTemplate({ outputs: chats.filter(notEmpty).map((chat: OutputOrContent) => { if (chat.name === 'output') { return chat as OutputType; } return OutputFactory(chat as AllowedContentType); }), quickReplies: quickReplies ? quickReplies.filter(notEmpty) : [], }), }); } /** * SkillResponse를 생성해주는 헬퍼 함수. DefaultContentType 타입의 chats 배열과 QuickReply 배열을 인자로 받아 완전한 챗봇 응답 데이터를 생성함. * @param SkillResponseFactoryProps * @returns */ export function SkillResponseFactory({ chats, quickReplies, }: SkillResponseFactoryProps): SkillResponseType { return BaseSkilLResponseFactory({ chats, quickReplies }); } /** * Carousel을 생성해주는 헬퍼 함수. CarouselItemsType을 인자로 받아 Carousel 객체를 알아서 생성함. * @param items 캐로셀에 들어갈 요소들 * @param carouselHeader CarouselHeader * @returns */ export function BaseCarouselFactory( items: CarouselItemsType, carouselHeader?: CarouselHeaderType, ): CarouselType> | typeof BasicCardElementName, CarouselItemsType> { if (items.length === 0) { return Carousel({ type: BasicCardElementName, items, header: carouselHeader, }); } return Carousel>, CarouselItemsType>({ type: items[0].name as CoreComponentTypeName>, items, header: carouselHeader, }); } /** * DefaultCarouselItemArrayType 타입(=BasicCardType[] | CommerceCardType[])의 items를 인자로 받아 Carousel을 생성함. */ export function CarouselFactory(items: DefaultCarouselItemArrayType, carouselHeader?: CarouselHeaderType) { return BaseCarouselFactory(items, carouselHeader); }