alemonjs 2.1.54 → 2.1.55

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

@@ -1,30 +0,0 @@
-/**
- * 获取指定功能是启动还是关闭
- * ***
- * 当有其他地方调用时，
- * 默认值以第一次调用为准
- * ***
- * 功能名相同时，
- * 将会同时改变，因为状态是全局的
- * @param name 功能名
- * @param defaultValue 默认值，默认为 true
- * @deprecated 废弃。指令管理可直接配置禁用正则
- * @throws {Error} - 如果 name 不是字符串，或者 defaultValue 不是布尔值，抛出错误。
- */
-export declare const useState: <T extends string>(name: T, defaultValue?: boolean) => [boolean, (value: boolean) => void];
-/**
- * 订阅状态变化
- * @param name 功能名
- * @param callback 回调函数
- * @deprecated 废弃。指令管理可直接配置禁用正则
- * @throws {Error} - 如果 callback 无效，抛出错误。
- */
-export declare const onState: <T extends string>(name: T, callback: (value: boolean) => void) => void;
-/**
- * 取消订阅状态变化
- * @param name 功能名
- * @param callback 回调函数
- * @deprecated 废弃。指令管理可直接配置禁用正则
- * @throws {Error} - 如果 callback 无效，抛出错误。
- */
-export declare const unState: <T extends string>(name: T, callback: (value: boolean) => void) => void;

package/lib/app/hook-use/hook-use-state.js

@@ -1,101 +0,0 @@
-import { getConfig } from '../../core/config.js';
-import { ResultCode } from '../../core/variable.js';
-import { State, StateSubscribe } from '../../store/store.js';
-
-/**
- * 获取指定功能是启动还是关闭
- * ***
- * 当有其他地方调用时，
- * 默认值以第一次调用为准
- * ***
- * 功能名相同时，
- * 将会同时改变，因为状态是全局的
- * @param name 功能名
- * @param defaultValue 默认值，默认为 true
- * @deprecated 废弃。指令管理可直接配置禁用正则
- * @throws {Error} - 如果 name 不是字符串，或者 defaultValue 不是布尔值，抛出错误。
- */
-const useState = (name, defaultValue = true) => {
-    // 检查参数
-    if (typeof name !== 'string') {
-        logger.error({
-            code: ResultCode.FailParams,
-            message: 'Invalid name: name must be a string',
-            data: null
-        });
-        throw new Error('Invalid name: name must be a string');
-    }
-    if (typeof defaultValue !== 'boolean') {
-        logger.error({
-            code: ResultCode.FailParams,
-            message: 'Invalid defaultValue: defaultValue must be a boolean',
-            data: null
-        });
-        throw new Error('Invalid defaultValue: defaultValue must be a boolean');
-    }
-    const state = new State(name, defaultValue);
-    // 设置值的函数
-    const setValue = (value) => {
-        if (state.value === value) {
-            return;
-        }
-        state.value = value;
-        // 更新config
-        const cfg = getConfig();
-        cfg.value.core ??= {};
-        cfg.value.core.state ??= [];
-        const cfgState = cfg.value.core.state;
-        const exists = cfgState.includes(name);
-        if (value && exists) {
-            // 启用：从禁用列表中移除
-            cfg.value.core.state = cfg.value.core.state.filter((i) => i !== name);
-        }
-        else if (!value && !exists) {
-            // 禁用：添加到禁用列表
-            cfg.value.core.state.push(name);
-        }
-        cfg.saveValue(cfg.value);
-    };
-    return [state.value, setValue];
-};
-/**
- * 订阅状态变化
- * @param name 功能名
- * @param callback 回调函数
- * @deprecated 废弃。指令管理可直接配置禁用正则
- * @throws {Error} - 如果 callback 无效，抛出错误。
- */
-const onState = (name, callback) => {
-    if (typeof callback !== 'function') {
-        logger.error({
-            code: ResultCode.FailParams,
-            message: 'Callback must be a function',
-            data: null
-        });
-        throw new Error('Callback must be a function');
-    }
-    const sub = new StateSubscribe(name);
-    sub.on(callback);
-};
-/**
- * 取消订阅状态变化
- * @param name 功能名
- * @param callback 回调函数
- * @deprecated 废弃。指令管理可直接配置禁用正则
- * @throws {Error} - 如果 callback 无效，抛出错误。
- */
-const unState = (name, callback) => {
-    if (typeof callback !== 'function') {
-        logger.error({
-            code: ResultCode.FailParams,
-            message: 'Callback must be a function',
-            data: null
-        });
-        throw new Error('Callback must be a function');
-    }
-    // 取消订阅
-    const sub = new StateSubscribe(name);
-    sub.un(callback);
-};
-
-export { onState, unState, useState };

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

