@pmate/chat-sdk 0.12.0-next.79 → 0.12.0-next.80

package/lib/snapshot.d.ts

@@ -0,0 +1,36 @@
+import { type SocialGroup } from "./runtime/socialReadClient.js";
+import type { ChatMessage, UnreadState } from "./chatTypes.js";
+export type ConversationSnapshotOptions = {
+    appId: string;
+    accountId: string;
+    profileId: string;
+    teamId: string;
+    threadId: string;
+    token: string;
+    hubHttpUrl?: string;
+    limit?: number;
+    fetch?: typeof fetch;
+    signal?: AbortSignal;
+};
+export type ConversationSnapshot = Readonly<{
+    appId: string;
+    accountId: string;
+    profileId: string;
+    teamId: string;
+    threadId: string;
+    generatedAt: number;
+    contact: Readonly<{
+        peerId: string;
+        type: "group" | "user";
+    }>;
+    group: SocialGroup | null;
+    messages: readonly ChatMessage[];
+    hasEarlier: boolean;
+    unread: UnreadState;
+    checkpoint: string;
+    readingCursor: string;
+    serverTiming: string | null;
+}>;
+/** One network first-screen read. This does not open a socket, write a body cache,
+ * install a partial reading index, or mark anything read. Live SDK state takes over later. */
+export declare function fetchConversationSnapshot(options: ConversationSnapshotOptions): Promise<ConversationSnapshot>;

package/lib/snapshot.js

@@ -0,0 +1,50 @@
+import { SocialReadError } from "./runtime/socialReadClient.js";
+import { projectConversationReading } from "./runtime/conversationReading.js";
+import { projectMessageTimeline } from "./runtime/messageTimeline.js";
+import { createMessagePresenter } from "./messageView.js";
+const invalid = () => new SocialReadError(502, "INVALID_THREAD_SNAPSHOT_RESPONSE");
+/** One network first-screen read. This does not open a socket, write a body cache,
+ * install a partial reading index, or mark anything read. Live SDK state takes over later. */
+export async function fetchConversationSnapshot(options) {
+    const limit = options.limit ?? 30;
+    if (!Number.isSafeInteger(limit) || limit < 1 || limit > 100)
+        throw new SocialReadError(400, "INVALID_THREAD_SNAPSHOT_LIMIT");
+    const query = new URLSearchParams({ appId: options.appId, profileId: options.profileId, teamId: options.teamId, threadId: options.threadId, limit: String(limit) });
+    const response = await (options.fetch ?? fetch)(`${(options.hubHttpUrl ?? "https://hub.pmate.chat").replace(/\/+$/, "")}/api/social/thread-snapshot?${query}`, {
+        headers: { authorization: `Bearer ${options.token}`, accept: "application/json" }, cache: "no-store", redirect: "error",
+        signal: options.signal ? AbortSignal.any([options.signal, AbortSignal.timeout(15000)]) : AbortSignal.timeout(15000),
+    });
+    const envelope = await response.json().catch(() => null);
+    if (!response.ok || envelope?.success !== true)
+        throw new SocialReadError(response.status, envelope?.message ?? "THREAD_SNAPSHOT_FAILED");
+    const value = envelope.data;
+    if (!value || value.schemaVersion !== 1 || ["appId", "accountId", "profileId", "teamId", "threadId"].some(key => value[key] !== options[key]) || !Number.isFinite(value.generatedAt))
+        throw invalid();
+    const cursor = (value) => typeof value === "string" && /^mp1:\d+:[0-9a-f]{64}$/.test(value);
+    const page = value.page, reading = value.reading;
+    if (!page || !Array.isArray(page.messages) || page.messages.length > limit || !cursor(page.checkpoint) || (page.nextBefore !== null && !cursor(page.nextBefore)) || typeof page.hasMoreChanges !== "boolean" || page.hasMoreChanges || page.resetRequired !== false)
+        throw invalid();
+    if (page.messages.some(row => row.appId !== options.appId || row.teamId !== options.teamId || row.threadId !== options.threadId || !row.messageId || !Number.isFinite(row.serverCreatedAt)))
+        throw invalid();
+    if (!value.contact || !["group", "user"].includes(value.contact.type) || !value.contact.peerId)
+        throw invalid();
+    if (value.contact.type === "group" && (!value.group || value.group.appId !== options.appId || value.group.teamId !== options.teamId || value.group.groupId !== value.contact.peerId || !["active", "dissolved"].includes(value.group.status ?? "")))
+        throw invalid();
+    if (!reading || reading.schemaVersion !== 1 || reading.appId !== options.appId || reading.profileId !== options.profileId || reading.scope !== "thread-window" || typeof reading.syncCursor !== "string" || !Array.isArray(reading.threads) || reading.threads.length > 1 || reading.threads.some(thread => thread.id !== options.threadId || thread.teamId !== options.teamId || !Array.isArray(thread.messages) || !Array.isArray(thread.explicitReadMessageIds) || !Number.isSafeInteger(thread.readThroughSeq)))
+        throw invalid();
+    const summary = reading.summary;
+    if (!summary || [summary.unreadMessageCount, summary.unreadMentionCount, summary.badgeCount].some(count => !Number.isSafeInteger(count) || count < 0))
+        throw invalid();
+    const ids = new Set(page.messages.map(row => row.messageId));
+    if (reading.threads.some(thread => thread.messages.some(fact => !ids.has(fact.id) || !Number.isSafeInteger(fact.seq) || !Array.isArray(fact.recipients) || !Array.isArray(fact.mentions) || !["visible", "explicit"].includes(fact.readPolicy))))
+        throw invalid();
+    const facts = new Map(reading.threads.flatMap(thread => thread.messages).map(fact => [fact.id, fact]));
+    const messages = page.messages.map(row => ({ ...row, id: row.messageId, timestamp: row.serverCreatedAt, ...(facts.get(row.messageId)?.recalled ? { recalled: true } : {}) }));
+    const kind = value.contact.type === "group" ? "group" : "dm";
+    const state = { ...reading, pending: [] };
+    const projected = projectConversationReading(state, { id: options.threadId, kind });
+    const present = createMessagePresenter();
+    const timeline = projectMessageTimeline({ appId: options.appId, profileId: options.profileId, threadId: options.threadId, messages, outgoing: [], decode: () => undefined, reading: projected.messageReading });
+    return { appId: value.appId, accountId: value.accountId, profileId: value.profileId, teamId: value.teamId, threadId: value.threadId, generatedAt: value.generatedAt, contact: value.contact, group: value.group,
+        messages: timeline.map(present), hasEarlier: page.nextBefore !== null, unread: summary, checkpoint: page.checkpoint, readingCursor: reading.syncCursor, serverTiming: response.headers.get("server-timing") };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pmate/chat-sdk",
-  "version": "0.12.0-next.79",
+  "version": "0.12.0-next.80",
   "description": "Local-first chat SDK, message subscriptions, reading state, and shared chat UI primitives",
   "type": "module",
   "main": "./lib/index.js",
@@ -48,6 +48,11 @@
       "types": "./lib/history.d.ts",
       "import": "./lib/history.js",
       "default": "./lib/history.js"
+    },
+    "./snapshot": {
+      "types": "./lib/snapshot.d.ts",
+      "import": "./lib/snapshot.js",
+      "default": "./lib/snapshot.js"
     }
   },
   "publishConfig": {