joytalk 0.0.1

package/dist/types/message.d.ts

@@ -0,0 +1,316 @@
+import { FaqListResponse } from './request';
+/**
+ * 消息类型
+ * 1.发送 2.撤回 3.编辑 4.系统通知 5.转接 6.进线 7.回复 8.解绑
+ */
+export declare enum MessageType {
+    /** 发送 */
+    SEND = "1",
+    /** 撤回 */
+    WITHDRAW = "2",
+    /** 编辑 */
+    EDIT = "3",
+    /** 系统通知 */
+    SYSTEM_NOTICE = "4",
+    /** 转接 */
+    TRANSFER = "5",
+    /** 进线 */
+    INBOUND = "6",
+    /** 回复 */
+    REPLY = "7",
+    /** 解绑 */
+    UNBIND = "8"
+}
+/**
+ * 聊天类型
+ * 1.文字 2.图片 3.视频 4.文件 5.faq
+ */
+export declare enum ChatType {
+    /** 文字 */
+    TEXT = "1",
+    /** 图片 */
+    IMAGE = "2",
+    /** 视频 */
+    VIDEO = "3",
+    /** 文件 */
+    FILE = "4",
+    /** faq */
+    FAQ = "5"
+}
+export declare enum MessageCode {
+    /** 连接成功 */
+    CONNECT_SUCCESS = 200,
+    /** 连接失败 */
+    CONNECT_FAILED = 40001,
+    /** 转接成功通知原客服 */
+    TRANSFER_CUSTOMER_SUCCESS = 201,
+    /** 转接成功通知转接客服 */
+    TRANSFER_TO_CUSTOMER_SUCCESS = 202,
+    /** 转接成功通知用户 */
+    TRANSFER_USER_SUCCESS = 203,
+    /** 转接失败 */
+    TRANSFER_FAIL = 50001,
+    /** 匹配失败 */
+    MATCH_FAIL = 50002,
+    /** 匹配成功，返回信息 */
+    MATCH_INFO = 50005,
+    /** 分配成功 */
+    MATCH_SUCCESS = 50006,
+    /** 撤回 */
+    RETRACT = 204,
+    /** 撤回失败 */
+    RETRACT_FAIL = 50003,
+    /** 编辑 */
+    EDIT = 205,
+    /** 编辑失败 */
+    EDIT_FAIL = 50004,
+    /** 通用错误码 */
+    COMMON_FAIL = 50000,
+    /** 发送成功 */
+    SEND_SUCCESS = 206,
+    /** 发送回调 */
+    SEND_CALLBACK = 207,
+    /** 变更会话状态 */
+    CHANGE_CHAT_STATUS = 208
+}
+export declare enum SendUserType {
+    /** 客服 */
+    CUSTOMER = "1",
+    /** 用户 */
+    USER = "2",
+    /** 匿名 */
+    ANONYMOUS = "3"
+}
+/**
+ * 消息对象基础字段
+ */
+interface MessageBase {
+    /** 消息 */
+    msg?: string;
+    /** 消息类型 */
+    msgType: MessageType;
+    /** 接收者ID */
+    toUid: string;
+    /** 聊天类型 */
+    chatType?: ChatType;
+    /** 撤回或编辑的记录ID */
+    editId?: string;
+}
+/**
+ * 连接成功消息
+ */
+export interface ConnectSuccessMessage extends MessageBase {
+    /** 状态码 */
+    code: MessageCode.CONNECT_SUCCESS;
+    /** 消息内容 */
+    data: string;
+}
+/**
+ * 匹配成功消息
+ */
+export interface MatchSuccessMessage extends MessageBase {
+    /** 状态码 */
+    code: MessageCode.MATCH_INFO | MessageCode.MATCH_SUCCESS;
+    /** 消息内容 */
+    data: string | SessionData;
+}
+/**
+ * 发送成功消息
+ */
+export interface SendSuccessMessage extends MessageBase {
+    /** 状态码 */
+    code: MessageCode.SEND_SUCCESS;
+    /** 消息内容 */
+    data: string | MessageData | Partial<MessageData>;
+}
+/**
+ * 转接成功消息
+ */
+export interface TransferSuccessMessage extends MessageBase {
+    /** 状态码 */
+    code: MessageCode.TRANSFER_CUSTOMER_SUCCESS | MessageCode.TRANSFER_TO_CUSTOMER_SUCCESS | MessageCode.TRANSFER_USER_SUCCESS;
+    /** 消息内容 */
+    data: any;
+}
+/**
+ * 错误消息
+ */
+export interface ErrorMessage extends MessageBase {
+    /** 状态码 */
+    code: MessageCode.CONNECT_FAILED | MessageCode.TRANSFER_FAIL | MessageCode.MATCH_FAIL | MessageCode.RETRACT_FAIL | MessageCode.EDIT_FAIL | MessageCode.COMMON_FAIL;
+    /** 消息内容 */
+    data: any;
+}
+/**
+ * 其他消息
+ */
+export interface OtherMessage extends MessageBase {
+    /** 状态码 */
+    code?: MessageCode.RETRACT | MessageCode.EDIT | MessageCode.SEND_CALLBACK | undefined;
+    /** 消息内容 */
+    data: any;
+}
+/**
+ * 消息对象（根据 code 类型化的联合类型）
+ */
+export type Message = ConnectSuccessMessage | MatchSuccessMessage | SendSuccessMessage | TransferSuccessMessage | ErrorMessage | OtherMessage;
+/**
+ * 消息对象基础字段
+ */
+interface MessageDataBase {
+    messageId?: string;
+    sendId?: string;
+    sendName?: string;
+    /** 发送者类型 1: 客服 2: 用户 3: 匿名 */
+    sendUserType?: SendUserType;
+    /** 客服昵称 */
+    customerServiceName?: string;
+    /** 客服账号 */
+    customerServiceAccount?: string;
+    /** 客服ID */
+    customerServiceId?: string;
+    /** 客服头像 */
+    customerServiceAvatar?: string;
+    /** 用户昵称 */
+    userName?: string;
+    /** 用户头像 */
+    userAvatar?: string;
+    /** 接收者ID */
+    toUid?: string;
+    /** 接收者昵称 */
+    toUserName?: string;
+    /** 消息类型 */
+    msgType: MessageType;
+    /** 创建时间 */
+    createTime: number;
+    /** 发送IP */
+    sendIp?: string;
+    /** 编辑ID */
+    editId?: string;
+    /** 是否编辑 */
+    isEdit?: boolean;
+    /** 是否撤回 */
+    isCancel?: boolean;
+    /** 会话ID */
+    sessionId?: string;
+    /** 客服是否已读 */
+    isRead?: boolean;
+    /** 商户ID */
+    merchantId?: string;
+    /** 是否回复 */
+    isReply?: boolean;
+}
+/**
+ * 文本消息
+ */
+export interface TextMessageData extends MessageDataBase {
+    /** 内容类型 */
+    contentType: ChatType.TEXT;
+    /** 内容 */
+    content?: string;
+}
+/**
+ * 文件消息（图片、视频、文件）的联合类型
+ */
+export interface FileMessageData extends MessageDataBase {
+    /** 内容类型 */
+    contentType: ChatType.IMAGE | ChatType.VIDEO | ChatType.FILE;
+    /** 内容 */
+    content?: FileMessageContent;
+}
+export interface FaqItem {
+    /** FAQ ID */
+    faqId: number;
+    /** FAQ 项 ID */
+    faqItemId?: number;
+    /** ID */
+    id: number;
+    /** 图片URL列表 */
+    imageUrl?: string[];
+    /** 问题 */
+    question: string;
+    /** 答案 */
+    answer?: string;
+    /** 排序 */
+    sortOrder?: number;
+    /** 是否多选 */
+    isMulti?: boolean;
+    /** 子项 */
+    item?: Array<FaqItem>;
+}
+/**
+ * FAQ 消息内容（简化版，用于实际消息传输）
+ */
+export interface FaqMessageContent {
+    /** 引导文案 */
+    guideText: string;
+    /** FAQ 列表 */
+    list: Array<FaqItem>;
+}
+/**
+ * FAQ 消息
+ */
+export interface FaqMessageData extends MessageDataBase {
+    /** 内容类型 */
+    contentType: ChatType.FAQ;
+    /** 内容（可以是完整的 FaqListResponse 或简化的 FaqMessageContent） */
+    content?: FaqListResponse | FaqMessageContent;
+}
+/**
+ * 消息对象（根据 contentType 类型化的联合类型）
+ */
+export type MessageData = TextMessageData | FileMessageData | FaqMessageData;
+/**
+ * 类型守卫：判断是否为文本消息
+ */
+export declare function isTextMessage(message: MessageData): message is TextMessageData;
+/** 文件消息内容 */
+export interface FileMessageContent {
+    /** 文件名称 */
+    fileName: string;
+    /** 文件URL */
+    fileUrl: string;
+    /** 缩略图URL */
+    thumbnailUrl?: string;
+    /** 文件大小 */
+    fileSize?: number;
+}
+/**
+ * 聊天记录响应
+ */
+export interface ChatHistoryResponse {
+    /** 消息列表 */
+    messages: MessageData[];
+    /** 总数量 */
+    total: number;
+    /** 当前页码 */
+    page: number;
+    /** 每页数量 */
+    pageSize: number;
+    /** 是否有更多数据 */
+    hasMore: boolean;
+}
+/**
+ * 会话数据
+ */
+export interface SessionData {
+    /** 聊天ID */
+    chatId: number;
+    /** 客服ID（字符串格式） */
+    cid: string;
+    /** 客服ID（数字格式） */
+    id: number;
+    /** 客服头像 */
+    customerAvatar: string;
+    /** 客服名称 */
+    customerName: string;
+    /** 分组ID */
+    groupId: number;
+    /** 分组ID（段ID） */
+    segmentId: number;
+    /** 会话ID */
+    sessionId: string;
+    /** 用户ID */
+    uid: string;
+}
+export {};

