@zjw-jszn/platform-imsdk 1.0.0

package/README.md

@@ -0,0 +1,30 @@
+# Platform IMSDK
+
+平台 SDK（基于共用内核 `@zjw-jszn/shared-imsdk`）：
+
+- API 前缀：`/site/IM`
+- WebSocket controller：`Site`
+- WebSocket platform：`site`
+- 能力范围：基础会话能力 + 平台扩展接口（结束会话、客服会话、会话配置、AI 配置）
+平台 API 文档：`docs/API/平台.md`
+
+安装：
+
+```bash
+pnpm add @zjw-jszn/platform-imsdk
+```
+
+使用：
+
+```ts
+import { IMSDK } from '@zjw-jszn/platform-imsdk'
+
+IMSDK.init({
+  phone: '18888888888', // 当前测试约定值（平台）
+})
+```
+
+说明：
+
+- 平台端 `getAuthorization.phone` 需使用 `im-backend-web`「系统设置/管理员管理（system/admin）」中的管理员手机号。
+- 上述示例值仅为当前联调值（2026-03-24）；若后台管理员手机号变更需同步更新。

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+import { IMSDKConfig as SharedIMSDKConfig, getUserInfo } from '@zjw-jszn/shared-imsdk';
+export type { PlatformChatConfig, PlatformCloseSessionParams, PlatformPageResponse, PlatformSession } from './runtime-api';
+export { closeSession, getChatConfig, getCustomerChatList } from './runtime-api';
+export * from '@zjw-jszn/shared-imsdk';
+export interface IMSDKConfig extends SharedIMSDKConfig {
+}
+export declare function initIM(config?: IMSDKConfig): Promise<{
+    show: () => void;
+    hide: () => void;
+}>;
+declare const IMSDK: {
+    init: typeof initIM;
+    getUserInfo: typeof getUserInfo;
+};
+export default IMSDK;
+export { IMSDK };

package/dist/platform-imsdk.es.js

@@ -0,0 +1,67 @@
+import { IMSDK as e, applyModeDefaults as t, getUserInfo as n, http as r, initIM as i, warnModeOverrides as a } from "@zjw-jszn/shared-imsdk";
+export * from "@zjw-jszn/shared-imsdk";
+//#region src/runtime-api.ts
+var o = "/site/IM";
+function s(e) {
+	return `${o}${e.startsWith("/") ? e : `/${e}`}`;
+}
+function c(e) {
+	if (!r.getAuth()) throw Error(`未登录，禁止请求 ${e}，请先完成鉴权`);
+}
+function l(e, t) {
+	if (e.result === void 0 || e.result === null) throw Error(`${t} 接口返回 result 为空`);
+	return e.result;
+}
+async function u() {
+	return c("getChatConfig"), l(await r.post(s("/chatConfig/getConfig")), "getChatConfig");
+}
+async function d(e) {
+	c("closeSession");
+	let t = e.uid !== void 0 && e.uid !== null, n = e.session_id !== void 0 && e.session_id !== null;
+	if (!t && !n) throw Error("结束会话失败：uid 和 session_id 不能同时为空");
+	let i = t ? { uid: e.uid } : { session_id: e.session_id };
+	return await r.post(s("/chat/closeSession"), i), !0;
+}
+async function f(e) {
+	return c("getCustomerChatList"), l(await r.post(s("/customer/getChatList"), e), "getCustomerChatList");
+}
+//#endregion
+//#region src/index.ts
+var p = {
+	api: {
+		prefix: "/site/IM",
+		userType: 4
+	},
+	ws: {
+		controller: "Site",
+		platform: "site"
+	}
+};
+function m(e) {
+	a("platform-imsdk", e, p);
+	let t = e.runtimeApi;
+	(t?.getChatConfig || t?.closeSession || t?.getCustomerChatList) && console.warn("[platform-imsdk] 已忽略 runtimeApi 的平台扩展覆盖配置，平台扩展接口由内置实现提供");
+}
+function h(e = {}) {
+	m(e);
+	let n = e;
+	return {
+		...t(e, p),
+		runtimeApi: {
+			...n.runtimeApi || {},
+			getChatConfig: u,
+			closeSession: d,
+			getCustomerChatList: f
+		}
+	};
+}
+async function g(e = {}) {
+	return i(h(e));
+}
+var _ = {
+	...e,
+	init: g,
+	getUserInfo: n
+};
+//#endregion
+export { _ as IMSDK, _ as default, d as closeSession, u as getChatConfig, f as getCustomerChatList, g as initIM };

package/dist/platform-imsdk.umd.js

