@pmate/chat-sdk 0.12.0-next.7 → 0.12.0-next.70

package/lib/runtime/socialReadClient.d.ts

@@ -22,6 +22,7 @@ export type SocialGroup = {
     title: string;
     avatar?: string | null;
     revision: string;
+    versionNumber?: number;
 };
 export type SocialRelationship = {
     appId: string;
@@ -45,7 +46,7 @@ export declare class SocialReadClient {
     private readonly options;
     constructor(options: SocialReadClientOptions);
     /** Without teamId includes current Teams and unassigned contact metadata for migration. */
-    contacts(teamId?: string): Promise<ChatReaderContact[]>;
+    contacts(teamId?: string, signal?: AbortSignal): Promise<ChatReaderContact[]>;
     unread(teamId?: string): Promise<ChatReaderUnread[]>;
     messages(input: {
         threadId: string;
@@ -57,11 +58,12 @@ export declare class SocialReadClient {
         limit?: number;
         before?: string;
         after?: string;
+        messageId?: string;
     }, signal?: AbortSignal): Promise<SocialMessagePage>;
     group(input: {
         groupId: string;
         teamId?: string;
-    }): Promise<SocialGroup>;
+    }, signal?: AbortSignal): Promise<SocialGroup>;
     relationship(input: {
         peerId: string;
         teamId?: string;

package/lib/runtime/socialReadClient.js

@@ -14,8 +14,8 @@ export class SocialReadClient {
     options;
     constructor(options) { this.options = { ...options }; }
     /** Without teamId includes current Teams and unassigned contact metadata for migration. */
-    contacts(teamId) {
-        return this.list("contacts", this.teamQuery(teamId));
+    contacts(teamId, signal) {
+        return this.list("contacts", this.teamQuery(teamId), signal);
     }
     unread(teamId) {
         return this.list("unread", this.teamQuery(teamId));
@@ -26,22 +26,26 @@ export class SocialReadClient {
     }
     async messagePage(input, signal) {
         this.requireTeam(input.teamId);
-        const limit = input.limit ?? 100;
+        const limit = input.limit ?? (input.messageId === undefined ? 100 : 1);
         if (!Number.isSafeInteger(limit) || limit < 1 || limit > 500 || (input.before !== undefined && input.after !== undefined))
             throw new SocialReadError(400, "INVALID_MESSAGE_PAGE");
+        if (input.messageId !== undefined && (!input.messageId || input.messageId.length > 256 || /[\u0000-\u001f\u007f]/.test(input.messageId) || limit !== 1 || input.before !== undefined || input.after !== undefined))
+            throw new SocialReadError(400, "INVALID_MESSAGE_LOOKUP");
         const value = await this.request("messages", { threadId: input.threadId, ...this.teamQuery(input.teamId), limit: String(limit),
-            ...(input.before === undefined ? {} : { before: input.before }), ...(input.after === undefined ? {} : { after: input.after }) }, signal);
+            ...(input.before === undefined ? {} : { before: input.before }), ...(input.after === undefined ? {} : { after: input.after }), ...(input.messageId === undefined ? {} : { messageId: input.messageId }) }, signal);
         const cursor = (token) => typeof token === "string" && /^mp1:\d+:[0-9a-f]{64}$/.test(token);
         if (!value || !Array.isArray(value.messages) || value.messages.length > limit || !cursor(value.checkpoint)
             || (value.nextBefore !== null && !cursor(value.nextBefore)) || typeof value.hasMoreChanges !== "boolean" || typeof value.resetRequired !== "boolean"
             || value.messages.some(row => row.appId !== this.options.appId || row.threadId !== input.threadId || row.teamId !== input.teamId || !row.messageId || !Number.isFinite(row.serverCreatedAt))
             || (value.resetRequired && (value.messages.length || value.hasMoreChanges || value.nextBefore !== null)))
             throw new SocialReadError(502, "INVALID_MESSAGE_PAGE_RESPONSE");
+        if (input.messageId !== undefined && (value.messages.some(row => row.messageId !== input.messageId) || value.nextBefore !== null || value.hasMoreChanges || value.resetRequired))
+            throw new SocialReadError(502, "INVALID_MESSAGE_LOOKUP_RESPONSE");
         return value;
     }
-    group(input) {
+    group(input, signal) {
         this.requireTeam(input.teamId);
-        return this.request("group", { groupId: input.groupId, ...this.teamQuery(input.teamId) });
+        return this.request("group", { groupId: input.groupId, ...this.teamQuery(input.teamId) }, signal);
     }
     relationship(input) {
         this.requireTeam(input.teamId);
@@ -54,8 +58,8 @@ export class SocialReadClient {
         if (this.options.appId === "pmate:merry" && !teamId)
             throw new SocialReadError(400, "TEAM_ID_REQUIRED");
     }
-    async list(action, query) {
-        const value = await this.request(action, query);
+    async list(action, query, signal) {
+        const value = await this.request(action, query, signal);
         if (!Array.isArray(value))
             throw new SocialReadError(502, "INVALID_SOCIAL_READ_RESPONSE");
         return value;

package/lib/runtime/voiceUpload.d.ts

@@ -0,0 +1,2 @@
+/** The SDK owns upload I/O; hosts configure only their service endpoint. */
+export declare function voiceUploader(profileId: string, endpoint?: string, fetcher?: typeof fetch): (blob: Blob, signal: AbortSignal) => Promise<string>;

package/lib/runtime/voiceUpload.js

@@ -0,0 +1,27 @@
+import { isOffline } from "./connectivity.js";
+/** The SDK owns upload I/O; hosts configure only their service endpoint. */
+export function voiceUploader(profileId, endpoint = "https://upload-fc.pmate.chat", fetcher = globalThis.fetch) {
+    return async (blob, signal) => {
+        if (signal.aborted)
+            throw new DOMException("Upload aborted", "AbortError");
+        if (isOffline())
+            throw new Error("VOICE_UPLOAD_OFFLINE");
+        const bytes = new Uint8Array(await blob.arrayBuffer());
+        if (signal.aborted)
+            throw new DOMException("Upload aborted", "AbortError");
+        let binary = "";
+        for (let offset = 0; offset < bytes.length; offset += 32768)
+            binary += String.fromCharCode(...bytes.subarray(offset, offset + 32768));
+        const extension = blob.type.includes("mp4") ? "m4a" : blob.type.includes("mpeg") ? "mp3" : "webm";
+        const type = extension === "m4a" ? "audio/mp4" : extension === "mp3" ? "audio/mpeg" : "audio/webm";
+        if (isOffline())
+            throw new Error("VOICE_UPLOAD_OFFLINE");
+        const response = await fetcher(`${endpoint.replace(/\/+$/, "")}/file`, { method: "POST", signal, headers: { "Content-Type": "application/json", "x-file-content-type": type }, body: JSON.stringify({ user: profileId, base64: btoa(binary), filename: `voice-${Date.now()}.${extension}` }) });
+        if (!response.ok)
+            throw new Error("VOICE_UPLOAD_FAILED");
+        const result = await response.json();
+        if (typeof result.data !== "string" || !result.data)
+            throw new Error("VOICE_UPLOAD_FAILED");
+        return result.data;
+    };
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pmate/chat-sdk",
-  "version": "0.12.0-next.7",
-  "description": "Cross-platform PMate chat input components, voice input primitives, and ASR helpers",
+  "version": "0.12.0-next.70",
+  "description": "Local-first chat SDK, message subscriptions, reading state, and shared chat UI primitives",
   "type": "module",
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",
@@ -19,10 +19,35 @@
       "import": "./lib/index.js",
       "default": "./lib/index.js"
     },
+    "./bootstrap": {
+      "types": "./lib/runtime/messageLaunch.d.ts",
+      "import": "./lib/runtime/messageLaunch.js",
+      "default": "./lib/runtime/messageLaunch.js"
+    },
     "./runtime": {
       "types": "./lib/runtime/index.d.ts",
       "import": "./lib/runtime/index.js",
       "default": "./lib/runtime/index.js"
+    },
+    "./chat": {
+      "types": "./lib/chat.d.ts",
+      "import": "./lib/chat.js",
+      "default": "./lib/chat.js"
+    },
+    "./advanced": {
+      "types": "./lib/advanced.d.ts",
+      "import": "./lib/advanced.js",
+      "default": "./lib/advanced.js"
+    },
+    "./framework": {
+      "types": "./lib/framework.d.ts",
+      "import": "./lib/framework.js",
+      "default": "./lib/framework.js"
+    },
+    "./history": {
+      "types": "./lib/history.d.ts",
+      "import": "./lib/history.js",
+      "default": "./lib/history.js"
     }
   },
   "publishConfig": {