alemonjs 2.1.0-alpha.13 → 2.1.0-alpha.14

package/lib/app/hook-use-api.d.ts

@@ -29,7 +29,7 @@ declare const useMention: <T extends EventKeys>(event: Events[T]) => {
  * @param event
  * @returns
  */
-declare const useMessage: <T extends EventKeys>(event: Events[T]) => {
+declare const useMessage: <T extends EventKeys>(event: Events[T]) => readonly [{
     send: (val: DataEnums[]) => Promise<Result[]>;
     withdraw: (message_id?: string) => Promise<Result[]>;
     forward: (message_id?: string) => Promise<Result[]>;
@@ -38,29 +38,29 @@ declare const useMessage: <T extends EventKeys>(event: Events[T]) => {
     pinning: (message_id?: string) => Promise<Result[]>;
     horn: (message_id?: string) => Promise<Result[]>;
     reaction: (message_id?: string) => Promise<Result[]>;
-}[];
+}];
 /**
  * 用户处理
  * @deprecated 待支持
  * @param event
  * @returns
  */
-declare const useMenber: <T extends EventKeys>(event: Events[T]) => {
+declare const useMenber: <T extends EventKeys>(event: Events[T]) => readonly [{
     information: (user_id?: string) => Promise<Result>;
     mute: (all?: boolean) => Promise<Result>;
     unmute: (all?: boolean) => Promise<Result>;
     remove: (user_id?: string) => Promise<Result>;
-}[];
+}];
 /**
  * 频道处理
  * @deprecated 待支持
  * @param event
  * @returns
  */
-declare const useChannel: <T extends EventKeys>(event: Events[T]) => {
+declare const useChannel: <T extends EventKeys>(event: Events[T]) => readonly [{
     exit: (channel_id?: string) => Promise<Result>;
     join: (channel_id?: string) => Promise<Result>;
-}[];
+}];
 /**
  * 废弃，请使用 useMessage
  * @deprecated
@@ -73,7 +73,7 @@ declare const useSend: <T extends EventKeys>(event: Events[T]) => (...val: DataE
  * @param event
  * @returns
  */
-declare const useSends: <T extends EventKeys>(event: Events[T]) => ((val: DataEnums[]) => Promise<Result[]>)[];
+declare const useSends: <T extends EventKeys>(event: Events[T]) => readonly [(val: DataEnums[]) => Promise<Result[]>];
 /**
  * 卸载模块
  * @param name

package/lib/app/message-api.d.ts

@@ -3,6 +3,17 @@ import { Result } from '../core/utils.js';
 import { DataEnums } from '../typing/message/index.js';
 import '../global.js';
 
+type BaseMap = {
+    [key: string]: any;
+};
+/**
+ * 创建原生value映射
+ * @param event
+ * @returns
+ */
+declare const createEventValue: <T extends keyof R, R extends BaseMap>(event: {
+    value: R[T];
+}) => R[T] | undefined;
 /**
  * 创建数据格式。
  * @param {...DataEnums[]} data - 要格式化的数据。
@@ -12,17 +23,17 @@ import '../global.js';
 declare const format: OnDataFormatFunc;
 /**
  * 向指定频道发送消息。
- * @param {string} channel_id - 目标频道的 ID。
+ * @param {string} SpaceId - 空间ID，可能是服务器ID、频道ID、群ID、聊天ID，或者是复合ID。总之，是框架给指定空间的唯一标识。也就是说，不能使用ChannelId作为该参数。
  * @param {DataEnums[]} data - 要发送的数据。
- * @throws {Error} - 如果 channel_id 无效或发送失败，抛出错误。
+ * @throws {Error} - 如果 SpaceId 无效或发送失败，抛出错误。
  */
-declare const sendToChannel: (channel_id: string, data: DataEnums[]) => Promise<Result[]>;
+declare const sendToChannel: (SpaceId: string, data: DataEnums[]) => Promise<Result[]>;
 /**
  * 向指定用户发送消息。
- * @param {string} user_id - 目标用户的 ID。
+ * @param {string} OpenID - 开放ID，可能是用户ID、聊天ID，或是复合ID。总之，是框架给指定用户的唯一标识。也就说，不能使用UserId作为该参数。
  * @param {DataEnums[]} data - 要发送的数据。
  * @throws {Error} - 如果 user_id 无效或发送失败，抛出错误。
  */
-declare const sendToUser: (user_id: string, data: DataEnums[]) => Promise<Result[]>;
+declare const sendToUser: (OpenID: string, data: DataEnums[]) => Promise<Result[]>;
 
-export { format, sendToChannel, sendToUser };
+export { createEventValue, format, sendToChannel, sendToUser };

package/lib/app/message-api.js

@@ -1,6 +1,14 @@
 import { ResultCode } from '../core/code.js';
 import { sendAction } from '../cbp/actions.js';
 
+/**
+ * 创建原生value映射
+ * @param event
+ * @returns
+ */
+const createEventValue = (event) => {
+    return event.value;
+};
 /**
  * 创建数据格式。
  * @param {...DataEnums[]} data - 要格式化的数据。
@@ -21,23 +29,23 @@ const format = (...data) => {
 global.format = format;
 /**
  * 向指定频道发送消息。
- * @param {string} channel_id - 目标频道的 ID。
+ * @param {string} SpaceId - 空间ID，可能是服务器ID、频道ID、群ID、聊天ID，或者是复合ID。总之，是框架给指定空间的唯一标识。也就是说，不能使用ChannelId作为该参数。
  * @param {DataEnums[]} data - 要发送的数据。
- * @throws {Error} - 如果 channel_id 无效或发送失败，抛出错误。
+ * @throws {Error} - 如果 SpaceId 无效或发送失败，抛出错误。
  */
-const sendToChannel = async (channel_id, data) => {
-    if (!channel_id || typeof channel_id !== 'string') {
+const sendToChannel = async (SpaceId, data) => {
+    if (!SpaceId || typeof SpaceId !== 'string') {
         logger.error({
             code: ResultCode.FailParams,
-            message: 'Invalid channel_id: channel_id must be a string',
+            message: 'Invalid SpaceId: SpaceId must be a string',
             data: null
         });
-        throw new Error('Invalid channel_id: channel_id must be a string');
+        throw new Error('Invalid SpaceId: SpaceId must be a string');
     }
     return await sendAction({
         action: 'message.send.channel',
         payload: {
-            ChannelId: channel_id,
+            ChannelId: SpaceId,
             params: {
                 format: data
             }
@@ -46,23 +54,23 @@ const sendToChannel = async (channel_id, data) => {
 };
 /**
  * 向指定用户发送消息。
- * @param {string} user_id - 目标用户的 ID。
+ * @param {string} OpenID - 开放ID，可能是用户ID、聊天ID，或是复合ID。总之，是框架给指定用户的唯一标识。也就说，不能使用UserId作为该参数。
  * @param {DataEnums[]} data - 要发送的数据。
  * @throws {Error} - 如果 user_id 无效或发送失败，抛出错误。
  */
-const sendToUser = async (user_id, data) => {
-    if (!user_id || typeof user_id !== 'string') {
+const sendToUser = async (OpenID, data) => {
+    if (!OpenID || typeof OpenID !== 'string') {
         logger.error({
             code: ResultCode.FailParams,
-            message: 'Invalid user_id: user_id must be a string',
+            message: 'Invalid OpenID: OpenID must be a string',
             data: null
         });
-        throw new Error('Invalid user_id: user_id must be a string');
+        throw new Error('Invalid OpenID: OpenID must be a string');
     }
     return await sendAction({
         action: 'message.send.user',
         payload: {
-            UserId: user_id,
+            UserId: OpenID,
             params: {
                 format: data
             }
@@ -70,4 +78,4 @@ const sendToUser = async (user_id, data) => {
     });
 };
 
-export { format, sendToChannel, sendToUser };
+export { createEventValue, format, sendToChannel, sendToUser };

package/lib/index.d.ts

@@ -28,7 +28,7 @@ export { createSelects, onSelects, unChildren, useChannel, useClient, useMenber,
 export { onState, unState, useState } from './app/hook-use-state.js';
 export { useSubscribe } from './app/hook-use-subscribe.js';
 export { loadChildren, loadChildrenFile } from './app/load.js';
-export { format, sendToChannel, sendToUser } from './app/message-api.js';
+export { createEventValue, format, sendToChannel, sendToUser } from './app/message-api.js';
 export { Ark, BT, Image, ImageFile, ImageURL, Link, MD, Mention, Text } from './app/message-format.js';
 export { ChildrenApp, Core, Logger, Middleware, ProcessorEventAutoClearMap, ProcessorEventUserAudoClearMap, Response, State, StateSubscribe, SubscribeList } from './app/store.js';
 export { Result, createEventName, createHash, createResult, getInputExportPath, getRecursiveDirFiles, showErrorModule, stringToNumber, useUserHashKey } from './core/utils.js';

package/lib/index.js

@@ -10,7 +10,7 @@ export { createSelects, onSelects, unChildren, useChannel, useClient, useMenber,
 export { onState, unState, useState } from './app/hook-use-state.js';
 export { useSubscribe } from './app/hook-use-subscribe.js';
 export { loadChildren, loadChildrenFile } from './app/load.js';
-export { format, sendToChannel, sendToUser } from './app/message-api.js';
+export { createEventValue, format, sendToChannel, sendToUser } from './app/message-api.js';
 export { Ark, BT, Image, ImageFile, ImageURL, Link, MD, Mention, Text } from './app/message-format.js';
 export { ChildrenApp, Core, Logger, Middleware, ProcessorEventAutoClearMap, ProcessorEventUserAudoClearMap, Response, State, StateSubscribe, SubscribeList } from './app/store.js';
 export { createEventName, createHash, createResult, getInputExportPath, getRecursiveDirFiles, showErrorModule, stringToNumber, useUserHashKey } from './core/utils.js';

package/lib/typing/event/base/guild.d.ts

@@ -3,6 +3,10 @@ type Guild = {
      * 频道Id
      */
     GuildId: string;
+    /**
+     * 空间Id
+     */
+    SpaceId: string;
 };
 type Channel = {
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "alemonjs",
-  "version": "2.1.0-alpha.13",
+  "version": "2.1.0-alpha.14",
   "description": "bot script",
   "author": "lemonade",
   "license": "MIT",