@pmate/chat-sdk 0.12.0-next.73 → 0.12.0-next.74

package/lib/chatContract.d.ts

@@ -145,4 +145,7 @@ export interface Chat {
         threadId: string;
     }>;
     updateGroup(threadId: string, changes: GroupChanges): Promise<ChatGroup>;
+    dissolveGroup(threadId: string, options?: {
+        expectedRevision?: string;
+    }): Promise<ChatGroup>;
 }

package/lib/chatTypes.d.ts

@@ -52,7 +52,7 @@ export type ChatMessage = Readonly<{
     mentions?: readonly ChatMention[];
     recipientCount?: number;
     system?: Readonly<{
-        type: "group-created" | "group-updated" | "contact-updated";
+        type: "group-created" | "group-updated" | "group-dissolved" | "contact-updated";
         title?: string;
     }>;
 }>;
@@ -60,11 +60,17 @@ export type ChatGroup = Readonly<{
     groupId: string;
     teamId: string;
     ownerId: string;
+    revision: string;
+} & ({
+    status: "active";
     title: string;
     avatar?: string;
     memberIds: readonly string[];
-    revision: string;
-}>;
+} | {
+    status: "dissolved";
+    dissolvedBy?: string;
+    dissolvedAt?: number;
+})>;
 export type ConversationInfo = Readonly<{
     kind: "dm" | "group";
     targetId: string;

package/lib/internal/chatEngine.d.ts

@@ -11,8 +11,10 @@ export type OutgoingContent = Exclude<RuntimeContent, {
     groupCreate: unknown;
 } | {
     groupUpdate: unknown;
+} | {
+    groupDissolve: unknown;
 }>;
-import type { ChatThreadSnapshot, ChatSnapshot, ReadOptions } from "../chatTypes.js";
+import type { ChatGroup, ChatThreadSnapshot, ChatSnapshot, ReadOptions } from "../chatTypes.js";
 export type { ChatGroup, ConversationInfo, ChatThreadSnapshot, ChatSnapshot, ReadOptions } from "../chatTypes.js";
 export type MessageQuery = {
     earlier?: boolean;
@@ -94,15 +96,7 @@ export declare class ChatEngine {
     getVoiceAttachment(threadId: string, messageId: string): Promise<import("../runtime/durableSender.js").VoiceAttachmentLease>;
     getGroup(threadId: string, options?: {
         refresh?: boolean;
-    }): Promise<Readonly<{
-        groupId: string;
-        teamId: string;
-        ownerId: string;
-        title: string;
-        avatar?: string;
-        memberIds: readonly string[];
-        revision: string;
-    }>>;
+    }): Promise<ChatGroup>;
     createGroup(input: {
         groupId?: string;
         title: string;
@@ -112,20 +106,25 @@ export declare class ChatEngine {
         groupId: string;
         teamId: string;
         ownerId: string;
+        revision: string;
+        status: "active";
         title: string;
         avatar?: string;
         memberIds: readonly string[];
-        revision: string;
-    }>;
-    updateGroup(threadId: string, changes: GroupChanges): Promise<Readonly<{
+    } | {
+        threadId: string;
         groupId: string;
         teamId: string;
         ownerId: string;
-        title: string;
-        avatar?: string;
-        memberIds: readonly string[];
         revision: string;
-    }>>;
+        status: "dissolved";
+        dissolvedBy?: string;
+        dissolvedAt?: number;
+    }>;
+    updateGroup(threadId: string, changes: GroupChanges): Promise<ChatGroup>;
+    dissolveGroup(threadId: string, options?: {
+        expectedRevision?: string;
+    }): Promise<ChatGroup>;
     revokeAccess(): Promise<void>;
     close(): Promise<void>;
 }

package/lib/internal/chatEngine.js

@@ -201,8 +201,8 @@ export class ChatEngine {
     }
     sendMessage(threadId, content, options = {}) {
         return this.threadOperation(threadId, async () => {
-            if (content && ("groupCreate" in content || "groupUpdate" in content))
-                throw new ChatError("invalid-input", "Use createGroup or updateGroup for group changes");
+            if (content && ("groupCreate" in content || "groupUpdate" in content || "groupDissolve" in content))
+                throw new ChatError("invalid-input", "Use group lifecycle methods for group changes");
             const result = await this.advanced.sendMessage(threadId, content, options);
             return { id: result.hash, timestamp: result.t };
         });
@@ -275,6 +275,7 @@ export class ChatEngine {
         });
     }
     updateGroup(threadId, changes) { return this.threadOperation(threadId, async () => this.group(await this.advanced.updateGroup(threadId, changes))); }
