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

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/chatError.js

@@ -20,7 +20,7 @@ export function asChatError(error) {
         : /CLOSED/.test(message) ? "closed"
             : status === 409 || /REVISION_CONFLICT|PROJECTION_CHANGED/.test(message) ? "conflict"
                 : /BACKPRESSURE|TOO_LARGE/.test(message) ? "busy"
-                    : status === 400 || /INVALID_|CONVERSATION_MISMATCH|NOT_OWNED/.test(message) ? "invalid-input"
+                    : status === 400 || /INVALID_|CONVERSATION_MISMATCH|CONVERSATION_UNKNOWN|NOT_OWNED/.test(message) ? "invalid-input"
                         : /QuotaExceeded|DatabaseClosed|UnknownError|AbortError/.test(value?.name ?? "") || /STORAGE_|DATABASE_|CACHE_WRITE/.test(message) ? "storage-unavailable" : "unavailable";
     return new ChatError(code, message, { cause: error, status });
 }

package/lib/runtime/chatSession.js

@@ -444,21 +444,32 @@ export class ChatSession {
     /** Validated target identity survives content redaction; no roster is exposed. */
     getConversationTarget(threadId) {
         const scope = this.options.messages.scope;
-        const group = this.getSnapshot(threadId).group;
+        const snapshot = this.getSnapshot(threadId), group = snapshot.group;
         if (group)
             return { id: threadId, kind: "group", targetId: group.groupId, teamId: scope.teamId };
-        for (const value of this.getSnapshot(threadId).messages) {
-            const row = value;
+        const infer = (row) => {
             const kind = row.threadKind ?? row.body?.threadKind;
             if ((kind !== "group" && kind !== "dm") || !row.to || !row.from)
-                continue;
+                return undefined;
             const thread = { id: threadId, kind, targetId: kind === "group" || row.from === scope.profileId ? row.to : row.from, teamId: scope.teamId };
-            // A stored row is only a hint; validate the canonical scoped identifier.
             try {
                 validateConversation(scope, thread);
                 return thread;
             }
-            catch { }
+            catch {
+                return undefined;
+            }
+        };
+        for (const value of snapshot.messages) {
+            const thread = infer(value);
+            if (thread)
+                return thread;
+        }
+        // Older integrations may have a durable send but no registered target or indexed history yet.
+        for (const value of snapshot.outgoing) {
+            const thread = infer(value.message);
+            if (thread)
+                return thread;
         }
         return undefined;
     }

package/lib/runtime/conversationDirectory.d.ts

@@ -30,6 +30,7 @@ export declare class ConversationDirectory {
     put(thread: ChatConversation): Promise<ChatConversation>;
     private persist;
     get(id: string): Promise<ChatConversation | undefined>;
+    private lookup;
     private flush;
     retire(version: number): Promise<void>;
     close(): Promise<void>;

package/lib/runtime/conversationDirectory.js

@@ -19,7 +19,7 @@ export class ConversationDirectory {
     constructor(scope, access) {
         this.scope = scope;
         this.access = access;
-        this.cache = new IndexedDbResponseCache(`conversations:${messageScopeKey(scope)}`, { access: () => this.authorize(), entries: 256, recordBytes: 4096 });
+        this.cache = new IndexedDbResponseCache(`conversations:${messageScopeKey(scope)}`, { access: () => this.authorize(), entries: 256, recordBytes: 4096, retainAll: true });
     }
     authorize() { return this.authority ??= this.access().finally(() => { this.authority = undefined; }); }
     assertOpen() { if (this.retired)
@@ -56,18 +56,18 @@ export class ConversationDirectory {
         this.assertOpen();
         validateConversation(this.scope, thread);
         const value = { id: thread.id, kind: thread.kind, targetId: thread.targetId, teamId: this.scope.teamId };
-        const previous = await this.get(thread.id);
+        const row = await this.lookup(thread.id), previous = row.value;
         if (previous) {
             if (previous.kind !== value.kind || previous.targetId !== value.targetId)
                 throw new Error("MESSAGE_CONVERSATION_MISMATCH");
             return previous;
         }
-        const row = await this.cache.read(thread.id);
         await this.cache.write(thread.id, value, row.epoch);
         this.assertOpen();
         return this.remember(value);
     }
-    async get(id) {
+    async get(id) { return (await this.lookup(id)).value; }
+    async lookup(id) {
         this.assertOpen();
         const authority = await this.authorize();
         this.assertOpen();
@@ -78,7 +78,7 @@ export class ConversationDirectory {
         this.version = authority.version;
         const known = this.memory.get(id);
         if (known)
-            return this.remember(known);
+            return { value: this.remember(known), epoch: 0 };
         const existing = this.pending.get(id);
         if (existing)
             return existing;
@@ -98,13 +98,13 @@ export class ConversationDirectory {
             const rows = await this.cache.readMany(batch.map(item => item.id));
             this.assertOpen();
             for (const item of batch) {
-                const value = rows.get(item.id)?.cached?.value;
+                const row = rows.get(item.id), value = row.cached?.value;
                 if (value) {
                     if (value.id !== item.id)
                         throw new Error("MESSAGE_CONVERSATION_MISMATCH");
                     validateConversation(this.scope, value);
                 }
-                item.resolve(value ? this.remember(value) : undefined);
+                item.resolve({ value: value ? this.remember(value) : undefined, epoch: row.epoch });
             }
         }
         catch (error) {

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/lib/runtime/responseCache.d.ts

@@ -8,6 +8,8 @@ export type ResponseCacheOptions<T> = {
     indexedDB?: IDBFactory;
     name?: string;
     access?: ResponseCacheAccess;
+    /** Immutable identity metadata must survive ordinary response-window eviction. */
+    retainAll?: boolean;
     recordBytes?: number;
     entries?: number;
     batchRecords?: number;

package/lib/runtime/responseCache.js

@@ -59,7 +59,7 @@ export class IndexedDbResponseCache {
                     throw new Error("RESPONSE_CACHE_SCOPE_CHANGED");
                 if (access.version > version) {
                     await this.epochs.put({ scope: this.scope, epoch: (current?.epoch ?? 0) + 1, accessVersion: access.version });
-                    await this.rows.where("scope").equals(this.scope).delete();
+                    await this.rows.where("[scope+key]").between([this.scope, Dexie.minKey], [this.scope, Dexie.maxKey], true, true).delete();
                 }
             });
         if (!access.allowed)
@@ -114,7 +114,7 @@ export class IndexedDbResponseCache {
             if ((current?.accessVersion ?? 0) >= version)
                 return;
             await this.epochs.put({ scope: this.scope, epoch: (current?.epoch ?? 0) + 1, accessVersion: version });
-            await this.rows.where("scope").equals(this.scope).delete();
+            await this.rows.where("[scope+key]").between([this.scope, Dexie.minKey], [this.scope, Dexie.maxKey], true, true).delete();
         });
         this.invalidations.add(task);
         return task.finally(() => this.invalidations.delete(task));
@@ -127,7 +127,7 @@ export class IndexedDbResponseCache {
                 const current = await this.epochs.get(this.scope);
                 const epoch = (current?.epoch ?? 0) + 1;
                 await this.epochs.put({ scope: this.scope, epoch, accessVersion: current?.accessVersion });
-                await this.rows.where("scope").equals(this.scope).delete();
+                await this.rows.where("[scope+key]").between([this.scope, Dexie.minKey], [this.scope, Dexie.maxKey], true, true).delete();
             });
         })();
         this.invalidations.add(task);
@@ -178,14 +178,16 @@ export class IndexedDbResponseCache {
                         }
                         if (unique.size) {
                             await this.rows.bulkPut([...unique.values()]);
-                            const stored = await this.rows.where("scope").equals(this.scope).toArray();
-                            stored.sort((a, b) => b.time - a.time || a.key.localeCompare(b.key));
-                            let bytes = 0;
-                            const evicted = [];
-                            stored.forEach((row, index) => { bytes += row.bytes; if (index >= (this.options.entries ?? 256) || bytes > 1048576)
-                                evicted.push([this.scope, row.key]); });
-                            if (evicted.length)
-                                await this.rows.bulkDelete(evicted);
+                            if (!this.options.retainAll) {
+                                const stored = await this.rows.where("scope").equals(this.scope).toArray();
+                                stored.sort((a, b) => b.time - a.time || a.key.localeCompare(b.key));
+                                let bytes = 0;
+                                const evicted = [];
+                                stored.forEach((row, index) => { bytes += row.bytes; if (index >= (this.options.entries ?? 256) || bytes > 1048576)
+                                    evicted.push([this.scope, row.key]); });
+                                if (evicted.length)
+                                    await this.rows.bulkDelete(evicted);
+                            }
                         }
                         return { accepted, changed };
                     });

package/package.json

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