@rei-standard/amsg-server 2.4.0-next.0 → 2.4.0

package/README.md

@@ -9,7 +9,7 @@
 - 业务端点统一使用 `Authorization: Bearer <tenantToken>`
 - `send-notifications` 支持 `cronToken`（Header 或 query token）
 
-2.2+ 的字段增量（`messages` 数组、`splitPattern`、`avatarUrl` 严格校验）在规范的 [§6.1](https://github.com/Tosd0/ReiStandard/blob/main/standards/active-messaging-api.md#61-ai-消息字段约束) / [§6.2](https://github.com/Tosd0/ReiStandard/blob/main/standards/active-messaging-api.md#62-avatarurl-严格校验)；行为已对齐 `amsg-instant`，向后兼容。
+2.2+ 的字段增量（`messages` 数组、`splitPattern`、`avatarUrl` 软清空策略）在规范的 [§6.1](https://github.com/Tosd0/ReiStandard/blob/main/standards/active-messaging-api.md#61-ai-消息字段约束) / [§6.2](https://github.com/Tosd0/ReiStandard/blob/main/standards/active-messaging-api.md#62-avatarurl-软清空策略)。其中 `splitPattern` 是 server 调度任务的持久化配置；`amsg-instant` 0.8.0 起改为 hook 内自定义 split 函数 + `pushPayloads`。
 
 ## 安装
 
@@ -78,7 +78,7 @@ AI 配置消息的提示词可以用两种形态之一，**互斥二选一**：
 
 可选 `temperature?: number` 透传给 LLM：`completePrompt` 路径未传时默认 0.8（保持旧行为）；`messages` 路径未传时**不发**，让上游主路径自己决定。
 
-## 自定义分句正则 `splitPattern`（2.3.0+）
+## 自定义分句正则 `splitPattern`（server 2.3.0+）
 
 `processSingleMessage` 默认按 `/([。！？!?]+)/` 把 LLM 返回的整段文本切成多条推送（每条间隔 1.5s）。`splitPattern` 让调用方覆盖这个正则：
 

package/dist/index.cjs

@@ -190,7 +190,8 @@ function validateScheduleMessagePayload(payload) {
   }
   const avatarErr = validateAvatarUrl(payload.avatarUrl);
   if (avatarErr) {
-    return { valid: false, errorCode: "INVALID_PARAMETERS", errorMessage: avatarErr, details: { invalidFields: ["avatarUrl"] } };
+    console.warn("[amsg-server] avatarUrl \u4E0D\u5408\u6CD5\uFF0C\u5DF2\u7F6E\u7A7A\uFF1A", avatarErr);
+    payload.avatarUrl = null;
   }
   if (payload.uuid && !isValidUUID(payload.uuid)) {
     return { valid: false, errorCode: "INVALID_PARAMETERS", errorMessage: "\u7F3A\u5C11\u5FC5\u9700\u53C2\u6570\u6216\u53C2\u6570\u683C\u5F0F\u9519\u8BEF", details: { invalidFields: ["uuid (invalid UUID format)"] } };
@@ -1152,7 +1153,8 @@ function createUpdateMessageHandler(ctx) {
     if (Object.prototype.hasOwnProperty.call(updates, "avatarUrl")) {
       const avatarErr = validateAvatarUrl(updates.avatarUrl);
       if (avatarErr) {
-        return { status: 400, body: { success: false, error: { code: "INVALID_UPDATE_DATA", message: avatarErr, details: { invalidFields: ["avatarUrl"] } } } };
+        console.warn("[amsg-server] update-message avatarUrl \u4E0D\u5408\u6CD5\uFF0C\u5DF2\u5FFD\u7565\uFF1A", avatarErr);
+        delete updates.avatarUrl;
       }
     }
     const existingTask = await db.getTaskByUuid(taskUuid, userId);

package/dist/index.d.cts

@@ -316,7 +316,11 @@ function validateScheduleMessagePayload(payload) {
 
   const avatarErr = validateAvatarUrl(payload.avatarUrl);
   if (avatarErr) {
-    return { valid: false, errorCode: 'INVALID_PARAMETERS', errorMessage: avatarErr, details: { invalidFields: ['avatarUrl'] } };
+    // Soft-strip: a bad avatarUrl (data: URI / oversized / malformed) used to
+    // 400 the whole schedule. Avatar is cosmetic — drop the field, log, and
+    // let the rest of the task ship. See standards §6.2.
+    console.warn('[amsg-server] avatarUrl 不合法，已置空：', avatarErr);
+    payload.avatarUrl = null;
   }
   if (payload.uuid && !isValidUUID(payload.uuid)) {
     return { valid: false, errorCode: 'INVALID_PARAMETERS', errorMessage: '缺少必需参数或参数格式错误', details: { invalidFields: ['uuid (invalid UUID format)'] } };
@@ -1778,7 +1782,11 @@ function createUpdateMessageHandler(ctx) {
     if (Object.prototype.hasOwnProperty.call(updates, 'avatarUrl')) {
       const avatarErr = validateAvatarUrl(updates.avatarUrl);
       if (avatarErr) {
-        return { status: 400, body: { success: false, error: { code: 'INVALID_UPDATE_DATA', message: avatarErr, details: { invalidFields: ['avatarUrl'] } } } };
+        // Soft-strip: drop the bad avatarUrl from the patch (keeps the
+        // existing stored avatar untouched) and continue applying the rest
+        // of the update. See standards §6.2.
+        console.warn('[amsg-server] update-message avatarUrl 不合法，已忽略：', avatarErr);
+        delete updates.avatarUrl;
       }
     }
 

package/dist/index.d.ts

@@ -316,7 +316,11 @@ function validateScheduleMessagePayload(payload) {
 
   const avatarErr = validateAvatarUrl(payload.avatarUrl);
   if (avatarErr) {
-    return { valid: false, errorCode: 'INVALID_PARAMETERS', errorMessage: avatarErr, details: { invalidFields: ['avatarUrl'] } };
+    // Soft-strip: a bad avatarUrl (data: URI / oversized / malformed) used to
+    // 400 the whole schedule. Avatar is cosmetic — drop the field, log, and
+    // let the rest of the task ship. See standards §6.2.
+    console.warn('[amsg-server] avatarUrl 不合法，已置空：', avatarErr);
+    payload.avatarUrl = null;
   }
   if (payload.uuid && !isValidUUID(payload.uuid)) {
     return { valid: false, errorCode: 'INVALID_PARAMETERS', errorMessage: '缺少必需参数或参数格式错误', details: { invalidFields: ['uuid (invalid UUID format)'] } };
@@ -1778,7 +1782,11 @@ function createUpdateMessageHandler(ctx) {
     if (Object.prototype.hasOwnProperty.call(updates, 'avatarUrl')) {
       const avatarErr = validateAvatarUrl(updates.avatarUrl);
       if (avatarErr) {
-        return { status: 400, body: { success: false, error: { code: 'INVALID_UPDATE_DATA', message: avatarErr, details: { invalidFields: ['avatarUrl'] } } } };
+        // Soft-strip: drop the bad avatarUrl from the patch (keeps the
+        // existing stored avatar untouched) and continue applying the rest
+        // of the update. See standards §6.2.
+        console.warn('[amsg-server] update-message avatarUrl 不合法，已忽略：', avatarErr);
+        delete updates.avatarUrl;
       }
     }
 

package/dist/index.mjs

@@ -190,7 +190,8 @@ function validateScheduleMessagePayload(payload) {
   }
   const avatarErr = validateAvatarUrl(payload.avatarUrl);
   if (avatarErr) {
-    return { valid: false, errorCode: "INVALID_PARAMETERS", errorMessage: avatarErr, details: { invalidFields: ["avatarUrl"] } };
+    console.warn("[amsg-server] avatarUrl \u4E0D\u5408\u6CD5\uFF0C\u5DF2\u7F6E\u7A7A\uFF1A", avatarErr);
+    payload.avatarUrl = null;
   }
   if (payload.uuid && !isValidUUID(payload.uuid)) {
     return { valid: false, errorCode: "INVALID_PARAMETERS", errorMessage: "\u7F3A\u5C11\u5FC5\u9700\u53C2\u6570\u6216\u53C2\u6570\u683C\u5F0F\u9519\u8BEF", details: { invalidFields: ["uuid (invalid UUID format)"] } };
@@ -1152,7 +1153,8 @@ function createUpdateMessageHandler(ctx) {
     if (Object.prototype.hasOwnProperty.call(updates, "avatarUrl")) {
       const avatarErr = validateAvatarUrl(updates.avatarUrl);
       if (avatarErr) {
-        return { status: 400, body: { success: false, error: { code: "INVALID_UPDATE_DATA", message: avatarErr, details: { invalidFields: ["avatarUrl"] } } } };
+        console.warn("[amsg-server] update-message avatarUrl \u4E0D\u5408\u6CD5\uFF0C\u5DF2\u5FFD\u7565\uFF1A", avatarErr);
+        delete updates.avatarUrl;
       }
     }
     const existingTask = await db.getTaskByUuid(taskUuid, userId);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rei-standard/amsg-server",
-  "version": "2.4.0-next.0",
+  "version": "2.4.0",
   "description": "ReiStandard Active Messaging server SDK with pluggable database adapters. Three-axis push schema (messageKind / messageType / messageSubtype) from @rei-standard/amsg-shared. Auto-emits ReasoningPush when the LLM response carries reasoning_content.",
   "repository": {
     "type": "git",
@@ -33,7 +33,7 @@
     "node": ">=20"
   },
   "dependencies": {
-    "@rei-standard/amsg-shared": "0.1.0-next.0",
+    "@rei-standard/amsg-shared": "0.1.0",
     "web-push": "^3.6.7",
     "@netlify/blobs": "^8.1.0"
   },