package/dist/types/request.d.ts

@@ -0,0 +1,91 @@
+export interface RequestResponse<T> {
+    code: number;
+    message: string;
+    data: T;
+}
+declare module "axios" {
+    interface AxiosRequestConfig {
+        noAuth?: boolean;
+    }
+    interface InternalAxiosRequestConfig {
+        noAuth?: boolean;
+    }
+}
+export declare const TOKEN_KEY: "JOYTALK_TOKEN";
+export interface ObsAuthInfo {
+    accessKeyId: string;
+    signature: string;
+    policy: string;
+    key: string;
+}
+export interface ConsultationItem {
+    /** 客服组ID */
+    customerGroupId: string;
+    /** 是否默认 */
+    isDefault: boolean;
+    /** 引导文案 */
+    guideText: string;
+    /** 咨询类型名称 */
+    name: string;
+}
+export interface ConsultationListResponse {
+    list: ConsultationItem[];
+    /** 秒数 */
+    second: number;
+}
+export interface UserAuthParams {
+    /** 商户AppKey */
+    appKey: string;
+    /** 商户系统内的用户ID */
+    externalUserId: string;
+    /** 用户来源 */
+    userSource: "web" | "H5" | "App";
+    /** 入口ID */
+    entranceId: string;
+    /** 用户昵称 */
+    nickname?: string;
+    /** 用户头像 */
+    avatar?: string;
+}
+export interface AnonymousAuthParams {
+    /** 商户AppKey */
+    appKey: string;
+    /** 入口ID */
+    entranceId: string;
+    /** 用户来源 */
+    userSource: "web" | "H5" | "App";
+}
+export interface TopicItem {
+    answer: string;
+    faqId: number;
+    faqItemId: number;
+    id: number;
+    imageUrl: string[];
+    question: string;
+    sortOrder: number;
+}
+export interface Topic {
+    faqId: number;
+    id: number;
+    isMulti: boolean;
+    question: string;
+    item: TopicItem[];
+}
+export interface FaqListResponse {
+    faqName: string;
+    guideText: string;
+    id: number;
+    /** 转默认类型时 单位秒 */
+    showDelaySeconds: number;
+    topic: Topic[];
+}
+export interface UserInfo {
+    uuid: string;
+    merchantId: number;
+    nickname: string;
+    avatar: string;
+    userSource: string;
+    userIp: string;
+    externalUserId: string;
+    isAnonymous: boolean;
+}