+    dissolveGroup(threadId, options = {}) { return this.threadOperation(threadId, async () => this.group(await this.advanced.dissolveGroup(threadId, options))); }
     revokeAccess() { return this.operation(() => this.advanced.revokeAccess()); }
     close() { this.closed = true; return this.operation(() => this.advanced.close()).finally(() => { this.errors.clear(); this.targets.clear(); this.listeners.clear(); this.threadSubscribers.clear(); this.openQueue.clear(); this.views.clear(); this.summary = undefined; this.present = createMessagePresenter(); this.messageLists = new WeakMap(); this.groups = new WeakMap(); this.redactedQuotes = new WeakMap(); }); }
 }

package/lib/internal/createPublicChat.js

@@ -45,7 +45,7 @@ export function createPublicChat(options) {
         },
         getVoiceAttachment: (id, messageId, options = {}) => read(() => engine.getVoiceAttachment(id, messageId), options, lease => lease.release()),
         getGroup: (id, options = {}) => read(() => engine.getGroup(id), options), refreshGroup: (id, options = {}) => read(() => engine.getGroup(id, { refresh: true }), options),
-        createGroup: input => engine.createGroup(input), updateGroup: (id, changes) => engine.updateGroup(id, changes),
+        createGroup: input => engine.createGroup(input), updateGroup: (id, changes) => engine.updateGroup(id, changes), dissolveGroup: (id, options) => engine.dissolveGroup(id, options),
     });
     registerChat(chat, engine);
     return chat;

package/lib/messageView.js

@@ -51,7 +51,7 @@ function content(message) {
     }
     else if (body.kind === "group") {
         result.kind = "system";
-        result.system = { type: body.action === "groupCreate" ? "group-created" : "group-updated", title: text(object(body.payload).title) || undefined };
+        result.system = { type: body.action === "groupCreate" ? "group-created" : body.action === "groupDissolve" ? "group-dissolved" : "group-updated", title: text(object(body.payload).title) || undefined };
     }
     else if (file) {
         result.kind = "attachment";

package/lib/runtime/chatClient.d.ts

@@ -123,6 +123,11 @@ export declare class ChatClient {
         title?: string;
         avatar?: string;
     }): Promise<ChatRuntimeMessage>;
+    dissolveGroup(input: {
+        groupId: string;
+        teamId?: string;
+        expectedRevision: string;
+    }): Promise<ChatRuntimeMessage>;
     sendGroup(input: {
         groupId: string;
         teamId?: string;

package/lib/runtime/chatClient.js

@@ -252,6 +252,12 @@ export class ChatClient {
                 addMembers: input.addMembers ?? [], removeMembers: input.removeMembers ?? [], ...(input.title !== undefined ? { title: input.title } : {}), ...(input.avatar !== undefined ? { avatar: input.avatar } : {}) },
         });
     }
