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

package/README.md

@@ -198,7 +198,7 @@ supported as an alternative; select one source. An ambiguous WebSocket AUTH_FAIL
 requires authentication rather than guessing that a permission failure expired.
 Closing fences late providers and prevents further authenticated network work.
 
-Sending accepts text/mentions/quotes, images, voice, recalls, reactions and
+Sending accepts text/mentions/quotes, images, files, voice, recalls, reactions and
 invitations through the same typed content union. The SDK resolves the target
 and group roster, expands @all and assigns reaction revisions. The default
 Promise resolves after durable acceptance and returns `{id,timestamp}`; outgoing
@@ -206,6 +206,7 @@ status is part of the same message list. `{waitFor:"delivered"}` waits for the
 server acknowledgement. `retryMessage(id)` retries a failed exact wire.
 
 ```ts
+await chat.sendMessage(threadId, {file:{url,name,size,mimeType}}) // uploaded HTTPS metadata
 await chat.sendMessage(threadId, {voice:{blob,durationMs}})
 await chat.sendMessage(threadId, {reaction:{messageId,emojiId,active:true}})
 await chat.sendMessage(threadId, {recall:{messageId}}, {waitFor:"delivered"})

package/lib/chatContract.d.ts

@@ -1,3 +1,4 @@
+import type { ChatFile } from "./fileMetadata.js";
 import type { ChatError } from "./chatError.js";
 import type { ChatMention } from "./mentions/model.js";
 import type { TokenProvider } from "./credentials.js";
@@ -73,6 +74,9 @@ type ContentChoices = {
             content: string;
         };
     };
+    file: {
+        file: ChatFile;
+    };
     image: {
         image: {
             url: string;

package/lib/chatTypes.d.ts

@@ -1,3 +1,5 @@
+import type { ChatFile } from "./fileMetadata.js";
+export type { ChatFile } from "./fileMetadata.js";
 import type { ChatError } from "./chatError.js";
 import type { ChatMention } from "./mentions/model.js";
 /** Stable product model. No storage, transport, Session or projection types. */
@@ -26,6 +28,7 @@ export type ChatMessage = Readonly<{
     senderName?: string;
     senderAvatar?: string;
     timeLabel?: string;
+    file?: ChatFile;
     image?: Readonly<{
         url: string;
         name?: string;
@@ -116,4 +119,3 @@ export type ChatSnapshot = Readonly<{
 export type ReadOptions = {
     signal?: AbortSignal;
 };
-export {};

package/lib/credentials.js

@@ -83,10 +83,11 @@ export class ChatCredentials {
     }
     getToken = async () => { return (await this.acquire()).token; };
     fetch = async (input, init) => {
+        const transport = this.transport;
         const url = new URL(input instanceof Request ? input.url : String(input)), headers = new Headers(init?.headers ?? (input instanceof Request ? input.headers : undefined));
         // Never attach an app credential to uploads, other origins or unauthenticated requests.
         if (url.origin !== this.origin || !headers.has("authorization"))
-            return this.transport(input, init);
+            return transport(input, init);
         const callerSignal = init?.signal ?? (input instanceof Request ? input.signal : undefined);
         const signal = AbortSignal.any([this.lifetime.signal, ...(callerSignal ? [callerSignal] : [])]);
         signal?.throwIfAborted();
@@ -94,7 +95,7 @@ export class ChatCredentials {
         const send = async (token) => {
             signal?.throwIfAborted();
             headers.set("authorization", `Bearer ${token}`);
-            return this.transport(original instanceof Request ? original.clone() : original, { ...init, headers, signal });
+            return transport(original instanceof Request ? original.clone() : original, { ...init, headers, signal });
         };
         const used = await waitForCaller(this.acquire(), signal ?? undefined);
         const response = await send(used.token);

package/lib/fileMetadata.d.ts

@@ -0,0 +1,9 @@
+/** Durable file reference. Upload limits and download policy belong to the host. */
+export type ChatFile = Readonly<{
+    url: string;
+    name: string;
+    size: number;
+    mimeType?: string;
+    expiresAt?: number;
+}>;
+export declare function parseChatFile(value: unknown): ChatFile | undefined;

package/lib/fileMetadata.js

@@ -0,0 +1,18 @@
+export function parseChatFile(value) {
+    if (!value || typeof value !== "object")
+        return;
+    const file = value;
+    if (typeof file.name !== "string" || !file.name.trim() || file.name.length > 255 || /[\u0000-\u001f\\/]/u.test(file.name) || typeof file.url !== "string" || file.url.length > 8192 || !Number.isSafeInteger(file.size) || Number(file.size) < 0)
+        return;
+    try {
+        const url = new URL(file.url);
+        if (url.protocol !== "https:" || url.username || url.password)
+            return;
+    }
+    catch {
+        return;
+    }
+    return { url: file.url, name: file.name, size: file.size,
+        ...(typeof file.mimeType === "string" && file.mimeType.length <= 255 && !/[\r\n]/.test(file.mimeType) ? { mimeType: file.mimeType } : {}),
+        ...(typeof file.expiresAt === "number" && Number.isSafeInteger(file.expiresAt) && file.expiresAt > 0 ? { expiresAt: file.expiresAt } : {}), };
+}

package/lib/messageView.js

@@ -1,3 +1,4 @@
+import { parseChatFile } from "./fileMetadata.js";
 const object = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : {};
 const text = (value) => typeof value === "string" ? value : "";
 function media(value) {
@@ -30,6 +31,7 @@ function content(message) {
     const legacy = object(message.legacyDisplay);
     const validLegacy = legacy.id === message.id && legacy.threadId === message.threadId && legacy.orgId === message.teamId && legacy.from === message.from && typeof legacy.content === "string";
     const hint = validLegacy ? legacy : {};
+    const file = parseChatFile(payload.file === undefined ? hint.file : payload.file);
     const contentKind = envelope.contentKind, voice = object(payload.voice);
     const voiceHint = hint.kind === "voice";
     const voiceUrl = media(voice.url) ?? (voiceHint ? media(hint.audioUrl) : undefined) ?? "";
@@ -51,6 +53,10 @@ function content(message) {
         result.kind = "system";
         result.system = { type: body.action === "groupCreate" ? "group-created" : "group-updated", title: text(object(body.payload).title) || undefined };
     }
+    else if (file) {
+        result.kind = "attachment";
+        result.file = file;
+    }
     else if (hasVoice) {
         result.kind = "voice";
         result.voice = { url: voiceUrl, durationMs, ...(text(voice.transcript) || text(hint.transcript) ? { transcript: text(voice.transcript) || text(hint.transcript) } : {}) };

package/lib/runtime/outgoingContent.d.ts

@@ -1,3 +1,4 @@
+import { type ChatFile } from "../fileMetadata.js";
 import type { ChatMention } from "../mentions/model.js";
 import type { MessageScope } from "./messageStore.js";
 import type { SendMessageInput } from "./durableSender.js";
@@ -19,6 +20,9 @@ type ContentChoices = {
         mentions?: ChatMention[];
         quote?: MessageQuote;
     };
+    file: {
+        file: ChatFile;
+    };
     image: {
         image: {
             url: string;

package/lib/runtime/outgoingContent.js

@@ -1,5 +1,6 @@
+import { parseChatFile } from "../fileMetadata.js";
 import { dmThreadId, groupThreadId } from "./thread.js";
-const contentKeys = ["text", "image", "voice", "recall", "reaction", "invitation", "groupCreate", "groupUpdate"];
+const contentKeys = ["text", "file", "image", "voice", "recall", "reaction", "invitation", "groupCreate", "groupUpdate"];
 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))
@@ -80,6 +81,12 @@ export function outgoingContent(scope, thread, input) {
         // The durable sender assigns the revision in the acceptance transaction.
         return { to: thread.targetId, ...(recipients ? { recipients } : {}), body: { kind: "message", threadKind: thread.kind, contentKind: "text", content: { ...identity, text: "[表情回应]", reaction: { version: 1, messageId: reaction.messageId, emojiId: reaction.emojiId, active: reaction.active, revision: 1 } } } };
     }
+    if (input.file) {
+        const file = parseChatFile(input.file);
+        if (!file)
+            throw new Error("INVALID_MESSAGE_FILE");
+        return { to: thread.targetId, ...(recipients ? { recipients } : {}), body: { kind: "message", threadKind: thread.kind, contentKind: "text", content: { ...base, text: `[文件] ${file.name}\n${file.url}`, file } } };
+    }
     let content, contentKind = "text", voiceBlob;
     if ("text" in input) {
         if (typeof input.text !== "string")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pmate/chat-sdk",
-  "version": "0.12.0-next.69",
+  "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",