@kotori-bot/core 1.7.1 → 1.7.2

package/lib/app/common.d.ts

@@ -0,0 +1,6 @@
+import { type EventsList as FluoroEventsList, Service as FluoroService } from 'fluoro';
+import type { EventsMapping } from '../types/events';
+import type Context from './core';
+export type EventsList = FluoroEventsList<EventsMapping>;
+export type Service<T extends object = object> = FluoroService<T, Context>;
+export declare const Service: new <T extends object = object>(ctx: Context, config: T, identity: string) => Service<T>;

package/lib/app/common.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/app/config.d.ts

@@ -0,0 +1,32 @@
+import type { CoreConfig } from '../types';
+/** Meta information. */
+interface MetaInfo {
+    /** Program name */
+    name: string;
+    /** Program core version */
+    coreVersion: string;
+    /** Program loader version if exists */
+    loaderVersion?: string;
+    /** Program version if exists */
+    version?: string;
+    /** Program description */
+    description: string;
+    /** Program entry file */
+    main: string;
+    /**
+     *  Program license
+     *
+     *  @constant
+     */
+    license: 'GPL-3.0';
+    /** Program author */
+    author: string;
+}
+export declare class Config {
+    readonly config: CoreConfig;
+    readonly meta: MetaInfo;
+    constructor(config?: Omit<Partial<CoreConfig>, 'global'> & {
+        global?: Partial<CoreConfig['global']>;
+    });
+}
+export default Config;

package/lib/app/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/app/core.d.ts

@@ -0,0 +1,139 @@
+import I18n from '@kotori-bot/i18n';
+import { Http } from '@kotori-bot/tools';
+import FluoroContext from 'fluoro';
+import type { Parser } from 'tsukiko';
+import { type Api, Cache } from '../components';
+import { Symbols } from '../global';
+import type { AdapterClass } from '../types';
+import type { EventsMapping } from '../types/events';
+import Config from './config';
+import Message from './message';
+export interface Context {
+    /**
+     * Adapter constructors list.
+     *
+     * @readonly
+     */
+    readonly [Symbols.adapter]: Context[typeof Symbols.adapter];
+    /**
+     * Bot instances list.
+     *
+     * @readonly
+     */
+    readonly [Symbols.bot]: Context[typeof Symbols.bot];
+    /**
+     * Core config.
+     *
+     * @readonly
+     */
+    readonly config: Config['config'];
+    /**
+     * Meta information.
+     *
+     * @readonly
+     */
+    readonly meta: Config['meta'];
+    /**
+     * Registered middlewares list.
+     *
+     * @readonly
+     */
+    readonly [Symbols.midware]: Message[typeof Symbols.midware];
+    /**
+     * Registered commands list.
+     *
+     * @readonly
+     */
+    readonly [Symbols.command]: Message[typeof Symbols.command];
+    /**
+     * Registered regexps list.
+     *
+     * @readonly
+     */
+    readonly [Symbols.regexp]: Message[typeof Symbols.regexp];
+    /**
+     * Registered scheduled tasks list.
+     *
+     * @readonly
+     */
+    readonly [Symbols.task]: Message[typeof Symbols.task];
+    /**
+     * Registered session filters list.
+     *
+     * @readonly
+     */
+    readonly [Symbols.filter]: Message[typeof Symbols.filter];
+    /**
+     * Session promises in progress list.
+     *
+     * @readonly
+     */
+    readonly [Symbols.promise]: Message[typeof Symbols.promise];
+    /**
+     * Register a message handled middleware.
+     *
+     * @param callback - Middleware callback
+     * @param priority - Middleware priority, default is 100
+     * @returns dispose function
+     */
+    midware: Message['midware'];
+    /**
+     * Register a command.
+     *
+     * @param template - Command template
+     * @param config - Command config, optional
+     * @returns Command instance
+     */
+    command: Message['command'];
+    /**
+     * Register a regexp.
+     *
+     * @param match - Regexp to match
+     * @param callback - Regexp callback
+     * @returns dispose function
+     */
+    regexp: Message['regexp'];
+    /**
+     * Register a scheduled task.
+     *
+     * @param options - Task options
+     * @param callback - Task callback
+     * @returns dispose function
+     */
+    task: Message['task'];
+    /**
+     * Register a session filter.
+     *
+     * @param option - Filter option
+     * @returns new context
+     */
+    filter: Message['filter'];
+    /**
+     * Send a notified message to the master of first bot instance at config.
+     *
+     * @experimental
+     */
+    notify: Message['notify'];
+    /**
+     * Send a message to all sessions on all bots.
+     *
+     * @experimental
+     */
+    boardcast: Message['boardcast'];
+    /** Http request methods */
+    http: Http;
+    /** International methods */
+    i18n: I18n;
+    /** Cache service */
+    cache: Cache;
+}
+export declare class Context extends FluoroContext<EventsMapping> implements Context {
+    readonly [Symbols.adapter]: Map<string, [AdapterClass, Parser<unknown>?]>;
+    readonly [Symbols.bot]: Map<string, Set<Api>>;
+    constructor(config?: ConstructorParameters<typeof Config>[0]);
+    start(): void;
+    stop(): void;
+}
+export type Core = Context;
+export declare const Core: typeof Context;
+export default Core;

