@kotori-bot/core 1.7.1 → 1.7.2

package/lib/decorators/utils.d.ts

@@ -0,0 +1,60 @@
+import 'reflect-metadata';
+import { type EventsList, type ModuleConfig } from 'fluoro';
+import { type Constructor, Parser } from 'tsukiko';
+import type { Context } from '../app';
+import { Symbols } from '../global';
+import type { CommandConfig } from '../types';
+import type { KotoriPlugin } from './plugin';
+declare module '../types/events' {
+    interface EventsMapping {
+        literal_ready_module_decorator(name: string, config: ModuleConfig): void;
+    }
+}
+interface EventOption {
+    type: keyof EventsList;
+    isOnce?: boolean;
+}
+interface CommandOption extends Omit<CommandConfig, 'action'> {
+    template: string;
+    options?: [string, string][];
+}
+interface MidwareOption {
+    priority?: number;
+}
+interface RegexpOption {
+    match: RegExp;
+}
+type TaskOption = Exclude<Parameters<Context['task']>[0], string>;
+type Fn = (...args: any[]) => any;
+interface PluginMetaAll {
+    name: string;
+    lang?: string;
+    inject: string[];
+    schema?: Parser<object>;
+    events: [Fn, EventOption, boolean][];
+    midwares: [Fn, MidwareOption, boolean][];
+    commands: [Fn, CommandOption, boolean][];
+    regexps: [Fn, RegexpOption, boolean][];
+    tasks: [Fn, TaskOption, boolean][];
+}
+type KotoriPluginChild = new (...args: ConstructorParameters<typeof KotoriPlugin>) => KotoriPlugin;
+export declare class Decorators {
+    static [Symbols.decorator]: Map<string, KotoriPluginChild>;
+    static getMeta(target: object | string): PluginMetaAll | undefined;
+    static setup(ctx: Context): void;
+    static load(ctx: Context, target: string | Constructor, config: ModuleConfig): boolean;
+    private readonly pkgName;
+    private error;
+    private getMeta;
+    constructor(pkgName: string);
+    readonly import: (target: object) => void;
+    readonly lang: <T extends object>(target: T, name: keyof T) => void;
+    readonly inject: <T extends object>(target: T, name: keyof T) => void;
+    readonly schema: <T extends object>(target: T, name: keyof T) => void;
+    on(options: EventOption): <T extends object>(target: T, key: keyof T) => void;
+    midware(options?: MidwareOption): <T extends object>(target: T, key: keyof T) => void;
+    command(options: CommandOption): <T extends object>(target: T, key: keyof T) => void;
+    regexp(options: RegexpOption): <T extends object>(target: T, key: keyof T) => void;
+    task(options: TaskOption): <T extends object>(target: T, key: keyof T) => void;
+}
+export default Decorators;

package/lib/decorators/utils.js

@@ -1,11 +1,11 @@
 /**
 * @Package @kotori-bot/core
-* @Version 1.7.1
+* @Version 1.7.2
 * @Author Arimura Sena <me@hotaru.icu>
 * @Copyright 2024-2025 Hotaru. All rights reserved.
 * @License GPL-3.0
 * @Link https://github.com/kotorijs/kotori
-* @Date 2026/2/14 00:45:33
+* @Date 2026/2/14 15:50:13
 */
 "use strict";
 var __create = Object.create;
@@ -42,12 +42,12 @@ __export(utils_exports, {
 });
 module.exports = __toCommonJS(utils_exports);
 var import_reflect_metadata = require("reflect-metadata");
+var import_node_path = require("node:path");
+var import_fast_safe_stringify = __toESM(require("fast-safe-stringify"));
 var import_fluoro = require("fluoro");
 var import_tsukiko = __toESM(require("tsukiko"));
-var import_error = require("../utils/error");
 var import_global = require("../global");