+    async dissolveGroup(input) {
+        return this.sendChat(input.groupId, {
+            kind: "group", threadKind: "group", action: "groupDissolve",
+            payload: { appId: this.options.appId, groupId: input.groupId, ...(input.teamId !== undefined ? { teamId: input.teamId } : {}), expectedRevision: input.expectedRevision },
+        });
+    }
     async sendGroup(input) {
         return this.sendChat(input.groupId, {
             kind: "message",

package/lib/runtime/chatSession.d.ts

@@ -149,6 +149,9 @@ export declare class ChatSession<T extends StoredMessage> {
         title?: string;
         avatar?: string;
     }): Promise<ChatGroup>;
+    dissolveGroup(target: ChatConversation | string, options?: {
+        expectedRevision?: string;
+    }): Promise<ChatGroup>;
     sendMessage(threadId: string, input: OutgoingContent, options?: {
         waitFor?: "accepted" | "delivered";
     }): Promise<ChatRuntimeMessage>;

package/lib/runtime/chatSession.js

@@ -403,6 +403,16 @@ export class ChatSession {
         await this.sendMessage(thread, { groupUpdate: { ...changes, expectedRevision: changes.expectedRevision ?? previous.revision } }, { waitFor: "delivered" });
         return this.groups.after(thread, previous.versionNumber + 1);
     }
+    async dissolveGroup(target, options = {}) {
+        const thread = typeof target === "string" ? await this.resolveConversation(target) : target;
+        const previous = await this.getGroup(thread);
+        if (previous.status === "dissolved")
+            return previous;
+        if (previous.versionNumber >= Number.MAX_SAFE_INTEGER)
+            throw new Error("INVALID_GROUP_VERSION");
+        await this.sendMessage(thread, { groupDissolve: { expectedRevision: options.expectedRevision ?? previous.revision } }, { waitFor: "delivered" });
+        return this.groups.after(thread, previous.versionNumber + 1);
+    }
     sendMessage(thread, input, options = {}) {
         this.assertOpen();
         if (options.waitFor !== undefined && !["accepted", "delivered"].includes(options.waitFor))
@@ -434,8 +444,10 @@ export class ChatSession {
         await this.conversations.put(thread);
         this.assertOpen();
         // Recipients are SDK-owned metadata, never an App-supplied roster.
-        if (thread.kind === "group" && !input.groupCreate && !input.groupUpdate) {
+        if (thread.kind === "group" && !input.groupCreate && !input.groupUpdate && !input.groupDissolve) {
             const group = await this.getGroup(thread);
+            if (group.status === "dissolved")
+                throw new Error("GROUP_DISSOLVED");
             this.assertOpen();
             thread = { ...thread, memberIds: group.memberIds };
         }

package/lib/runtime/durableSender.js

@@ -876,7 +876,7 @@ export class DurableChatSender {
         }
     }
 }
-function statefulGroup(message) { const body = message.body; return body?.kind === "group" && (body.action === "groupCreate" || body.action === "groupUpdate"); }
+function statefulGroup(message) { const body = message.body; return body?.kind === "group" && (body.action === "groupCreate" || body.action === "groupUpdate" || body.action === "groupDissolve"); }
 function commandId(scope, version, threadId, message) {
     return bytesToHex(blake3(new TextEncoder().encode(JSON.stringify(["chat-command:v1", scope, version, threadId, message.to, ordered(message.body)]))));
 }

package/lib/runtime/groupClient.d.ts

@@ -2,7 +2,7 @@ import { type ResponseCacheAccess } from "./responseCache.js";
 import { type MessageScope } from "./messageStore.js";
 import { type ChatConversation } from "./outgoingContent.js";
 import type { SocialGroup } from "./socialReadClient.js";
-export type ChatGroup = {
+export type ActiveChatGroup = {
     groupId: string;
     teamId: string;
     ownerId: string;
@@ -11,7 +11,19 @@ export type ChatGroup = {
     memberIds: readonly string[];
     revision: string;
     versionNumber: number;
+    status: "active";
 };
+export type DissolvedChatGroup = {
+    groupId: string;
+    teamId: string;
+    ownerId: string;
+    revision: string;
+    versionNumber: number;
+    status: "dissolved";
+    dissolvedBy?: string;
+    dissolvedAt?: number;
+};
+export type ChatGroup = ActiveChatGroup | DissolvedChatGroup;
 export type GroupSnapshot = {
     data?: ChatGroup;
     loading: boolean;

package/lib/runtime/groupClient.js

@@ -106,12 +106,19 @@ export class GroupClient {
     }
     normalize(value, entry) {
         const scope = this.options.scope;
-        if (!value || value.appId !== scope.appId || value.groupId !== entry.thread.targetId || value.teamId !== scope.teamId || !validMessageIdentifier(value.ownerId) || !validMessageIdentifier(value.revision) || !Number.isSafeInteger(value.versionNumber) || value.versionNumber < 1 || !Array.isArray(value.members) || !value.members.length || value.members.length > 256 || !value.members.every(validMessageIdentifier) || !value.members.includes(value.ownerId) || !value.members.includes(scope.profileId) || typeof value.title !== "string" || value.avatar !== undefined && value.avatar !== null && typeof value.avatar !== "string")
+        if (!value || value.appId !== scope.appId || value.groupId !== entry.thread.targetId || value.teamId !== scope.teamId || !validMessageIdentifier(value.ownerId) || !validMessageIdentifier(value.revision) || !Number.isSafeInteger(value.versionNumber) || value.versionNumber < 1)
             throw new Error("INVALID_GROUP_METADATA");
-        return Object.freeze({ groupId: value.groupId, teamId: scope.teamId, ownerId: value.ownerId, title: value.title, ...(value.avatar ? { avatar: value.avatar } : {}), memberIds: Object.freeze([...new Set(value.members)].sort()), revision: value.revision, versionNumber: value.versionNumber });
+        if (value.status === "dissolved") {
+            if (value.dissolvedBy !== undefined && !validMessageIdentifier(value.dissolvedBy) || value.dissolvedAt !== undefined && (!Number.isSafeInteger(value.dissolvedAt) || value.dissolvedAt < 0))
+                throw new Error("INVALID_GROUP_METADATA");
+            return Object.freeze({ groupId: value.groupId, teamId: scope.teamId, ownerId: value.ownerId, revision: value.revision, versionNumber: value.versionNumber, status: "dissolved", ...(value.dissolvedBy ? { dissolvedBy: value.dissolvedBy } : {}), ...(value.dissolvedAt === undefined ? {} : { dissolvedAt: value.dissolvedAt }) });
+        }
+        if (value.status !== undefined && value.status !== "active" || !Array.isArray(value.members) || !value.members.length || value.members.length > 256 || !value.members.every(validMessageIdentifier) || !value.members.includes(value.ownerId) || !value.members.includes(scope.profileId) || typeof value.title !== "string" || value.avatar !== undefined && value.avatar !== null && typeof value.avatar !== "string")
+            throw new Error("INVALID_GROUP_METADATA");
+        return Object.freeze({ groupId: value.groupId, teamId: scope.teamId, ownerId: value.ownerId, title: value.title, ...(value.avatar ? { avatar: value.avatar } : {}), memberIds: Object.freeze([...new Set(value.members)].sort()), revision: value.revision, versionNumber: value.versionNumber, status: "active" });
     }
     cached(value, entry) {
-        return this.normalize({ appId: this.options.scope.appId, groupId: value?.groupId, teamId: value?.teamId, ownerId: value?.ownerId, title: value?.title, avatar: value?.avatar, members: value?.memberIds, revision: value?.revision, versionNumber: value?.versionNumber }, entry);
+        return this.normalize(value.status === "dissolved" ? { appId: this.options.scope.appId, ...value } : { appId: this.options.scope.appId, ...value, members: value.memberIds }, entry);
     }
     local(entry) {
         if (entry.loaded)

package/lib/runtime/outgoingContent.d.ts

@@ -73,6 +73,11 @@ type ContentChoices = {
             avatar?: string;
         };
     };
+    groupDissolve: {
+        groupDissolve: {
+            expectedRevision: string;
+        };
+    };
 };
 export type OutgoingContent = {
     [K in keyof ContentChoices]: ContentChoices[K] & {

package/lib/runtime/outgoingContent.js

@@ -1,6 +1,6 @@
 import { parseChatFile } from "../fileMetadata.js";
 import { dmThreadId, groupThreadId } from "./thread.js";
-const contentKeys = ["text", "file", "image", "voice", "recall", "reaction", "invitation", "groupCreate", "groupUpdate"];
+const contentKeys = ["text", "file", "image", "voice", "recall", "reaction", "invitation", "groupCreate", "groupUpdate", "groupDissolve"];
 export function validMessageIdentifier(value) { return typeof value === "string" && value.length > 0 && new TextEncoder().encode(value).byteLength <= 256 && !/[\u0000-\u001f]/u.test(value); }
 function members(value) {
     if (!Array.isArray(value) || value.length > 256 || !value.every(validMessageIdentifier))
@@ -63,6 +63,11 @@ export function outgoingContent(scope, thread, input) {
             throw new Error("INVALID_GROUP_AVATAR");
         return { to: thread.targetId, body: { kind: "group", threadKind: "group", action: "groupUpdate", payload: { ...identity, groupId: thread.targetId, expectedRevision: update.expectedRevision, addMembers: add, removeMembers: remove, ...(update.title === undefined ? {} : { title: update.title.trim() }), ...(update.avatar === undefined ? {} : { avatar: update.avatar }) } } };
     }
+    if (input.groupDissolve) {
+        if (thread.kind !== "group" || !validMessageIdentifier(input.groupDissolve.expectedRevision))
+            throw new Error("INVALID_GROUP_DISSOLVE");
+        return { to: thread.targetId, body: { kind: "group", threadKind: "group", action: "groupDissolve", payload: { ...identity, groupId: thread.targetId, expectedRevision: input.groupDissolve.expectedRevision } } };
+    }
     if (thread.kind === "group" && !Array.isArray(thread.memberIds))
         throw new Error("MESSAGE_GROUP_MEMBERS_UNAVAILABLE");
     const recipients = thread.kind === "group" ? [...new Set(thread.memberIds)] : undefined;

package/lib/runtime/socialReadClient.d.ts

@@ -18,11 +18,14 @@ export type SocialGroup = {
     groupId: string;
     teamId?: string | null;
     ownerId: string;
-    members: string[];
-    title: string;
+    members?: readonly string[];
+    title?: string;
     avatar?: string | null;
     revision: string;
     versionNumber?: number;
+    status?: "active" | "dissolved";
+    dissolvedBy?: string;
+    dissolvedAt?: number;
 };
 export type SocialRelationship = {
     appId: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pmate/chat-sdk",
-  "version": "0.12.0-next.73",
+  "version": "0.12.0-next.74",
   "description": "Local-first chat SDK, message subscriptions, reading state, and shared chat UI primitives",
   "type": "module",
   "main": "./lib/index.js",
@@ -53,6 +53,15 @@
   "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": {
     "@emoji-mart/data": "^1.2.1",
     "@emoji-mart/react": "^1.1.1",
@@ -68,24 +77,16 @@
   "devDependencies": {
     "@storybook/addon-docs": "^9.0.17",
     "@storybook/react-vite": "9.0.17",
-    "@tailwindcss/vite": "^4.1.3",
-    "@types/react": "^19.2.7",
-    "@types/react-dom": "^19.2.3",
+    "@tailwindcss/vite": "catalog:",
+    "@types/react": "catalog:",
+    "@types/react-dom": "catalog:",
     "fake-indexeddb": "^6.2.5",
-    "react": "^19.1.1",
-    "react-dom": "^19.1.1",
+    "react": "catalog:",
+    "react-dom": "catalog:",
     "rimraf": "^6.1.2",
     "storybook": "^9.0.17",
-    "tailwindcss": "^4.0.14",
+    "tailwindcss": "catalog:",
     "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"
   }
-}
+}