@zhin.js/adapter-satori 1.1.26 → 1.1.28

package/lib/webhook.js

@@ -8,43 +8,29 @@ const logger = getLogger('satori');
 export function registerSatoriWebhookRoutes(http, handler) {
     const path = handler.config.path;
     return [
-        http.route('POST', path, async (request, response) => {
-            await handleSatoriWebhookRequest(request, response, handler);
-        }, { summary: 'Satori webhook callback', tags: ['satori'] }),
+        http.route('POST', path, (request) => handleSatoriWebhookRequest(request, handler), { summary: 'Satori webhook callback', tags: ['satori'] }),
     ];
 }
-export async function handleSatoriWebhookRequest(request, response, handler) {
+export async function handleSatoriWebhookRequest(request, handler) {
     try {
         if (!verifySatoriToken(handler.config.token, request)) {
-            response.writeHead(403, { 'Content-Type': 'application/json' });
-            response.end(JSON.stringify({ message: 'Unauthorized' }));
-            return;
+            return new Response(JSON.stringify({ message: 'Unauthorized' }), { status: 403, headers: { 'Content-Type': 'application/json' } });
         }
         const opcode = resolveSatoriOpcode(request);
         if (opcode !== SatoriOpcode.EVENT && opcode !== SatoriOpcode.META) {
-            response.writeHead(200, { 'Content-Type': 'application/json' });
-            response.end(JSON.stringify({ message: 'OK' }));
-            return;
-        }
-        if (handler.isOpen) {
-            await handler.acceptHttp(request, response);
-        }
-        else {
-            response.writeHead(200, { 'Content-Type': 'application/json' });
-            response.end(JSON.stringify({ status: 'ok' }));
+            return new Response(JSON.stringify({ message: 'OK' }), { status: 200, headers: { 'Content-Type': 'application/json' } });
         }
+        if (handler.isOpen)
+            return await handler.acceptHttp(request);
+        return new Response(JSON.stringify({ status: 'ok' }), { status: 200, headers: { 'Content-Type': 'application/json' } });
     }
     catch (error) {
         logger.error('Satori webhook error:', error);
-        if (!response.headersSent) {
-            response.writeHead(500, { 'Content-Type': 'application/json' });
-            response.end(JSON.stringify({ message: 'Internal Server Error' }));
-        }
+        return new Response(JSON.stringify({ message: 'Internal Server Error' }), { status: 500, headers: { 'Content-Type': 'application/json' } });
     }
 }
 export function resolveSatoriOpcode(request) {
-    const raw = request.headers['satori-opcode'] ?? request.headers['Satori-Opcode'];
-    const value = Array.isArray(raw) ? raw[0] : raw;
+    const value = request.headers.get('satori-opcode');
     if (value == null || value === '')
         return undefined;
     const parsed = Number.parseInt(String(value), 10);
@@ -53,7 +39,7 @@ export function resolveSatoriOpcode(request) {
 export function verifySatoriToken(token, request) {
     if (!token)
         return true;
-    const auth = request.headers.authorization ?? '';
+    const auth = request.headers.get('authorization') ?? '';
     const expected = Buffer.from(`Bearer ${token}`, 'utf8');
     const actual = Buffer.from(auth, 'utf8');
     return actual.length === expected.length && timingSafeEqual(actual, expected);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-satori",
-  "version": "1.1.26",
+  "version": "1.1.28",
   "description": "Zhin.js Satori adapter for Plugin Runtime (WebSocket client)",
   "type": "module",
   "main": "./lib/index.js",
@@ -19,7 +19,6 @@
     "schema.json",
     "src",
     "lib",
-    "skills",
     "README.md",
     "CHANGELOG.md"
   ],
@@ -34,36 +33,35 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/zhinjs/zhin.git",
+    "url": "git+https://github.com/zhinjs/zhin.git",
     "directory": "plugins/adapters/satori"
   },
   "dependencies": {
     "@imhelper/satori-v1": "1.0.7",
     "imhelper": "1.0.7",
     "ws": "^8.21.1",
-    "@zhin.js/adapter": "1.1.32",
-    "@zhin.js/console-contract": "1.1.5",
-    "@zhin.js/core": "1.1.60",
-    "@zhin.js/feature-kit": "1.1.15",
-    "@zhin.js/host-http": "1.1.17",
-    "@zhin.js/im-contract": "1.1.13",
-    "@zhin.js/logger": "1.1.2",
-    "@zhin.js/page": "1.1.17",
-    "@zhin.js/skill": "1.1.16"
+    "@zhin.js/adapter": "1.1.33",
+    "@zhin.js/console-contract": "1.1.6",
+    "@zhin.js/core": "1.2.0",
+    "@zhin.js/feature-kit": "1.1.16",
+    "@zhin.js/host-http": "1.2.0",
+    "@zhin.js/im-contract": "1.1.14",
+    "@zhin.js/logger": "1.1.3",
+    "@zhin.js/page": "1.1.18"
   },
   "devDependencies": {
     "@types/node": "^26.1.2",
     "@types/ws": "^8.18.1",
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
-    "@zhin.js/host-http": "1.1.17",
-    "zhin.js": "1.1.25"
+    "@zhin.js/host-http": "1.2.0",
+    "zhin.js": "1.1.26"
   },
   "peerDependencies": {
-    "@zhin.js/adapter": "^1.1.32",
-    "@zhin.js/command": "^1.1.17",
-    "@zhin.js/core": "^1.1.60",
-    "zhin.js": "^1.1.25"
+    "@zhin.js/adapter": "^1.1.33",
+    "@zhin.js/command": "^1.2.0",
+    "@zhin.js/core": "^1.2.0",
+    "zhin.js": "^1.1.26"
   },
   "peerDependenciesMeta": {
     "@zhin.js/command": {
@@ -100,10 +98,6 @@
         "package": "@zhin.js/command",
         "api": "^1.0.0"
       },
-      {
-        "package": "@zhin.js/skill",
-        "api": "^1.0.0"
-      },
       {
         "package": "@zhin.js/page",
         "api": "^1.0.0"
@@ -114,6 +108,6 @@
   "scripts": {
     "build": "tsc",
     "clean": "rimraf lib",
-    "test": "NODE_OPTIONS=--experimental-strip-types vitest run --root ../../.. plugins/adapters/satori/tests"
+    "test": "vitest run --root ../../.. plugins/adapters/satori/tests"
   }
 }

package/schema.json

@@ -17,34 +17,6 @@
       "default": 10000,
       "description": "WS PING interval in milliseconds"
     },
-    "master": {
-      "type": [
-        "string",
-        "number"
-      ],
-      "description": "框架 master（platform user id；AI/工具权限、endpoint 管理）。endpoints[i].master 可逐项覆盖",
-      "x-i18n": {
-        "en": {
-          "description": "Framework masters (platform user id; AI/tool permissions and endpoint management). endpoints[i].master can override this value."
-        }
-      }
-    },
-    "trusted": {
-      "type": "array",
-      "items": {
-        "type": [
-          "string",
-          "number"
-        ],
-        "description": "Trusted platform user id"
-      },
-      "description": "框架 trusted 用户列表（弱于 master）。endpoints[i].trusted 可逐项追加",
-      "x-i18n": {
-        "en": {
-          "description": "Framework trusted users, below master authority. endpoints[i].trusted can add users."
-        }
-      }
-    },
     "endpoints": {
       "type": "array",
       "minItems": 1,
@@ -53,34 +25,6 @@
         "type": "object",
         "additionalProperties": false,
         "properties": {
-          "master": {
-            "type": [
-              "string",
-              "number"
-            ],
-            "description": "本 endpoint 的框架 master（platform user id）；覆盖顶层 master",
-            "x-i18n": {
-              "en": {
-                "description": "Framework masters for this endpoint (platform user id), overriding the top-level master list."
-              }
-            }
-          },
-          "trusted": {
-            "type": "array",
-            "items": {
-              "type": [
-                "string",
-                "number"
-              ],
-              "description": "Trusted platform user id"
-            },
-            "description": "本 endpoint 的 trusted 列表",
-            "x-i18n": {
-              "en": {
-                "description": "Trusted users for this endpoint."
-              }
-            }
-          },
           "baseUrl": {
             "type": "string",
             "description": "Satori SDK HTTP/WS base URL (e.g. http://127.0.0.1:5140)"

package/src/endpoint.ts

@@ -7,7 +7,15 @@ import {
   createEndpointSpecification,
   endpointSpec,
   type Endpoint,
+  type EndpointApproveRequest,
+  type EndpointFriend,
+  type EndpointReactionRequest,
+  type EndpointRejectRequest,
+  type EndpointRemoveReactionRequest,
+  type EndpointEventSink,
+  type EndpointIdentity,
   type EndpointSpecification,
+  type EndpointUserRequest,
   createEndpointLifecycle,
   type EndpointChannel,
   type EndpointConnectHandle,
@@ -31,11 +39,20 @@ import {
   formatInboundContent,
   formatMessageId,
   formatSatoriOutbound,
+  inboundSatoriSegments,
   isMessageEvent,
+  mapSatoriFriendRequest,
+  readSatoriFriend,
+  satoriFriendApproveParams,
+  satoriReactionParams,
+  withSatoriGuildRoles,
   isSelfMentioned,
+  mapGuildEmojiNotice,
   parseMessageRef,
   resolveInboundSender,
   satoriInboundConversation,
+  satoriMessageCreateParams,
+  withSatoriReferrer,
   type ResolvedSatoriWebhookConfig,
   type ResolvedSatoriWsConfig,
   type SatoriEventBody,
@@ -74,6 +91,8 @@ export class SatoriWsEndpoint extends SatoriClient implements Endpoint {
   readonly #call: SatoriActionCaller;
   readonly #control: EndpointControl = Object.freeze<EndpointControl>({
     recall: request => this.#recall(request),
+    addReaction: request => this.#addReaction(request),
+    removeReaction: request => this.#removeReaction(request),
   });
 
   constructor(options: SatoriWsEndpointOptions) {
@@ -143,10 +162,7 @@ export class SatoriWsEndpoint extends SatoriClient implements Endpoint {
 
   async #send({ conversation, payload, signal }: EndpointSendRequest): Promise<string> {
     const content = formatSatoriOutbound(payload);
-    const result = await this.#call({ resource: 'message', method: 'create', signal, params: {
-      channel_id: conversation.id,
-      content,
-    } });
+    const result = await this.#call({ resource: 'message', method: 'create', signal, params: satoriMessageCreateParams(conversation.id, content) });
     const msgId = extractCreatedMessageId(result);
     this.#logger.debug(formatCompact({
       op: 'satori_send',
@@ -159,34 +175,33 @@ export class SatoriWsEndpoint extends SatoriClient implements Endpoint {
 
   #admitRaw(body: SatoriEventBody): void {
     if (!matchesSatoriLogin(this.#options.config, body.login)) return;
-    if (!isMessageEvent(body)) return;
-    const conversation = { ...satoriInboundConversation(String(this.#options.id), body), endpoint: this[endpointSpec].identity };
-    const content = formatInboundContent(body);
-    const sender = resolveInboundSender(body);
-    const selfId = this.#options.config.userId;
-    const mentioned = isSelfMentioned(body, selfId);
-    void this[endpointSpec].events.message({
-      event: body,
-      ...(typeof body.timestamp === 'number' ? { platformSentAt: body.timestamp } : {}),
-      conversation,
-      message: { conversation, id: body.message.id },
-      content,
-      sender,
+    if (emitSatoriFriendRequest(body, {
       endpointId: this.#options.config.id,
-      ...(mentioned ? { mentioned: true } : {}),
-      metadata: Object.freeze({
-        type: body.type,
-        channelType: isPrivateChannelType(body) ? 'private' : 'group',
-        sn: body.sn,
+      call: this.#call,
+      emit: request => {
+        void this[endpointSpec].events.emit('request.receive', request).catch(error => {
+          this.#warnPlatformEvent('request.receive', error);
+        });
+      },
+    })) return;
+    const deliver = () => deliverSatoriInbound(body, {
+        endpointId: this.#options.config.id,
+        endpointKey: String(this.#options.id),
+        identity: this[endpointSpec].identity,
+        selfId: this.#options.config.userId,
         platform: this.#options.config.platform,
-      }),
-    }).catch((err) => {
-      this.#logger.warn(formatCompact({
-        op: 'satori_gateway_receive_failed',
-        channel: conversation.id,
-        error: err instanceof Error ? err.message : String(err),
-      }));
+        events: this[endpointSpec].events,
+        warnReceive: (channel, error) => {
+          this.#logger.warn(formatCompact({
+            op: 'satori_gateway_receive_failed',
+            channel,
+            error: error instanceof Error ? error.message : String(error),
+          }));
+        },
+        warnEvent: (event, error) => this.#warnPlatformEvent(event, error),
     });
+    if (body.referrer !== undefined) withSatoriReferrer(body.referrer, deliver);
+    else deliver();
   }
 
   async #recall({ message, signal }: EndpointRecallRequest): Promise<void> {
@@ -197,6 +212,14 @@ export class SatoriWsEndpoint extends SatoriClient implements Endpoint {
     } });
   }
 
+  #addReaction(request: EndpointReactionRequest): Promise<string | null> {
+    return addSatoriReaction(this.#call, request);
+  }
+
+  #removeReaction(request: EndpointRemoveReactionRequest): Promise<void> {
+    return removeSatoriReaction(this.#call, request);
+  }
+
   #warnPlatformEvent(name: string, error: unknown): void {
     this.#logger.warn(formatCompact({
       op: 'satori_platform_event_failed',
@@ -359,6 +382,8 @@ export class SatoriWebhookEndpoint extends SatoriClient implements Endpoint {
   readonly #call: SatoriActionCaller;
   readonly #control: EndpointControl = Object.freeze<EndpointControl>({
     recall: request => this.#recall(request),
+    addReaction: request => this.#addReaction(request),
+    removeReaction: request => this.#removeReaction(request),
   });
 
   constructor(options: SatoriWebhookEndpointOptions) {
@@ -402,11 +427,12 @@ export class SatoriWebhookEndpoint extends SatoriClient implements Endpoint {
     this.#routeReleases.push(...registerSatoriWebhookRoutes(this.#options.http, {
       config: this.#options.config,
       get isOpen() { return isOpen(); },
-      acceptHttp: async (request, response) => {
-        await acceptHttpIngress<SatoriEventBody>(request, response, body => {
+      acceptHttp: async (request) => {
+        const result = await acceptHttpIngress<SatoriEventBody>(request, undefined, body => {
           void this[endpointSpec].events.run(() => this.#receive(body))
             .catch(error => this.#warnPlatformEvent('event', error));
         });
+        return new Response(JSON.stringify(result.body), { status: result.status, headers: result.headers });
       },
     }));
     this.#logger.info(formatCompact({
@@ -428,10 +454,7 @@ export class SatoriWebhookEndpoint extends SatoriClient implements Endpoint {
 
   async #send({ conversation, payload, signal }: EndpointSendRequest): Promise<string> {
     const content = formatSatoriOutbound(payload);
-    const result = await this.#call({ resource: 'message', method: 'create', signal, params: {
-      channel_id: conversation.id,
-      content,
-    } });
+    const result = await this.#call({ resource: 'message', method: 'create', signal, params: satoriMessageCreateParams(conversation.id, content) });
     const msgId = extractCreatedMessageId(result);
     this.#logger.debug(formatCompact({
       op: 'satori_send',
@@ -444,34 +467,33 @@ export class SatoriWebhookEndpoint extends SatoriClient implements Endpoint {
 
   #admitRaw(body: SatoriEventBody): void {
     if (!matchesSatoriLogin(this.#options.config, body.login)) return;
-    if (!isMessageEvent(body)) return;
-    const conversation = { ...satoriInboundConversation(String(this.#options.id), body), endpoint: this[endpointSpec].identity };
-    const content = formatInboundContent(body);
-    const sender = resolveInboundSender(body);
-    const selfId = this.#options.config.userId;
-    const mentioned = isSelfMentioned(body, selfId);
-    void this[endpointSpec].events.message({
-      event: body,
-      ...(typeof body.timestamp === 'number' ? { platformSentAt: body.timestamp } : {}),
-      conversation,
-      message: { conversation, id: body.message.id },
-      content,
-      sender,
+    if (emitSatoriFriendRequest(body, {
       endpointId: this.#options.config.id,
-      ...(mentioned ? { mentioned: true } : {}),
-      metadata: Object.freeze({
-        type: body.type,
-        channelType: isPrivateChannelType(body) ? 'private' : 'group',
-        sn: body.sn,
+      call: this.#call,
+      emit: request => {
+        void this[endpointSpec].events.emit('request.receive', request).catch(error => {
+          this.#warnPlatformEvent('request.receive', error);
+        });
+      },
+    })) return;
+    const deliver = () => deliverSatoriInbound(body, {
+        endpointId: this.#options.config.id,
+        endpointKey: String(this.#options.id),
+        identity: this[endpointSpec].identity,
+        selfId: this.#options.config.userId,
         platform: this.#options.config.platform,
-      }),
-    }).catch((err) => {
-      this.#logger.warn(formatCompact({
-        op: 'satori_gateway_receive_failed',
-        channel: conversation.id,
-        error: err instanceof Error ? err.message : String(err),
-      }));
+        events: this[endpointSpec].events,
+        warnReceive: (channel, error) => {
+          this.#logger.warn(formatCompact({
+            op: 'satori_gateway_receive_failed',
+            channel,
+            error: error instanceof Error ? error.message : String(error),
+          }));
+        },
+        warnEvent: (event, error) => this.#warnPlatformEvent(event, error),
     });
+    if (body.referrer !== undefined) withSatoriReferrer(body.referrer, deliver);
+    else deliver();
   }
 
   async #recall({ message, signal }: EndpointRecallRequest): Promise<void> {
@@ -482,6 +504,14 @@ export class SatoriWebhookEndpoint extends SatoriClient implements Endpoint {
     } });
   }
 
+  #addReaction(request: EndpointReactionRequest): Promise<string | null> {
+    return addSatoriReaction(this.#call, request);
+  }
+
+  #removeReaction(request: EndpointRemoveReactionRequest): Promise<void> {
+    return removeSatoriReaction(this.#call, request);
+  }
+
   #warnPlatformEvent(name: string, error: unknown): void {
     this.#logger.warn(formatCompact({
       op: 'satori_platform_event_failed',
@@ -498,6 +528,47 @@ export class SatoriWebhookEndpoint extends SatoriClient implements Endpoint {
 
 }
 
+function deliverSatoriInbound(body: SatoriEventBody, input: {
+  readonly endpointId: string;
+  readonly endpointKey: string;
+  readonly identity: EndpointIdentity;
+  readonly selfId: string;
+  readonly platform: string;
+  readonly events: EndpointEventSink;
+  readonly warnReceive: (channel: string, error: unknown) => void;
+  readonly warnEvent: (event: string, error: unknown) => void;
+}): Promise<unknown> {
+  const notice = mapGuildEmojiNotice(body, input.endpointId);
+  if (notice) {
+    return input.events.emit('notice.receive', notice).catch(error => input.warnEvent('notice.receive', error));
+  }
+  if (!isMessageEvent(body)) return Promise.resolve();
+  const conversation = { ...satoriInboundConversation(input.endpointKey, body), endpoint: input.identity };
+  const content = formatInboundContent(body);
+  const segments = typeof body.message.content === 'string'
+    ? inboundSatoriSegments(body.message.content)
+    : undefined;
+  const sender = resolveInboundSender(body);
+  const mentioned = isSelfMentioned(body, input.selfId);
+  return input.events.message({
+    event: body,
+    ...(typeof body.timestamp === 'number' ? { platformSentAt: body.timestamp } : {}),
+    conversation,
+    message: { conversation, id: body.message.id },
+    content,
+    ...(segments ? { segments } : {}),
+    sender,
+    endpointId: input.endpointId,
+    ...(mentioned ? { mentioned: true } : {}),
+    metadata: Object.freeze({
+      type: body.type,
+      channelType: isPrivateChannelType(body) ? 'private' : 'group',
+      sn: body.sn,
+      platform: input.platform,
+    }),
+  }).catch(error => input.warnReceive(conversation.id, error));
+}
+
 function isPrivateChannelType(body: SatoriEventBody): boolean {
   const channel = body.channel ?? body.message?.channel;
   return channel?.type === 1;
@@ -545,7 +616,8 @@ function asRecord(value: unknown): Record<string, unknown> {
 
 /**
  * Satori endpoint 的 EndpointManagement 语义端口（ws / webhook 共用），
- * 数据走协议 API：guild.list / channel.list / guild-member.list。
+ * 数据走协议 API：guild.list / channel.list / guild.member.list。
+ * @see https://satori.chat/zh-CN/resources/member.html
  */
 export function createSatoriEndpointManagement(api: SatoriManagementApi): EndpointManagement {
   return Object.freeze<EndpointManagement>({
@@ -583,14 +655,100 @@ export function createSatoriEndpointManagement(api: SatoriManagementApi): Endpoi
       return channels;
     },
     async listGroupMembers({ groupId, signal }: EndpointGroupRequest): Promise<readonly unknown[]> {
-      // 平台形状（GuildMember[]）原样返回
-      return listSatoriPages(api, { resource: 'guild-member', params: { guild_id: groupId }, signal });
+      // 平台形状（GuildMember[]）原样返回，再规范化 1.3 的 GuildRole 角色
+      const members = await listSatoriPages(api, { resource: 'guild.member', params: { guild_id: groupId }, signal });
+      return members.map(member => withSatoriGuildRoles(member));
+    },
+    async listFriends(request: EndpointManagementRequest = {}): Promise<readonly EndpointFriend[]> {
+      const friends: EndpointFriend[] = [];
+      for (const value of await listSatoriPages(api, { resource: 'friend', signal: request.signal })) {
+        const friend = readSatoriFriend(value);
+        if (!friend?.user?.id) continue;
+        const nick = friend.nick ?? '';
+        const name = friend.user.name ?? '';
+        friends.push({
+          user_id: friend.user.id,
+          nickname: name || nick || friend.user.id,
+          remark: nick,
+        });
+      }
+      return friends;
+    },
+    async deleteFriend({ userId, signal }: EndpointUserRequest): Promise<void> {
+      await api({ resource: 'friend', method: 'delete', params: { user_id: userId }, signal });
+    },
+    async approveRequest({ requestId, remark, signal }: EndpointApproveRequest): Promise<void> {
+      await api({
+        resource: 'friend',
+        method: 'approve',
+        signal,
+        params: satoriFriendApproveParams(requestId, true, remark),
+      });
+    },
+    async rejectRequest({ requestId, reason, signal }: EndpointRejectRequest): Promise<void> {
+      await api({
+        resource: 'friend',
+        method: 'approve',
+        signal,
+        params: satoriFriendApproveParams(requestId, false, reason),
+      });
     },
   });
 }
 
 export type { CreateSatoriWebSocket, SatoriWsSocket } from './ws.js';
 
+function emitSatoriFriendRequest(body: SatoriEventBody, input: {
+  readonly endpointId: string;
+  readonly call: SatoriActionCaller;
+  readonly emit: (request: ReturnType<typeof mapSatoriFriendRequest>) => void;
+}): boolean {
+  if (body.type !== 'friend-request') return false;
+  const request = mapSatoriFriendRequest(body, input.endpointId, {
+    approve: (messageId, comment) => input.call({
+      resource: 'friend',
+      method: 'approve',
+      params: satoriFriendApproveParams(messageId, true, comment),
+    }).then(() => undefined),
+    reject: (messageId, reason) => input.call({
+      resource: 'friend',
+      method: 'approve',
+      params: satoriFriendApproveParams(messageId, false, reason),
+    }).then(() => undefined),
+  });
+  if (request) input.emit(request);
+  return true;
+}
+
+async function addSatoriReaction(call: SatoriActionCaller, request: EndpointReactionRequest): Promise<string | null> {
+  const { channelId, messageId } = parseMessageRef(request.message.id);
+  await call({
+    resource: 'reaction',
+    method: 'create',
+    signal: request.signal,
+    params: satoriReactionParams('create', {
+      channelId: channelId || request.message.conversation.id,
+      messageId,
+      emojiId: request.emoji,
+    }),
+  });
+  return request.emoji;
+}
+
+async function removeSatoriReaction(call: SatoriActionCaller, request: EndpointRemoveReactionRequest): Promise<void> {
+  const { channelId, messageId } = parseMessageRef(request.message.id);
+  await call({
+    resource: 'reaction',
+    method: 'delete',
+    signal: request.signal,
+    params: satoriReactionParams('delete', {
+      channelId: channelId || request.message.conversation.id,
+      messageId,
+      emojiId: request.reactionId,
+    }),
+  });
+}
+
 /** A transport connection may multiplex logins; this Endpoint admits only its selected account. */
 function matchesSatoriLogin(config: { readonly platform: string; readonly userId: string }, login: SatoriLogin | undefined): boolean {
   return login?.platform === config.platform && login.user?.id === config.userId;

package/src/index.ts

@@ -3,9 +3,19 @@ export {
   buildWsUrl,
   callSatoriApi,
   extractCreatedMessageId,
+  decodeSatoriContent,
   formatInboundContent,
   formatSatoriOutbound,
+  inboundSatoriSegments,
   isMessageEvent,
+  mapSatoriFriendRequest,
+  normalizeSatoriGuildRoles,
+  readSatoriFriend,
+  satoriFriendApproveParams,
+  satoriReactionParams,
+  mapGuildEmojiNotice,
+  satoriMessageCreateParams,
+  withSatoriReferrer,
   isPrivateChannel,
   resolveInboundSender,
   resolveSatoriConfig,
@@ -16,7 +26,13 @@ export {
   type SatoriApiOptions,
   type SatoriApiRequest,
   type SatoriChannel,
+  type SatoriEmoji,
   type SatoriEventBody,
+  type SatoriFriend,
+  type SatoriFriendRequestActions,
+  type SatoriGuildMember,
+  type SatoriGuildRole,
+  type SatoriReactionMethod,
   type SatoriLogin,
   type SatoriMessage,
   type SatoriSignal,