-var import_node_path = require("node:path");
-var import_fast_safe_stringify = __toESM(require("fast-safe-stringify"));
+var import_error = require("../utils/error");
 class Decorators {
   static [import_global.Symbols.decorator] = /* @__PURE__ */ new Map();
   static getMeta(target) {

package/lib/global/constants.d.ts

@@ -0,0 +1,8 @@
+export declare const DEFAULT_CORE_CONFIG: {
+    global: {
+        lang: any;
+        commandPrefix: string;
+    };
+    adapter: {};
+    plugin: {};
+};

package/lib/global/constants.js

@@ -1,11 +1,11 @@
 /**
 * @Package @kotori-bot/core
-* @Version 1.7.1
+* @Version 1.7.2
 * @Author Arimura Sena <me@hotaru.icu>
 * @Copyright 2024-2025 Hotaru. All rights reserved.
 * @License GPL-3.0
 * @Link https://github.com/kotorijs/kotori
-* @Date 2026/2/14 00:45:33
+* @Date 2026/2/14 15:50:13
 */
 "use strict";
 var __defProp = Object.defineProperty;

package/lib/global/index.d.ts

@@ -0,0 +1,2 @@
+export * from './constants';
+export * from './symbols';

package/lib/global/index.js

@@ -1,11 +1,11 @@
 /**
 * @Package @kotori-bot/core
-* @Version 1.7.1
+* @Version 1.7.2
 * @Author Arimura Sena <me@hotaru.icu>
 * @Copyright 2024-2025 Hotaru. All rights reserved.
 * @License GPL-3.0
 * @Link https://github.com/kotorijs/kotori
-* @Date 2026/2/14 00:45:33
+* @Date 2026/2/14 15:50:13
 */
 "use strict";
 var __defProp = Object.defineProperty;

package/lib/global/symbols.d.ts

@@ -0,0 +1,15 @@
+export declare namespace Symbols {
+    const adapter: unique symbol;
+    const bot: unique symbol;
+    const midware: unique symbol;
+    const command: unique symbol;
+    const regexp: unique symbol;
+    const task: unique symbol;
+    const filter: unique symbol;
+    const promise: unique symbol;
+    const decorator: unique symbol;
+    const modules: unique symbol;
+    const getInstance: unique symbol;
+    const setInstance: unique symbol;
+}
+export default Symbols;

package/lib/global/symbols.js

@@ -1,11 +1,11 @@
 /**
 * @Package @kotori-bot/core
-* @Version 1.7.1
+* @Version 1.7.2
 * @Author Arimura Sena <me@hotaru.icu>
 * @Copyright 2024-2025 Hotaru. All rights reserved.
 * @License GPL-3.0
 * @Link https://github.com/kotorijs/kotori
-* @Date 2026/2/14 00:45:33
+* @Date 2026/2/14 15:50:13
 */
 "use strict";
 var __defProp = Object.defineProperty;

package/lib/index.d.ts

@@ -0,0 +1,13 @@
+import 'reflect-metadata';
+export * from '@kotori-bot/i18n';
+export * from '@kotori-bot/tools';
+export * from 'tsukiko';
+export * from './app';
+export * from './components';
+export * from './decorators';
+export * from './global';
+export * from './types';
+export * from './utils/container';
+export * from './utils/error';
+export * from './utils/factory';
+export * from './utils/jsx';

package/lib/index.js

@@ -1,11 +1,11 @@
 /**
 * @Package @kotori-bot/core
-* @Version 1.7.1
+* @Version 1.7.2
 * @Author Arimura Sena <me@hotaru.icu>
 * @Copyright 2024-2025 Hotaru. All rights reserved.
 * @License GPL-3.0
 * @Link https://github.com/kotorijs/kotori
-* @Date 2026/2/14 00:45:33
+* @Date 2026/2/14 15:50:13
 */
 "use strict";
 var __defProp = Object.defineProperty;
@@ -25,30 +25,30 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 module.exports = __toCommonJS(index_exports);
 var import_reflect_metadata = require("reflect-metadata");
+__reExport(index_exports, require("@kotori-bot/i18n"), module.exports);
+__reExport(index_exports, require("@kotori-bot/tools"), module.exports);
+__reExport(index_exports, require("tsukiko"), module.exports);
 __reExport(index_exports, require("./app"), module.exports);
 __reExport(index_exports, require("./components"), module.exports);
 __reExport(index_exports, require("./decorators"), module.exports);
-__reExport(index_exports, require("./utils/jsx"), module.exports);
-__reExport(index_exports, require("./utils/error"), module.exports);
-__reExport(index_exports, require("./utils/factory"), module.exports);
-__reExport(index_exports, require("./utils/container"), module.exports);
 __reExport(index_exports, require("./global"), module.exports);
 __reExport(index_exports, require("./types"), module.exports);
-__reExport(index_exports, require("@kotori-bot/tools"), module.exports);
-__reExport(index_exports, require("@kotori-bot/i18n"), module.exports);
-__reExport(index_exports, require("tsukiko"), module.exports);
+__reExport(index_exports, require("./utils/container"), module.exports);
+__reExport(index_exports, require("./utils/error"), module.exports);
+__reExport(index_exports, require("./utils/factory"), module.exports);
+__reExport(index_exports, require("./utils/jsx"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  ...require("@kotori-bot/i18n"),
+  ...require("@kotori-bot/tools"),
+  ...require("tsukiko"),
   ...require("./app"),
   ...require("./components"),
   ...require("./decorators"),
-  ...require("./utils/jsx"),
-  ...require("./utils/error"),
-  ...require("./utils/factory"),
-  ...require("./utils/container"),
   ...require("./global"),
   ...require("./types"),
-  ...require("@kotori-bot/tools"),
-  ...require("@kotori-bot/i18n"),
-  ...require("tsukiko")
+  ...require("./utils/container"),
+  ...require("./utils/error"),
+  ...require("./utils/factory"),
+  ...require("./utils/jsx")
 });

package/lib/types/adapter.d.ts

@@ -0,0 +1,22 @@
+import type { Context } from '../app';
+import type { Adapter } from '../components';
+import type { AdapterConfig } from './config';
+declare module './events' {
+    interface EventsMapping {
+        connect(data: EventDataConnect): void;
+        status(data: EventDataStatus): void;
+    }
+}
+interface EventDataConnect {
+    adapter: Adapter;
+    type: 'connect' | 'disconnect';
+    normal: boolean;
+    mode: 'ws' | 'ws-reverse' | 'other';
+    address: string;
+}
+interface EventDataStatus {
+    adapter: Adapter;
+    status: Adapter['status']['value'];
+}
+export type AdapterClass = new (ctx: Context, config: AdapterConfig, identity: string) => Adapter;
+export {};

package/lib/types/adapter.js

@@ -1,11 +1,11 @@
 /**
 * @Package @kotori-bot/core
-* @Version 1.7.1
+* @Version 1.7.2
 * @Author Arimura Sena <me@hotaru.icu>
 * @Copyright 2024-2025 Hotaru. All rights reserved.
 * @License GPL-3.0
 * @Link https://github.com/kotorijs/kotori
-* @Date 2026/2/14 00:45:33
+* @Date 2026/2/14 15:50:13
 */
 "use strict";
 var __defProp = Object.defineProperty;

package/lib/types/api.d.ts

@@ -0,0 +1,71 @@
+/** Response for sending message */
+export interface SendMessageResponse {
+    /** Message id */
+    messageId: string;
+    /** Send time (milliseconds timestamp) */
+    time: number;
+}
+/** Response for bot self information */
+export interface SelfInfoResponse {
+    /** User id */
+    userId: string;
+    /** User name or nickname */
+    username: string;
+    /** The display name, or empty string if none */
+    userDisplayname: string;
+}
+/** Response for user information */
+export interface UserInfoResponse extends SelfInfoResponse {
+    /** The remark name set set by current bot account, or empty string if none */
+    userRemark: string;
+}
+/** Response for group information */
+export interface GroupInfoResponse {
+    /** Group id */
+    groupId: string;
+    /** Group name */
+    groupName: string;
+}
+/** Response for guild information */
+export interface GuildInfoResponse {
+    /** Guild id */
+    guildId: string;
+    /** Guild name */
+    guildName: string;
+}
+/** Response for channel information */
+export interface ChannelInfoResponse {
+    /** Channel id */
+    channelId: string;
+    /** Channel name */
+    channelName: string;
+}
+/** Response for file upload */
+export interface UploadFileResponse {
+    /** File id */
+    filedId: string;
+}
+/** Response for file get */
+export interface GetFileResponse {
+    /** File name */
+    name: string;
+    /** File data (origin binary)'s SHA256 checksum, all lowercase, optional  */
+    sha256?: string;
+}
+/** Response for file get url */
+export interface GetFileUrlResponse extends GetFileResponse {
+    /** File url */
+    url: string;
+    /** File download url headers, or empty object if none */
+    headers: Record<string, string>;
+}
+/** Response for file get path */
+export interface GetFilePathResponse extends GetFileResponse {
+    /** File path */
+    path: string;
+}
+/** Response for file get data */
+export interface GetFileDataResponse extends GetFileResponse {
+    /** File data */
+    data: Buffer;
+}

package/lib/types/api.js

@@ -1,11 +1,11 @@
 /**
 * @Package @kotori-bot/core
-* @Version 1.7.1
+* @Version 1.7.2
 * @Author Arimura Sena <me@hotaru.icu>
 * @Copyright 2024-2025 Hotaru. All rights reserved.
 * @License GPL-3.0
 * @Link https://github.com/kotorijs/kotori
-* @Date 2026/2/14 00:45:33
+* @Date 2026/2/14 15:50:13
 */
 "use strict";
 var __defProp = Object.defineProperty;

package/lib/types/command.d.ts

@@ -0,0 +1,78 @@
+import Tsu from 'tsukiko';
+import type { TsuError } from 'tsukiko';
+import type { MessageQuick, MessageScope, UserAccess } from './message';
+import type { SessionMsg, SessionMsgChannel, SessionMsgGroup, SessionMsgPrivate } from '../components';
+export type ArgsOrigin = CommandArgType[];
+export type OptsOrigin = Record<string, CommandArgType>;
+export type CommandAction<Args = ArgsOrigin, Opts = OptsOrigin, Scope = 'all'> = (data: {
+    args: Args;
+    options: Opts;
+}, session: Scope extends MessageScope.PRIVATE ? SessionMsgPrivate : Scope extends MessageScope.GROUP ? SessionMsgGroup : Scope extends MessageScope.CHANNEL ? SessionMsgChannel : SessionMsg) => MessageQuick;
+export type CommandArgType = string | number | boolean;
+export declare const commandArgTypeSignSchema: import("tsukiko").UnionParser<[import("tsukiko").LiteralParser<"string">, import("tsukiko").LiteralParser<"number">, import("tsukiko").LiteralParser<"boolean">]>;
+export type CommandArgTypeSign = Tsu.infer<typeof commandArgTypeSignSchema>;
+/** Command instance config */
+export interface CommandConfig {
+    /** Command alias (need bring command prefix) */
+    alias?: string[];
+    /** Command shortcut (needn't bring command prefix) */
+    shortcut?: string[];
+    /** Command required message scope (session type) */
+    scope?: MessageScope | 'all';
+    /** Command required user access level */
+    access?: UserAccess;
+    /** Command help message (have more details than command description) */
+    help?: string;
+    /** Command action */
+    action?: CommandAction;
+}
+interface CommandParseResult {
+    option_error: {
+        expected: CommandArgTypeSign;
+        reality: CommandArgTypeSign;
+        target: string;
+    };
+    arg_error: {
+        expected: CommandArgTypeSign;
+        reality: CommandArgTypeSign;
+        index: number;
+    };
+    arg_many: {
+        expected: number;
+        reality: number;
+    };
+    arg_few: CommandParseResult['arg_many'];
+    syntax: {
+        index: number;
+        char: string;
+    };
+    unknown: {
+        input: string;
+    };
+}
+export interface CommandResult extends CommandParseResult {
+    error: {
+        error: unknown;
+    };
+    data_error: {
+        target: string | number;
+    };
+    res_error: {
+        error: TsuError;
+    };
+    num_error: null;
+    no_access_manger: null;
+    no_access_admin: null;
+    disable: null;
+    exists: {
+        target: string;
+    };
+    no_exists: CommandResult['exists'];
+}
+type CommandResultNoArgs = 'num_error' | 'no_access_manger' | 'no_access_admin' | 'disable';
+export type CommandResultExtra = {
+    [K in keyof CommandResult]: {
+        type: K;
+    } & (K extends CommandResultNoArgs ? object : CommandResult[K]);
+};
+export {};

package/lib/types/command.js

@@ -1,11 +1,11 @@
 /**
 * @Package @kotori-bot/core
-* @Version 1.7.1
+* @Version 1.7.2
 * @Author Arimura Sena <me@hotaru.icu>
 * @Copyright 2024-2025 Hotaru. All rights reserved.
 * @License GPL-3.0
 * @Link https://github.com/kotorijs/kotori
-* @Date 2026/2/14 00:45:33
+* @Date 2026/2/14 15:50:13
 */
 "use strict";
 var __create = Object.create;

package/lib/types/config.d.ts

@@ -0,0 +1,21 @@
+import type { LocaleType } from '@kotori-bot/i18n';
+import type { ModuleConfig } from 'fluoro';
+export interface CoreConfig {
+    global: GlobalConfig;
+    adapter: {
+        [propName: string]: AdapterConfig;
+    };
+    plugin: {
+        [propName: string]: ModuleConfig;
+    };
+}
+export interface GlobalConfig {
+    lang: LocaleType;
+    commandPrefix: string;
+}
+export interface AdapterConfig {
+    extends: string;
+    master: string;
+    lang: LocaleType;
+    commandPrefix: string;
+}

package/lib/types/config.js

@@ -1,11 +1,11 @@
 /**
 * @Package @kotori-bot/core
-* @Version 1.7.1
+* @Version 1.7.2
 * @Author Arimura Sena <me@hotaru.icu>
 * @Copyright 2024-2025 Hotaru. All rights reserved.
 * @License GPL-3.0
 * @Link https://github.com/kotorijs/kotori
-* @Date 2026/2/14 00:45:33
+* @Date 2026/2/14 15:50:13
 */
 "use strict";
 var __defProp = Object.defineProperty;

package/lib/types/events.d.ts

@@ -0,0 +1,3 @@
+import type { EventsMapping as EventsMappingFluoro } from 'fluoro';
+export interface EventsMapping extends EventsMappingFluoro {
+}

package/lib/types/events.js

@@ -1,11 +1,11 @@
 /**
 * @Package @kotori-bot/core
-* @Version 1.7.1
+* @Version 1.7.2
 * @Author Arimura Sena <me@hotaru.icu>
 * @Copyright 2024-2025 Hotaru. All rights reserved.
 * @License GPL-3.0
 * @Link https://github.com/kotorijs/kotori
-* @Date 2026/2/14 00:45:33
+* @Date 2026/2/14 15:50:13
 */
 "use strict";
 var __defProp = Object.defineProperty;

package/lib/types/filter.d.ts

@@ -0,0 +1,51 @@
+export declare enum FilterTestList {
+    PLATFORM = "platform",
+    USER_ID = "userId",
+    GROUP_ID = "groupId",
+    OPERATOR_ID = "operatorId",
+    MESSAGE_ID = "messageId",
+    SCOPE = "scope",
+    ACCESS = "access",
+    IDENTITY = "identity",
+    LOCALE_TYPE = "localeType",
+    SELF_ID = "selfId"
+}
+export type FilterOption = FilterOptionBase | FilterOptionGroup;
+/** Single filter option  */
+export interface FilterOptionBase {
+    test: FilterTestList;
+    operator: '==' | '!=' | '>' | '<' | '>=' | '<=';
+    value: string | number | boolean;
+}
+/** Group filters option */
+export interface FilterOptionGroup {
+    /** Match type, filters of all passed, filter of any one passed, filters of none passed  */
+    type: 'all_of' | 'any_of' | 'none_of';
+    /** Filters list */
+    filters: FilterOption[];
+}
+export declare const filterOptionBaseSchema: import("tsukiko").ObjectParser<{
+    test: import("tsukiko").CustomParser<FilterTestList>;
+    operator: import("tsukiko").UnionParser<[import("tsukiko").LiteralParser<"==">, import("tsukiko").LiteralParser<"!=">, import("tsukiko").LiteralParser<">">, import("tsukiko").LiteralParser<"<">, import("tsukiko").LiteralParser<">=">, import("tsukiko").LiteralParser<"<=">]>;
+    value: import("tsukiko").UnionParser<[import("tsukiko").StringParser, import("tsukiko").NumberParser, import("tsukiko").BooleanParser]>;
+}>;
+export declare const filterOptionGroupSchema: import("tsukiko").ObjectParser<{
+    type: import("tsukiko").UnionParser<[import("tsukiko").LiteralParser<"all_of">, import("tsukiko").LiteralParser<"any_of">, import("tsukiko").LiteralParser<"none_of">]>;
+    filters: import("tsukiko").ArrayParser<import("tsukiko").ObjectParser<{
+        test: import("tsukiko").CustomParser<FilterTestList>;
+        operator: import("tsukiko").UnionParser<[import("tsukiko").LiteralParser<"==">, import("tsukiko").LiteralParser<"!=">, import("tsukiko").LiteralParser<">">, import("tsukiko").LiteralParser<"<">, import("tsukiko").LiteralParser<">=">, import("tsukiko").LiteralParser<"<=">]>;
+        value: import("tsukiko").UnionParser<[import("tsukiko").StringParser, import("tsukiko").NumberParser, import("tsukiko").BooleanParser]>;
+    }>>;
+}>;
+export declare const filterOptionSchema: import("tsukiko").UnionParser<[import("tsukiko").ObjectParser<{
+    test: import("tsukiko").CustomParser<FilterTestList>;
+    operator: import("tsukiko").UnionParser<[import("tsukiko").LiteralParser<"==">, import("tsukiko").LiteralParser<"!=">, import("tsukiko").LiteralParser<">">, import("tsukiko").LiteralParser<"<">, import("tsukiko").LiteralParser<">=">, import("tsukiko").LiteralParser<"<=">]>;
+    value: import("tsukiko").UnionParser<[import("tsukiko").StringParser, import("tsukiko").NumberParser, import("tsukiko").BooleanParser]>;
+}>, import("tsukiko").ObjectParser<{
+    type: import("tsukiko").UnionParser<[import("tsukiko").LiteralParser<"all_of">, import("tsukiko").LiteralParser<"any_of">, import("tsukiko").LiteralParser<"none_of">]>;
+    filters: import("tsukiko").ArrayParser<import("tsukiko").ObjectParser<{
+        test: import("tsukiko").CustomParser<FilterTestList>;
+        operator: import("tsukiko").UnionParser<[import("tsukiko").LiteralParser<"==">, import("tsukiko").LiteralParser<"!=">, import("tsukiko").LiteralParser<">">, import("tsukiko").LiteralParser<"<">, import("tsukiko").LiteralParser<">=">, import("tsukiko").LiteralParser<"<=">]>;
+        value: import("tsukiko").UnionParser<[import("tsukiko").StringParser, import("tsukiko").NumberParser, import("tsukiko").BooleanParser]>;
+    }>>;
+}>]>;

package/lib/types/filter.js

@@ -1,11 +1,11 @@
 /**
 * @Package @kotori-bot/core
-* @Version 1.7.1
+* @Version 1.7.2
 * @Author Arimura Sena <me@hotaru.icu>
 * @Copyright 2024-2025 Hotaru. All rights reserved.
 * @License GPL-3.0
 * @Link https://github.com/kotorijs/kotori
-* @Date 2026/2/14 00:45:33
+* @Date 2026/2/14 15:50:13
 */
 "use strict";
 var __create = Object.create;

package/lib/types/index.d.ts

@@ -0,0 +1,7 @@
+export * from './config';
+export * from './message';
+export * from './adapter';
+export * from './api';
+export * from './filter';
+export * from './session';
+export * from './command';

package/lib/types/index.js

@@ -1,11 +1,11 @@
 /**
 * @Package @kotori-bot/core
-* @Version 1.7.1
+* @Version 1.7.2
 * @Author Arimura Sena <me@hotaru.icu>
 * @Copyright 2024-2025 Hotaru. All rights reserved.
 * @License GPL-3.0
 * @Link https://github.com/kotorijs/kotori
-* @Date 2026/2/14 00:45:33
+* @Date 2026/2/14 15:50:13
 */
 "use strict";
 var __defProp = Object.defineProperty;