package/dist/utils/event-emitter.d.ts

@@ -0,0 +1,30 @@
+import { EventType, EventCallback } from '../types';
+/**
+ * 简单的事件发射器实现
+ */
+export declare class EventEmitter {
+    private events;
+    /**
+     * 监听事件
+     * @param event - 事件类型
+     * @param callback - 事件回调函数
+     */
+    on(event: EventType, callback: EventCallback): void;
+    /**
+     * 取消监听事件
+     * @param event - 事件类型
+     * @param callback - 事件回调函数
+     */
+    off(event: EventType, callback: EventCallback): void;
+    /**
+     * 触发事件
+     * @param event - 事件类型
+     * @param data - 事件数据
+     */
+    emit(event: EventType, data?: unknown): void;
+    /**
+     * 移除所有事件监听器
+     * @param event - 事件类型
+     */
+    removeAllListeners(event?: EventType): void;
+}

package/dist/utils/http-handler.d.ts

@@ -0,0 +1,2 @@
+export declare class HttpHandler {
+}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "joytalk",
+  "version": "0.0.1",
+  "description": "JoyTalk SDK - 用于集成客服功能的 JavaScript SDK",
+  "type": "module",
+  "scripts": {
+    "dev": "vite build --watch --mode development",
+    "build": "tsc && vite build",
+    "preview": "vite preview",
+    "serve": "vite"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.3",
+    "typescript": "~5.9.3",
+    "vite": "^7.2.4",
+    "vite-plugin-dts": "^4.5.4"
+  },
+  "main": "./dist/index.es.js",
+  "module": "./dist/index.es.js",
+  "types": "./dist/index.d.ts",
+  "browser": "./dist/index.umd.js",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "axios": "^1.13.2"
+  }
+}