package/lib/app/core.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,13 +42,13 @@ __export(core_exports, {
   default: () => core_default
 });
 module.exports = __toCommonJS(core_exports);
-var import_tools = require("@kotori-bot/tools");
 var import_i18n = __toESM(require("@kotori-bot/i18n"));
+var import_tools = require("@kotori-bot/tools");
 var import_fluoro = __toESM(require("fluoro"));
-var import_config = __toESM(require("./config"));
-var import_message = __toESM(require("./message"));
 var import_components = require("../components");
 var import_global = require("../global");
+var import_config = __toESM(require("./config"));
+var import_message = __toESM(require("./message"));
 class Context extends import_fluoro.default {
   [import_global.Symbols.adapter] = /* @__PURE__ */ new Map();
   [import_global.Symbols.bot] = /* @__PURE__ */ new Map();

package/lib/app/index.d.ts

@@ -0,0 +1,3 @@
+export { Service, EventsList } from './common';
+export * from 'fluoro';
+export { Context, Core } from './core';

package/lib/app/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/app/message.d.ts

@@ -0,0 +1,34 @@
+import { CronJob } from 'cron';
+import { Command, Filter, type SessionMsg } from '../components';
+import { Symbols } from '../global';
+import { type CommandConfig, type FilterOption, type MidwareCallback, type RegexpCallback, type TaskCallback, type TaskOptions } from '../types';
+import type { Context } from './core';
+interface MidwareData {
+    callback: MidwareCallback;
+    priority: number;
+}
+interface RegexpData {
+    match: RegExp;
+    callback: RegexpCallback;
+}
+export declare class Message {
+    readonly [Symbols.midware]: Set<MidwareData>;
+    readonly [Symbols.command]: Set<Command>;
+    readonly [Symbols.regexp]: Set<RegexpData>;
+    readonly [Symbols.task]: Set<CronJob>;
+    readonly [Symbols.filter]: Map<string, Filter>;
+    readonly [Symbols.promise]: Map<string, ((value: SessionMsg['message']) => void)[]>;
+    private handleMidware;
+    private handleRegexp;
+    private handleCommand;
+    private readonly ctx;
+    constructor(ctx: Context);
+    midware(callback: MidwareCallback, priority?: number): () => boolean;
+    command<T extends string>(template: T, config?: CommandConfig): Command<T, {}, "all">;
+    regexp(match: RegExp, callback: RegexpCallback): () => boolean;
+    boardcast(): void;
+    notify(): void;
+    task(options: TaskOptions, callback: TaskCallback): () => boolean;
+    filter(option: FilterOption): any;
+}
+export default Message;

package/lib/app/message.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;
@@ -41,14 +41,14 @@ __export(message_exports, {
   default: () => message_default
 });
 module.exports = __toCommonJS(message_exports);
+var import_node_crypto = require("node:crypto");
 var import_cron = require("cron");
-var import_types = require("../types");
-var import_internal = require("../utils/internal");
 var import_components = require("../components");
-var import_error = require("../utils/error");
-var import_global = require("../global");
-var import_node_crypto = require("node:crypto");
 var import_utils = __toESM(require("../decorators/utils"));
+var import_global = require("../global");
+var import_types = require("../types");
+var import_error = require("../utils/error");
+var import_internal = require("../utils/internal");
 class Message {
   [import_global.Symbols.midware] = /* @__PURE__ */ new Set();
   [import_global.Symbols.command] = /* @__PURE__ */ new Set();

package/lib/components/adapter.d.ts

@@ -0,0 +1,122 @@
+import type Api from './api';
+import type { AdapterConfig, EventDataApiBase } from '../types';
+import type Elements from './elements';
+import { Session } from './session';
+import type { EventsList, Context } from '../app';
+type EventApiType = {
+    [K in keyof EventsList]: EventsList[K] extends EventDataApiBase ? EventsList[K] : never;
+};
+/** Bot Status */
+interface AdapterStatus {
+    /** Online status */
+    value: 'online' | 'offline';
+    /** Bot create time */
+    createTime: Date;
+    /** Bot last sending message time, or empty if haven't received message */
+    lastMsgTime: Date | null;
+    /** Received message count */
+    receivedMsg: number;
+    /** Sent message count */
+    sentMsg: number;
+    /** Offline times */
+    offlineTimes: number;
+}
+/**
+ * Platform adapter.
+ *
+ * @template A - Api instance of bot bind
+ * @template C - Adapter config
+ * @template E - Elements instance of bot bind
+ *
+ * @class
+ * @abstract
+ */
+export interface AdapterImpl<A extends Api = Api, C extends AdapterConfig = AdapterConfig, E extends Elements = Elements> {
+    /**
+     * Context instance.
+     *
+     * @readonly
+     */
+    readonly ctx: Context;
+    /**
+     * Adapter config.
+     *
+     * @readonly
+     */
+    readonly config: C;
+    /**
+     * Adapter support platform.
+     *
+     * @readonly
+     */
+    readonly platform: string;
+    /**
+     * Platform id of bot instanceof itself.
+     *
+     * @readonly
+     */
+    readonly selfId: string;
+    /**
+     * Unique identity of bot.
+     *
+     * @readonly
+     */
+    readonly identity: string;
+    /**
+     * Api instance of bot bind.
+     *
+     * @readonly
+     */
+    readonly api: A;
+    /**
+     * Elements instance of bot bind.
+     *
+     * @readonly
+     */
+    readonly elements: E;
+    /**
+     * Bot status.
+     *
+     * @readonly
+     */
+    readonly status: AdapterStatus;
+    /**
+     * Handle interactive data from platform.
+     *
+     * @param data - Data from platform.
+     */
+    handle(...data: unknown[]): void;
+    /**
+     * Start bot.
+     */
+    start(): void;
+    /**
+     * Stop bot.
+     */
+    stop(): void;
+    /**
+     * Send interactive data to platform.
+     *
+     * @param data - Data to send.
+     */
+    send(...data: unknown[]): void;
+}
+export declare abstract class Adapter<A extends Api = Api, C extends AdapterConfig = AdapterConfig, E extends Elements = Elements> implements AdapterImpl<A, C, E> {
+    constructor(ctx: Context, config: C, identity: string);
+    abstract readonly platform: string;
+    abstract readonly api: A;
+    abstract readonly elements: E;
+    abstract handle(...data: unknown[]): void;
+    abstract start(): void;
+    abstract stop(): void;
+    abstract send(...data: unknown[]): void;
+    protected online(): void;
+    protected offline(): void;
+    protected session<N extends keyof EventApiType>(type: N, data: EventApiType[N] extends Session<infer U> ? U : never): void;
+    readonly ctx: Context;
+    readonly config: C;
+    readonly identity: string;
+    readonly status: AdapterStatus;
+    selfId: string;
+}
+export default Adapter;

package/lib/components/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;