openxiangda 1.0.122 → 1.0.123

package/openxiangda-skills/references/notifications.md

@@ -61,6 +61,27 @@ await sdk.notification.sendByType({
 });
 ```
 
+User-facing in-app message centers should read the platform inbox instead of
+creating app-specific message/log forms:
+
+```ts
+const inbox = await sdk.notification.listInbox({
+  page: 1,
+  limit: 20,
+  readStatus: "unread",
+});
+
+await sdk.notification.markRead(messageId);
+await sdk.notification.markAllRead();
+
+const unread = await sdk.notification.getUnreadCount();
+```
+
+Inbox APIs are app-scoped and only return the current logged-in user's `inapp`
+messages. Use `keyword`, `templateCode`, and `readStatus` for server-side
+filtering. Do not expose `/api/message/history` to normal users; it is an
+administrative send-history surface.
+
 CLI smoke tests:
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openxiangda",
-  "version": "1.0.122",
+  "version": "1.0.123",
   "description": "OpenXiangda CLI, workspace build tools, runtime SDK, and form components.",
   "private": false,
   "bin": {

package/packages/sdk/dist/runtime/index.cjs

@@ -2445,6 +2445,45 @@ var createPageSdk = (context) => {
         ...params,
         appType: resolveAppType(context, params.appType)
       }
+    }),
+    listInbox: (params = {}) => request({
+      path: buildOpenXiangdaAppPath(
+        context,
+        params.appType,
+        "/notifications/inbox"
+      ),
+      method: "get",
+      query: {
+        page: params.page,
+        limit: params.limit,
+        readStatus: params.readStatus,
+        keyword: params.keyword,
+        templateCode: params.templateCode
+      }
+    }),
+    getUnreadCount: (params = {}) => request({
+      path: buildOpenXiangdaAppPath(
+        context,
+        params.appType,
+        "/notifications/inbox/unread-count"
+      ),
+      method: "get"
+    }),
+    markRead: (messageId, params = {}) => request({
+      path: buildOpenXiangdaAppPath(
+        context,
+        params.appType,
+        `/notifications/inbox/${encodePathSegment(messageId)}/read`
+      ),
+      method: "post"
+    }),
+    markAllRead: (params = {}) => request({
+      path: buildOpenXiangdaAppPath(
+        context,
+        params.appType,
+        "/notifications/inbox/read-all"
+      ),
+      method: "post"
     })
   };
   const sdk = {