@@ -1,46 +0,0 @@
-import { EventCycleEnum, Current, Events, EventKeys } from '../../types';
-/**
- * 订阅事件
- * @param event
- * @param select
- * @returns
- */
-export declare const useSubscribe: <T extends EventKeys>(event: Events[T], selects: T | T[]) => readonly [{
-    create: (callback: Current<T>, keys: (keyof Events[T])[]) => {
-        selects: T[];
-        choose: EventCycleEnum;
-        id: string;
-    };
-    mount: (callback: Current<T>, keys: (keyof Events[T])[]) => {
-        selects: T[];
-        choose: EventCycleEnum;
-        id: string;
-    };
-    unmount: (callback: Current<T>, keys: (keyof Events[T])[]) => {
-        selects: T[];
-        choose: EventCycleEnum;
-        id: string;
-    };
-    cancel: (value: {
-        id: string;
-        selects: T[];
-        choose: EventCycleEnum;
-    }) => void;
-}];
-/**
- * 使用观察者模式订阅事件
- * @param event
- * @param selects
- * @returns
- * 废弃，请使用 useSubscribe
- * @deprecated
- */
-export declare const useObserver: <T extends EventKeys>(event: Events[T], selects: T | T[]) => readonly [(callback: Current<T>, keys: (keyof Events[T])[]) => {
-    selects: T[];
-    choose: EventCycleEnum;
-    id: string;
-}, (value: {
-    id: string;
-    selects: T[];
-    choose: EventCycleEnum;
-}) => void];

package/lib/app/hook-use/hook-use-subscribe.js

@@ -1,143 +0,0 @@
-import { ResultCode } from '../../core/variable.js';
-import { SubscribeList } from '../../store/store.js';
-import { SubscribeStatus } from '../config.js';
-
-/**
- * 订阅事件
- * @param event
- * @param select
- * @returns
- */
-const useSubscribe = (event, selects) => {
-    // 检查参数
-    if (typeof event !== 'object') {
-        logger.error({
-            code: ResultCode.FailParams,
-            message: 'event is not object',
-            data: null
-        });
-        throw new Error('event is not object');
-    }
-    if (typeof selects !== 'string' && !Array.isArray(selects)) {
-        logger.error({
-            code: ResultCode.FailParams,
-            message: 'select is not string or array',
-            data: null
-        });
-        throw new Error('select is not string or array');
-    }
-    /**
-     * 运行订阅
-     * @param callback
-     * @param keys
-     * @param choose
-     * @returns
-     */
-    const register = (callback, keys, choose) => {
-        const curSelects = Array.isArray(selects) ? selects : [selects];
-        // 分配id
-        const ID = Date.now().toString(36) + Math.random().toString(36).substring(2, 15);
-        // 没有选择任何 key，无法绑定订阅
-        if (keys.length === 0) {
-            logger.warn({
-                code: ResultCode.FailParams,
-                message: 'subscribe keys is empty',
-                data: null
-            });
-            return { selects: curSelects, choose, id: ID };
-        }
-        // 创建 订阅 列表
-        for (const select of curSelects) {
-            const subList = new SubscribeList(choose, select);
-            // 只能选择基础数据类型的key
-            const values = {};
-            for (const key of keys) {
-                if (typeof key === 'string' && (typeof event[key] === 'string' || typeof event[key] === 'number' || typeof event[key] === 'boolean')) {
-                    values[key] = event[key];
-                }
-                else {
-                    logger.warn({
-                        code: ResultCode.FailParams,
-                        message: `Invalid key: ${key?.toString()} must be a string, number or boolean`,
-                        data: null
-                    });
-                }
-            }
-            subList.value.append({
-                choose,
-                selects: curSelects,
-                keys: values,
-                current: callback,
-                status: SubscribeStatus.active,
-                id: ID
-            });
-        }
-        return {
-            selects: curSelects,
-            choose,
-            id: ID
-        };
-    };
-    /**
-     * res 创建时 运行订阅
-     * @param callback
-     * @param keys
-     */
-    const create = (callback, keys) => {
-        return register(callback, keys, 'create');
-    };
-    /**
-     * res 挂载时 运行订阅
-     * @param callback
-     * @param keys
-     */
-    const mountBefore = (callback, keys) => {
-        return register(callback, keys, 'mount');
-    };
-    /**
-     * res 卸载时 运行订阅
-     * @param callback
-     * @param keys
-     */
-    const unmount = (callback, keys) => {
-        return register(callback, keys, 'unmount');
-    };
-    /**
-     * 清除订阅
-     * @param id
-     */
-    const cancel = (value) => {
-        const selects = value.selects;
-        const ID = value.id; // 订阅的 ID
-        for (const select of selects) {
-            const subList = new SubscribeList(value.choose, select);
-            subList.value.forEach(node => {
-                if (node.data.id === ID) {
-                    node.data.status = SubscribeStatus.paused; // 标记为已暂停
-                    return true; // break
-                }
-            });
-        }
-    };
-    const subscribe = {
-        create,
-        mount: mountBefore,
-        unmount,
-        cancel
-    };
-    return [subscribe];
-};
-/**
- * 使用观察者模式订阅事件
- * @param event
- * @param selects
- * @returns
- * 废弃，请使用 useSubscribe
- * @deprecated
- */
-const useObserver = (event, selects) => {
-    const [subscribe] = useSubscribe(event, selects);
-    return [subscribe.mount, subscribe.cancel];
-};
-
-export { useObserver, useSubscribe };

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

