@pmate/chat-sdk 0.12.0-next.65 → 0.12.0-next.66

package/lib/chat.d.ts

@@ -48,6 +48,17 @@ export type MessageQuery = {
     all?: boolean;
     refresh?: boolean;
 };
+export type ReadersQuery = {
+    afterProfileId?: string;
+    revision?: number;
+};
+export type GroupChanges = {
+    expectedRevision?: string;
+    addMembers?: readonly string[];
+    removeMembers?: readonly string[];
+    title?: string;
+    avatar?: string;
+};
 export type SendOptions = {
     waitFor?: "accepted" | "delivered";
 };
@@ -92,7 +103,7 @@ export declare class Chat {
     private notify;
     observeMessages(threadId: string, ids: string[], event: "visible" | "played"): Promise<void>;
     markRead(threadId: string): Promise<void>;
-    getReaders(threadId: string, messageId: string, page?: Parameters<ChatSession<CachedChatMessage>["getReaders"]>[2], signal?: AbortSignal): Promise<import("./runtime/messageReaders.js").MessageReadersPage>;
+    getReaders(threadId: string, messageId: string, page?: ReadersQuery, signal?: AbortSignal): Promise<import("./runtime/messageReaders.js").MessageReadersPage>;
     watchReaders(threadId: string | undefined, ids: string[], receiver?: string): Promise<void>;
     handleReach(event: Parameters<ChatSession<CachedChatMessage>["handleReach"]>[0]): Promise<"handled" | undefined>;
     getVoiceAttachment(threadId: string, messageId: string): Promise<import("./runtime/durableSender.js").VoiceAttachmentLease>;
@@ -113,7 +124,7 @@ export declare class Chat {
         ownerId: string;
         memberIds: readonly string[];
     }>;
-    updateGroup(threadId: string, changes: Parameters<ChatSession<CachedChatMessage>["updateGroup"]>[1]): Promise<Readonly<Omit<RuntimeGroup, "versionNumber">>>;
+    updateGroup(threadId: string, changes: GroupChanges): Promise<Readonly<Omit<RuntimeGroup, "versionNumber">>>;
     revokeAccess(): Promise<void>;
     close(): Promise<void>;
 }

package/lib/chat.js

