@pmate/chat-sdk 0.2.3 → 0.3.0

package/lib/mentions/model.d.ts

@@ -0,0 +1,28 @@
+/** Host-owned identity; names need not be unique. */
+export type MentionCandidate = {
+    id: string;
+    name: string;
+    avatar?: string;
+    description?: string;
+};
+/** UTF-16 offsets [start, end) in the sent text, including @. */
+export type ChatMention = {
+    id: string;
+    name: string;
+    start: number;
+    end: number;
+};
+export type MentionQuery = {
+    start: number;
+    end: number;
+    query: string;
+};
+export type MentionConfig = {
+    candidates: MentionCandidate[];
+    label?: string;
+    emptyText?: string;
+};
+export declare function findMentionQuery(text: string, caret: number): MentionQuery | null;
+export declare function filterMentionCandidates(candidates: MentionCandidate[], query: string): MentionCandidate[];
+/** Rebase untouched mentions; editing any part of a mention removes its identity. */
+export declare function rebaseMentions(previous: string, next: string, mentions: ChatMention[]): ChatMention[];

package/lib/mentions/model.js

@@ -0,0 +1,40 @@
+export function findMentionQuery(text, caret) {
+    const before = text.slice(0, caret);
+    // Require a word boundary so email addresses and URLs remain ordinary text.
+    const match = /(?:^|[\s([{，。！？、：；])@([^\s@]{0,64})$/u.exec(before);
+    if (!match)
+        return null;
+    return { start: caret - match[1].length - 1, end: caret, query: match[1] };
+}
+export function filterMentionCandidates(candidates, query) {
+    const seen = new Set();
+    return candidates.filter(candidate => {
+        if (seen.has(candidate.id))
+            return false;
+        seen.add(candidate.id);
+        return candidate.name.toLocaleLowerCase().includes(query.toLocaleLowerCase());
+    });
+}
+/** Rebase untouched mentions; editing any part of a mention removes its identity. */
+export function rebaseMentions(previous, next, mentions) {
+    if (previous === next)
+        return mentions;
+    let start = 0;
+    while (start < previous.length && start < next.length && previous[start] === next[start])
+        start++;
+    let oldEnd = previous.length, newEnd = next.length;
+    while (oldEnd > start && newEnd > start && previous[oldEnd - 1] === next[newEnd - 1]) {
+        oldEnd--;
+        newEnd--;
+    }
+    const delta = newEnd - oldEnd;
+    return mentions.flatMap(mention => {
+        if (mention.end <= start)
+            return [mention];
+        if (mention.start >= oldEnd)
+            return [{ ...mention, start: mention.start + delta, end: mention.end + delta }];
+        return [];
+    }).filter(mention => next.slice(mention.start, mention.end) === `@${mention.name}`
+        && (mention.start === 0 || /[\s([{，。！？、：；]/u.test(next[mention.start - 1]))
+        && (mention.end === next.length || !/[\p{L}\p{N}_@]/u.test(next[mention.end])));
+}

package/lib/runtime/chatClient.d.ts

@@ -1,3 +1,4 @@
+import type { ChatMention } from "../mentions/model";
 import { type BotLoginSession } from "./botAuth.js";
 import { type PmateBotKeyFile } from "./botKey.js";
 import { type ChatBody, type ChatRuntimeMessage, type RealtimeClient } from "./protocol.js";
@@ -55,6 +56,7 @@ export declare class ChatClient {
         groupId: string;
         text: string;
         recipients?: string[];
+        mentions?: ChatMention[];
     }): Promise<ChatRuntimeMessage>;
     sendChat(to: string, body: ChatBody, recipients?: string[]): Promise<ChatRuntimeMessage>;
     private sendContactAction;

package/lib/runtime/chatClient.js

@@ -104,7 +104,7 @@ export class ChatClient {
             kind: "message",
             threadKind: "group",
             contentKind: "text",
-            content: { appId: this.options.appId, groupId: input.groupId, text: input.text },
+            content: { appId: this.options.appId, groupId: input.groupId, text: input.text, ...(input.mentions?.length ? { mentions: input.mentions } : {}) },
         }, input.recipients);
     }
     async sendChat(to, body, recipients) {

package/lib/types/chatInput.d.ts

@@ -1,3 +1,4 @@
+import type { MentionConfig, ChatMention } from "../mentions/model";
 import type { ClipboardEventHandler, ComponentType, DragEventHandler, ReactNode } from "react";
 import type { ChatAttachment } from "./attachment";
 import type { ChatVoiceConfig } from "./voice";
@@ -120,6 +121,8 @@ export type ChatImageConfig = {
     uploadImage?: (file: File) => Promise<ChatImageUploadResult>;
 };
 export type ChatInputBaseProps = {
+    /** Group members supplied by the host; omit for ordinary text input. */
+    mentions?: MentionConfig;
     /** Use a taller composer with actions in a bottom toolbar. */
     multiline?: boolean;
     value?: string;
@@ -131,6 +134,7 @@ export type ChatInputBaseProps = {
     onDrop?: DragEventHandler<HTMLTextAreaElement>;
     onSend?: (payload: {
         text: string;
+        mentions?: ChatMention[];
         attachments: ChatAttachment[];
         transcript?: string;
         audio?: Blob;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pmate/chat-sdk",
-  "version": "0.2.3",
+  "version": "0.3.0",
   "description": "Cross-platform PMate chat input components, voice input primitives, and ASR helpers",
   "type": "module",
   "main": "./lib/index.js",
@@ -29,15 +29,6 @@
   "publishConfig": {
     "access": "public"
   },
-  "scripts": {
-    "clean": "rimraf lib",
-    "build": "pnpm run clean && tsc -p tsconfig.build.json && cp src/voice/recorder-processor.js lib/voice/recorder-processor.js",
-    "prepack": "pnpm run build",
-    "npm:publish": "pnpm run build && npm publish --access public --registry https://registry.npmjs.org/",
-    "test": "vitest run",
-    "storybook": "storybook dev -p 6009",
-    "build-storybook": "storybook build --output-dir dist"
-  },
   "dependencies": {
     "@noble/hashes": "^2.4.0",
     "@emoji-mart/data": "^1.2.1",
@@ -52,15 +43,23 @@
   "devDependencies": {
     "@storybook/addon-docs": "^9.0.17",
     "@storybook/react-vite": "9.0.17",
-    "@tailwindcss/vite": "catalog:",
-    "@types/react": "catalog:",
-    "@types/react-dom": "catalog:",
-    "react": "catalog:",
-    "react-dom": "catalog:",
+    "@tailwindcss/vite": "^4.1.3",
+    "@types/react": "^19.2.7",
+    "@types/react-dom": "^19.2.3",
+    "react": "^19.1.1",
+    "react-dom": "^19.1.1",
     "rimraf": "^6.1.2",
     "storybook": "^9.0.17",
-    "tailwindcss": "catalog:",
+    "tailwindcss": "^4.0.14",
     "typescript": "5.9.2",
     "vitest": "^4.0.17"
+  },
+  "scripts": {
+    "clean": "rimraf lib",
+    "build": "pnpm run clean && tsc -p tsconfig.build.json && cp src/voice/recorder-processor.js lib/voice/recorder-processor.js",
+    "npm:publish": "pnpm run build && npm publish --access public --registry https://registry.npmjs.org/",
+    "test": "vitest run",
+    "storybook": "storybook dev -p 6009",
+    "build-storybook": "storybook build --output-dir dist"
   }
-}
+}