@@ -1,268 +0,0 @@
-import { DataEnums, EventKeys, Events, User, GuildInfo, ChannelInfo, MemberInfo, RoleInfo, PaginationParams, PaginatedResult } from '../types';
-import { Result } from '../core/utils';
-import { Format } from './message-format';
-type Options = {
-    UserId?: string;
-    UserKey?: string;
-    UserName?: string;
-    IsMaster?: boolean;
-    IsBot?: boolean;
-};
-export declare const useMention: <T extends EventKeys>(event: Events[T]) => [{
-    find: (options?: Options) => Promise<Result<User[]> & {
-        count: number;
-    }>;
-    findOne: (options?: Options) => Promise<Result<User | null> & {
-        count: number;
-    }>;
-}];
-export declare const useMessage: <T extends EventKeys>(event?: Events[T]) => readonly [{
-    send(params?: {
-        format: Format | DataEnums[];
-        replyId?: string;
-    } | DataEnums[]): Promise<Result[]>;
-    delete(params?: {
-        messageId?: string;
-    }): Promise<Result>;
-    edit(params: {
-        format: Format | DataEnums[];
-        messageId?: string;
-    }): Promise<Result>;
-    pin(params?: {
-        messageId?: string;
-    }): Promise<Result>;
-    unpin(params?: {
-        messageId?: string;
-    }): Promise<Result>;
-    get(params?: {
-        messageId?: string;
-    }): Promise<Result>;
-}];
-export declare const useMember: <T extends EventKeys>(event: Events[T]) => readonly [{
-    info: (params: {
-        userId: string;
-        guildId?: string;
-    }) => Promise<Result<MemberInfo | null>>;
-    information: (params: {
-        userId: string;
-    }) => Promise<Result<MemberInfo>>;
-    list: (params?: {
-        guildId?: string;
-        pagination?: PaginationParams;
-    }) => Promise<Result<PaginatedResult<MemberInfo>>>;
-    kick: (params: {
-        userId: string;
-        guildId?: string;
-    }) => Promise<Result>;
-    ban: (params: {
-        userId: string;
-        guildId?: string;
-        reason?: string;
-        duration?: number;
-    }) => Promise<Result>;
-    unban: (params: {
-        userId: string;
-        guildId?: string;
-    }) => Promise<Result>;
-    search: (params: {
-        keyword: string;
-        guildId?: string;
-        limit?: number;
-    }) => Promise<Result>;
-    mute(params: {
-        userId: string;
-        duration: number;
-        guildId?: string;
-    }): Promise<Result>;
-    admin(params: {
-        userId: string;
-        enable: boolean;
-        guildId?: string;
-    }): Promise<Result>;
-    card(params: {
-        userId: string;
-        card: string;
-        guildId?: string;
-    }): Promise<Result>;
-    title(params: {
-        userId: string;
-        title: string;
-        guildId?: string;
-        duration?: number;
-    }): Promise<Result>;
-}];
-export declare const useChannel: <T extends EventKeys>(event: Events[T]) => readonly [{
-    info: (params?: {
-        channelId?: string;
-    }) => Promise<Result<ChannelInfo | null>>;
-    list: (params?: {
-        guildId?: string;
-    }) => Promise<Result<ChannelInfo[]>>;
-    create: (params: {
-        name: string;
-        type?: string;
-        parentId?: string;
-        guildId?: string;
-    }) => Promise<Result<ChannelInfo | null>>;
-    update: (params: {
-        channelId: string;
-        name?: string;
-        topic?: string;
-        position?: number;
-    }) => Promise<Result>;
-    delete: (params: {
-        channelId: string;
-    }) => Promise<Result>;
-}];
-export declare const useSend: <T extends EventKeys>(event?: Events[T]) => (...val: DataEnums[]) => Promise<Result[]>;
-export declare const useSends: <T extends EventKeys>(event?: Events[T]) => readonly [(params?: DataEnums[] | {
-    format: Format | DataEnums[];
-    replyId?: string;
-}) => Promise<Result[]>];
-export declare const unChildren: (name?: string) => void;
-export declare const onSelects: <T extends EventKeys[] | EventKeys>(values: T) => T;
-export declare const createSelects: <T extends EventKeys[] | EventKeys>(values: T) => T;
-export declare const useClient: <T extends object>(event: any, _ApiClass: new (...args: any[]) => T) => readonly [T];
-export declare const useGuild: <T extends EventKeys>(event: Events[T]) => readonly [{
-    info: (params?: {
-        guildId?: string;
-    }) => Promise<Result<GuildInfo | null>>;
-    list: () => Promise<Result<GuildInfo[]>>;
-    update(params: {
-        name?: string;
-        guildId?: string;
-    }): Promise<Result>;
-    leave(params?: {
-        guildId?: string;
-        isDismiss?: boolean;
-    }): Promise<Result>;
-    mute(params: {
-        enable: boolean;
-        guildId?: string;
-    }): Promise<Result>;
-}];
-export declare const useRole: <T extends EventKeys>(event: Events[T]) => readonly [{
-    list: (params?: {
-        guildId?: string;
-    }) => Promise<Result<RoleInfo[]>>;
-    create: (params: {
-        name: string;
-        color?: number;
-        permissions?: string;
-        guildId?: string;
-    }) => Promise<Result<RoleInfo | null>>;
-    update: (params: {
-        roleId: string;
-        name?: string;
-        color?: number;
-        permissions?: string;
-        guildId?: string;
-    }) => Promise<Result>;
-    delete: (params: {
-        roleId: string;
-        guildId?: string;
-    }) => Promise<Result>;
-    assign: (params: {
-        userId: string;
-        roleId: string;
-        guildId?: string;
-    }) => Promise<Result>;
-    remove: (params: {
-        userId: string;
-        roleId: string;
-        guildId?: string;
-    }) => Promise<Result>;
-}];
-export declare const useReaction: <T extends EventKeys>(event: Events[T]) => readonly [{
-    add: (params: {
-        emojiId: string;
-        messageId?: string;
-    }) => Promise<Result>;
-    remove: (params: {
-        emojiId: string;
-        messageId?: string;
-    }) => Promise<Result>;
-    list: (params: {
-        emojiId: string;
-        messageId?: string;
-        limit?: number;
-    }) => Promise<Result>;
-}];
-export declare const useMe: () => readonly [{
-    info: () => Promise<Result<User | null>>;
-    guilds: () => Promise<Result<GuildInfo[]>>;
-    threads: () => Promise<Result<User | null>>;
-    friends: () => Promise<Result<User | null>>;
-}];
-export declare const useRequest: () => readonly [{
-    friend: (params: {
-        flag: string;
-        approve: boolean;
-        remark?: string;
-    }) => Promise<Result>;
-    guild: (params: {
-        flag: string;
-        subType: string;
-        approve: boolean;
-        reason?: string;
-    }) => Promise<Result>;
-}];
-export declare const useUser: () => readonly [{
-    info: (params: {
-        userId: string;
-    }) => Promise<Result<User | null>>;
-}];
-export declare const useMedia: <T extends EventKeys>(event: Events[T]) => readonly [{
-    upload: (params: {
-        type: "image" | "audio" | "video" | "file";
-        url?: string;
-        data?: string;
-        name?: string;
-    }) => Promise<Result>;
-    sendChannel: (params: {
-        type: "image" | "audio" | "video" | "file";
-        url?: string;
-        data?: string;
-        name?: string;
-        channelId?: string;
-    }) => Promise<Result>;
-    sendUser: (params: {
-        userId: string;
-        type: "image" | "audio" | "video" | "file";
-        url?: string;
-        data?: string;
-        name?: string;
-    }) => Promise<Result>;
-}];
-export declare const useHistory: <T extends EventKeys>(event: Events[T]) => readonly [{
-    list: (params?: {
-        channelId?: string;
-        limit?: number;
-        before?: string;
-        after?: string;
-    }) => Promise<Result>;
-}];
-export declare const usePermission: <T extends EventKeys>(event: Events[T]) => readonly [{
-    get: (params: {
-        userId: string;
-        channelId?: string;
-    }) => Promise<Result>;
-    set: (params: {
-        userId: string;
-        allow?: string;
-        deny?: string;
-        channelId?: string;
-    }) => Promise<Result>;
-}];
-export declare const useAnnounce: <T extends EventKeys>(event: Events[T]) => readonly [{
-    set: (params: {
-        messageId: string;
-        channelId?: string;
-        guildId?: string;
-    }) => Promise<Result>;
-    remove: (params?: {
-        messageId?: string;
-        guildId?: string;
-    }) => Promise<Result>;
-}];
-export {};