@@ -191,7 +191,13 @@ export class Chat {
     notify(threadId) { this.listeners.get(threadId)?.forEach(listener => listener()); this.listeners.get("")?.forEach(listener => listener()); }
     observeMessages(threadId, ids, event) { return this.threadOperation(threadId, async () => { await this.advanced.observeMessages(threadId, ids, event); }); }
     markRead(threadId) { return this.threadOperation(threadId, async () => { await this.advanced.markRead(threadId); }); }
-    getReaders(threadId, messageId, page = {}, signal) { return this.threadOperation(threadId, () => this.advanced.getReaders(threadId, messageId, page, signal)); }
+    getReaders(threadId, messageId, page = {}, signal) {
+        return this.threadOperation(threadId, async () => {
+            if (Object.keys(page).some(key => !["afterProfileId", "revision"].includes(key)))
+                throw new ChatError("invalid-input", "Unsupported reader query");
+            return this.advanced.getReaders(threadId, messageId, page, signal);
+        });
+    }
     watchReaders(threadId, ids, receiver) { return this.threadOperation(threadId, () => this.advanced.observeMessages(threadId, ids, "receipts", receiver)); }
     handleReach(event) { return this.operation(() => this.advanced.handleReach(event)); }
     getVoiceAttachment(threadId, messageId) { return this.threadOperation(threadId, () => this.advanced.getVoiceAttachment(threadId, messageId)); }

package/lib/index.d.ts

@@ -41,5 +41,5 @@ export * from "./runtime/socialReadClient";
 export * from "./ux/imagePaste";
 export * from "./hooks/useImageAttachments";
 export * from "./components/ImageAttachmentTray";
-export { createChat, Chat, ChatError, type ChatThreadSnapshot, type ChatMessage as MessageView, type ChatErrorCode, type ConversationTarget, type OutgoingContent, type CreateChatOptions, type ChatSnapshot, type SentMessage, type MessageQuery } from "./chat.js";
+export { createChat, Chat, ChatError, type ChatThreadSnapshot, type ChatMessage as MessageView, type ChatErrorCode, type ConversationTarget, type OutgoingContent, type CreateChatOptions, type ChatSnapshot, type SentMessage, type MessageQuery, type ReadersQuery, type GroupChanges } from "./chat.js";
 export { useChatSnapshot } from "./hooks/useChatSnapshot.js";

package/lib/messageView.d.ts

@@ -7,6 +7,7 @@ export type ChatMessage = Readonly<Omit<TimelineItem<CachedChatMessage>, "messag
     text: string;
     senderName?: string;
     senderAvatar?: string;
+    timeLabel?: string;
     image?: Readonly<{
         url: string;
         name?: string;

package/lib/messageView.js

@@ -38,7 +38,7 @@ function content(message) {
     const imageUrl = media(payload.url) ?? (hint.kind === "image" ? media(hint.imageUrl) : undefined);
     const messageQuote = quote(payload.quote) ?? quote(hint.quote);
     const rawText = text(payload.text) || text(object(body.payload).message);
-    const result = { kind: "text", text: validLegacy ? text(hint.content) : rawText, senderName: text(hint.senderName) || undefined, senderAvatar: media(hint.senderAvatar),
+    const result = { kind: "text", text: validLegacy ? text(hint.content) : rawText, senderName: text(hint.senderName) || undefined, senderAvatar: media(hint.senderAvatar), timeLabel: text(hint.createdAt) || undefined,
         recipientCount: message.threadKind === "dm" ? 1 : validLegacy ? typeof hint.recipientCount === "number" ? hint.recipientCount : undefined : Array.isArray(message.recipients) ? new Set(message.recipients.filter(id => id !== message.from)).size : undefined };
     if (validLegacy && ["emoji", "system", "attachment", "quote"].includes(String(hint.kind)))
         result.kind = hint.kind;

package/lib/runtime/messageLaunch.d.ts

@@ -1,3 +1,4 @@
+import { type ChatMessage } from "../messageView.js";
 import { type MessageScope } from "./messageStore.js";
 import { type CachedChatMessage } from "./cachedMessage.js";
 import { type TimelineItem } from "./messageTimeline.js";
@@ -12,6 +13,7 @@ export type MessageLaunchView = {
     threadId: string;
     metadata: MessageLaunchMetadata;
     images: Record<string, string>;
+    messages: readonly ChatMessage[]; /** @deprecated Advanced compatibility projection. */
     timeline: readonly TimelineItem<CachedChatMessage>[];
 };
 type Options = {

package/lib/runtime/messageLaunch.js

@@ -1,3 +1,4 @@
+import { createMessagePresenter } from "../messageView.js";
 import { Dexie } from "dexie";
 import { IndexedDbMessageStore, messageScopeKey, mergeStoredMessage } from "./messageStore.js";
 import { DurableChatSender } from "./durableSender.js";
@@ -47,6 +48,7 @@ export async function saveMessageLaunch(input, options = {}) {
 export function watchMessageLaunch(input, onChange, onError, options = {}) {
     const { scope, openId, threadId } = input, key = messageScopeKey(scope), store = messages(scope, options), { db, rows } = tickets(options);
     let closed = false, generation = 0, ticket, timer;
+    const present = createMessagePresenter();
     const channels = [];
     const stop = () => { if (closed)
         return; closed = true; generation++; clearTimeout(timer); tasks.close(); channels.forEach(channel => channel.close()); store.close(); db.close(); };
@@ -89,7 +91,9 @@ export function watchMessageLaunch(input, onChange, onError, options = {}) {
             return;
         }
         const timeline = projectMessageTimeline({ appId: scope.appId, profileId: scope.profileId, threadId, messages: page.messages, outgoing, decode: message => decodeCachedChatMessage(message, scope), reading: {} }).slice(-30);
-        onChange(timeline.length ? { openId, threadId, metadata: ticket.metadata, images: ticket.images, timeline } : undefined);
+        const normalized = timeline.map(present), visibleImages = new Set(normalized.flatMap(message => message.image ? [message.image.url] : []));
+        const images = Object.fromEntries(Object.entries(ticket.images).filter(([url]) => visibleImages.has(url)));
+        onChange(timeline.length ? { openId, threadId, metadata: ticket.metadata, images, messages: normalized, timeline } : undefined);
     };
     const tasks = new WindowedTasks(16, fail);
     if (typeof BroadcastChannel !== "undefined") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pmate/chat-sdk",
-  "version": "0.12.0-next.65",
+  "version": "0.12.0-next.66",
   "description": "Local-first chat SDK, message subscriptions, reading state, and shared chat UI primitives",
   "type": "module",
   "main": "./lib/index.js",