@@ -0,0 +1 @@
+(function(e,t){typeof exports==`object`&&typeof module<`u`?t(exports,require(`@zjw-jszn/shared-imsdk`)):typeof define==`function`&&define.amd?define([`exports`,`@zjw-jszn/shared-imsdk`],t):(e=typeof globalThis<`u`?globalThis:e||self,t(e.PlatformIMSDK={},e.SharedIMSDK))})(this,function(e,t){Object.defineProperties(e,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});var n=`/site/IM`;function r(e){return`${n}${e.startsWith(`/`)?e:`/${e}`}`}function i(e){if(!t.http.getAuth())throw Error(`未登录，禁止请求 ${e}，请先完成鉴权`)}function a(e,t){if(e.result===void 0||e.result===null)throw Error(`${t} 接口返回 result 为空`);return e.result}async function o(){return i(`getChatConfig`),a(await t.http.post(r(`/chatConfig/getConfig`)),`getChatConfig`)}async function s(e){i(`closeSession`);let n=e.uid!==void 0&&e.uid!==null,a=e.session_id!==void 0&&e.session_id!==null;if(!n&&!a)throw Error(`结束会话失败：uid 和 session_id 不能同时为空`);let o=n?{uid:e.uid}:{session_id:e.session_id};return await t.http.post(r(`/chat/closeSession`),o),!0}async function c(e){return i(`getCustomerChatList`),a(await t.http.post(r(`/customer/getChatList`),e),`getCustomerChatList`)}var l={api:{prefix:`/site/IM`,userType:4},ws:{controller:`Site`,platform:`site`}};function u(e){(0,t.warnModeOverrides)(`platform-imsdk`,e,l);let n=e.runtimeApi;(n?.getChatConfig||n?.closeSession||n?.getCustomerChatList)&&console.warn(`[platform-imsdk] 已忽略 runtimeApi 的平台扩展覆盖配置，平台扩展接口由内置实现提供`)}function d(e={}){u(e);let n=e;return{...(0,t.applyModeDefaults)(e,l),runtimeApi:{...n.runtimeApi||{},getChatConfig:o,closeSession:s,getCustomerChatList:c}}}async function f(e={}){return(0,t.initIM)(d(e))}var p={...t.IMSDK,init:f,getUserInfo:t.getUserInfo};e.IMSDK=p,e.default=p,e.closeSession=s,e.getChatConfig=o,e.getCustomerChatList=c,e.initIM=f,Object.keys(t).forEach(function(n){n!==`default`&&!Object.prototype.hasOwnProperty.call(e,n)&&Object.defineProperty(e,n,{enumerable:!0,get:function(){return t[n]}})})});

package/dist/runtime-api.d.ts

@@ -0,0 +1,39 @@
+export interface PlatformChatConfig {
+    quick_receive?: string[] | string;
+    default_voice?: string;
+}
+export interface PlatformCloseSessionParams {
+    uid?: number;
+    session_id?: string;
+}
+export interface PlatformPageResponse<T> {
+    list: T[];
+    count: number;
+}
+export interface PlatformSession {
+    session_id: string;
+    friend: Record<string, unknown>;
+    friend_type: number;
+    user: Record<string, unknown>;
+    user_type: number;
+    content: string;
+    create_time: string;
+    count: number;
+    read_count: number;
+}
+/**
+ * 获取会话配置（平台扩展）
+ */
+export declare function getChatConfig(): Promise<PlatformChatConfig>;
+/**
+ * 结束会话并清理缓存（平台扩展）
+ */
+export declare function closeSession(data: PlatformCloseSessionParams): Promise<boolean>;
+/**
+ * 获取客服会话聊天列表（平台扩展）
+ */
+export declare function getCustomerChatList(data: {
+    page: number;
+    limit: number;
+    phone?: string;
+}): Promise<PlatformPageResponse<PlatformSession>>;

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@zjw-jszn/platform-imsdk",
+  "type": "module",
+  "version": "1.0.0",
+  "exports": {
+    ".": {
+      "types": {
+        "development": "./src/index.ts",
+        "default": "./dist/index.d.ts"
+      },
+      "import": {
+        "development": "./src/index.ts",
+        "default": "./dist/platform-imsdk.es.js"
+      }
+    },
+    "./style.css": "./style.css"
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "style.css"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "@zjw-jszn/shared-imsdk": "1.0.0"
+  },
+  "devDependencies": {
+    "typescript": "~5.9.3",
+    "vite": "^8.0.1",
+    "vite-plugin-dts": "^4.5.4",
+    "vue-tsc": "^3.2.5"
+  },
+  "scripts": {
+    "typecheck": "vue-tsc --noEmit",
+    "build": "vue-tsc && vite build"
+  }
+}

package/style.css

@@ -0,0 +1 @@
+@import '@zjw-jszn/shared-imsdk/style.css';