alemonjs 2.1.82 → 2.1.83-alpha.1

package/lib/cbp/typings.d.ts

@@ -12,6 +12,145 @@ export type ParsedMessage = {
     payload?: any;
     [key: string]: any;
 };
+export type CBPProtocolRole = 'platform' | 'app-client' | 'server';
+export type CBPMessageType = 'event' | 'action.req' | 'action.res' | 'api.req' | 'api.res' | 'control';
+export type CBPEndpoint = {
+    role: CBPProtocolRole;
+    deviceId?: string;
+    appName?: string;
+    platform?: string;
+};
+export type CBPError = {
+    code: string;
+    message: string;
+    retryable?: boolean;
+    details?: unknown;
+};
+export type CBPResult = {
+    code: number;
+    message: string;
+    data?: unknown;
+};
+export type CBPCapability = 'event' | 'action' | 'api' | 'full-receive';
+export type CBPControlPayload = {
+    op: 'hello';
+    capabilities?: CBPCapability[];
+} | {
+    op: 'heartbeat';
+} | {
+    op: 'goodbye';
+    reason?: string;
+} | {
+    op: 'error';
+    code: string;
+    message: string;
+} | {
+    op: 'sync';
+    env?: Record<string, string>;
+};
+export type CBPEventPayload = {
+    name: EventKeys | string;
+    event: Record<string, unknown>;
+    raw?: unknown;
+};
+export type CBPActionRequestPayload = {
+    action: string;
+    input: Record<string, unknown>;
+};
+export type CBPActionResponsePayload = {
+    results: CBPResult[] | Result[];
+};
+export type CBPApiRequestPayload = {
+    api: string;
+    input: Record<string, unknown>;
+};
+export type CBPApiResponsePayload = {
+    results: CBPResult[] | Result[];
+};
+export type CBPEnvelope = {
+    protocol: 'cbp';
+    version: 1;
+    type: CBPMessageType;
+    id: string;
+    replyTo?: string;
+    timestamp: number;
+    source: CBPEndpoint;
+    target?: CBPEndpoint;
+    payload?: CBPEventPayload | CBPActionRequestPayload | CBPActionResponsePayload | CBPApiRequestPayload | CBPApiResponsePayload | CBPControlPayload | unknown;
+    error?: CBPError;
+    meta?: Record<string, unknown>;
+};
+export type NormalizedEventMessage = {
+    kind: 'event';
+    id: string;
+    timestamp: number;
+    deviceId?: string;
+    sourceRole?: CBPProtocolRole;
+    targetRole?: CBPProtocolRole;
+    eventName: EventKeys | string;
+    event: Record<string, unknown>;
+    raw?: unknown;
+    meta?: Record<string, unknown>;
+};
+export type NormalizedActionRequestMessage = {
+    kind: 'action.req';
+    id: string;
+    timestamp: number;
+    deviceId?: string;
+    sourceRole?: CBPProtocolRole;
+    targetRole?: CBPProtocolRole;
+    action: string;
+    input: Record<string, unknown>;
+    meta?: Record<string, unknown>;
+};
+export type NormalizedActionResponseMessage = {
+    kind: 'action.res';
+    id: string;
+    replyTo: string;
+    timestamp: number;
+    deviceId?: string;
+    sourceRole?: CBPProtocolRole;
+    targetRole?: CBPProtocolRole;
+    results: Result[];
+    error?: CBPError;
+    meta?: Record<string, unknown>;
+};
+export type NormalizedApiRequestMessage = {
+    kind: 'api.req';
+    id: string;
+    timestamp: number;
+    deviceId?: string;
+    sourceRole?: CBPProtocolRole;
+    targetRole?: CBPProtocolRole;
+    api: string;
+    input: Record<string, unknown>;
+    meta?: Record<string, unknown>;
+};
+export type NormalizedApiResponseMessage = {
+    kind: 'api.res';
+    id: string;
+    replyTo: string;
+    timestamp: number;
+    deviceId?: string;
+    sourceRole?: CBPProtocolRole;
+    targetRole?: CBPProtocolRole;
+    results: Result[];
+    error?: CBPError;
+    meta?: Record<string, unknown>;
+};
+export type NormalizedControlMessage = {
+    kind: 'control';
+    id: string;
+    timestamp: number;
+    deviceId?: string;
+    sourceRole?: CBPProtocolRole;
+    targetRole?: CBPProtocolRole;
+    op: CBPControlPayload['op'];
+    payload?: Record<string, unknown>;
+    error?: CBPError;
+    meta?: Record<string, unknown>;
+};
+export type NormalizedCBPMessage = NormalizedEventMessage | NormalizedActionRequestMessage | NormalizedActionResponseMessage | NormalizedApiRequestMessage | NormalizedApiResponseMessage | NormalizedControlMessage;
 export type CBPClientOptions = {
     open?: () => void;
     isFullReceive?: boolean;

package/lib/client.js

@@ -34,20 +34,27 @@ import './app/message-api.js';
 import './process/platform.js';
 import './process/module.js';
 import { createServer } from './server/main.js';
+import { dispatchDisposeAllApps } from './app/lifecycle-callbacks.js';
 
 global.__client_loaded = true;
 let runtimeDisposed = false;
-const disposeRuntime = () => {
+const disposeRuntime = async () => {
     if (runtimeDisposed) {
         return;
     }
     runtimeDisposed = true;
+    await dispatchDisposeAllApps();
     const apps = disposeAllRuntimeApps();
     apps.forEach(app => {
         scheduleCancelByApp(app.name);
         unregisterAppDir(app.name);
     });
 };
+const shutdown = async (reason) => {
+    logger.info?.(`[alemonjs][${reason}] 收到信号，正在关闭...`);
+    await disposeRuntime();
+    process.exit(0);
+};
 const mainServer = () => {
     const port = process.env.serverPort;
     if (!port) {
@@ -83,13 +90,11 @@ const mainProcess = () => {
     });
     ['SIGINT', 'SIGTERM', 'SIGQUIT', 'disconnect'].forEach(sig => {
         process?.on?.(sig, () => {
-            logger.info?.(`[alemonjs][${sig}] 收到信号，正在关闭...`);
-            disposeRuntime();
-            setImmediate(() => process.exit(0));
+            void shutdown(sig);
         });
     });
     process?.on?.('exit', code => {
-        disposeRuntime();
+        void disposeRuntime();
         logger.info?.(`[alemonjs][exit] 进程退出，code=${code}`);
     });
     process.on('message', msg => {
@@ -100,8 +105,7 @@ const mainProcess = () => {
                 mainServer();
             }
             else if (data?.type === 'stop') {
-                disposeRuntime();
-                process.exit(0);
+                void shutdown('stop');
             }
         }
         catch { }

package/lib/core/config.d.ts

@@ -1,6 +1,9 @@
 import type { Package } from '../types';
 type ConfigValue = {
     [key: string]: any;
+    apps?: string[] | {
+        [key: string]: boolean;
+    };
     master_key?: {
         [key: string]: boolean;
     } | string[];
@@ -35,9 +38,6 @@ type ConfigValue = {
         repeated_event_time?: number;
         repeated_user_time?: number;
     };
-    apps?: string[] | {
-        [key: string]: boolean;
-    };
 };
 type ConfigListener<T extends ConfigValue = ConfigValue> = (value: T) => void;
 declare class ConfigCore<T extends ConfigValue = ConfigValue> {

package/lib/index.js

@@ -5,7 +5,7 @@ export { createEventName, createHash, createResult, createUserHashKey, fastHash,
 export { cbpClient } from './cbp/connects/client.js';
 export { cbpPlatform } from './cbp/connects/platform.js';
 export { cbpServer } from './cbp/server/main.js';
-export { ChildrenApp, Core, Logger, Middleware, MiddlewareRouter, MiddlewareTree, ProcessorEventAutoClearMap, ProcessorEventUserAutoClearMap, Response, ResponseMiddleware, ResponseRouter, ResponseTree, State, StateSubscribe, SubscribeList, bumpStoreVersion, clearRuntimeAppKoaRouters, core, disposeAllRuntimeApps, disposeRuntimeApp, getRuntimeApp, getRuntimeAppKoaRouters, getSubscribeList, hasRuntimeAppCapability, listRuntimeAppKoaRouters, listRuntimeApps, logger, registerRuntimeApp, setRuntimeAppKoaRouters, toRuntimeAppSnapshot, updateRuntimeAppCapabilities, updateRuntimeAppStatus } from './app/store.js';
+export { ChildrenApp, Core, Logger, Middleware, MiddlewareRouter, MiddlewareTree, ProcessorEventAutoClearMap, ProcessorEventUserAutoClearMap, Response, ResponseMiddleware, ResponseRouter, ResponseTree, State, StateSubscribe, SubscribeList, bumpStoreVersion, clearRuntimeAppKoaRouters, core, disposeAllRuntimeApps, disposeRuntimeApp, getChildrenApp, getRuntimeApp, getRuntimeAppKoaRouters, getSubscribeList, hasRuntimeAppCapability, listChildrenApps, listRuntimeAppKoaRouters, listRuntimeApps, logger, registerRuntimeApp, setRuntimeAppKoaRouters, toRuntimeAppSnapshot, updateRuntimeAppCapabilities, updateRuntimeAppStatus } from './app/store.js';
 export { Expose, clearAllExpose, disposeExpose, registerExpose } from './app/expose.js';
 export { loadModels, run } from './app/load_modules/load.js';
 export { loadChildren, loadChildrenFile } from './app/load_modules/loadChild.js';
@@ -42,7 +42,7 @@ export { useUser } from './app/hook-use/user.js';
 export { useObserver, useSubscribe } from './app/hook-use/subscribe.js';
 export { createEvent, useEvent } from './app/hook-use/event.js';
 export { clearInterval, clearTimeout, listSchedule, pauseSchedule, resumeSchedule, setCron, setInterval, setTimeout } from './app/api/schedule.js';
-export { finishCurrentTrace, getCurrentEvent, getCurrentNext, markEventSendAttempt, markEventSendFailure, markEventSendSuccess, recordEventSendResults, withEventContext, withProcessorTrace } from './app/hook-event-context.js';
+export { finishCurrentTrace, getCurrentAppName, getCurrentEvent, getCurrentNext, getCurrentPhase, markEventSendAttempt, markEventSendFailure, markEventSendSuccess, recordEventSendResults, withEventContext, withProcessorTrace } from './app/hook-event-context.js';
 export { registerAppDir, scheduleCancel, scheduleCancelAll, scheduleCancelByApp, scheduleCron, scheduleInterval, scheduleList, schedulePause, scheduleResume, scheduleTimeout, unregisterAppDir } from './app/schedule-store.js';
 export { createEventValue, createSelects, onSelects, onState, unChildren, unState, useState } from './app/event-utils.js';
 export { MessageDirect, createDataFormat, format, getMessageIntent, sendToChannel, sendToUser } from './app/message-api.js';

package/lib/server/routers/router.js

@@ -10,6 +10,7 @@ import { ResultCode } from '../../core/variable.js';
 import 'yaml';
 import '../../core/utils.js';
 import { listRuntimeApps, getRuntimeApp, toRuntimeAppSnapshot, listRuntimeAppKoaRouters, hasRuntimeAppCapability, getRuntimeAppKoaRouters } from '../../app/store.js';
+import { dispatchHttpError } from '../../app/lifecycle-callbacks.js';
 
 const initRequire = () => { };
 initRequire.resolve = () => '';
@@ -37,7 +38,7 @@ const readWebRootConfig = (packageRoot) => {
 };
 const denyRuntimeAppAccess = (ctx, appName, capability) => {
     const runtimeApp = getRuntimeApp(appName);
-    if (!runtimeApp || !runtimeApp.enabled) {
+    if (!runtimeApp?.enabled) {
         ctx.status = 404;
         ctx.body = {
             code: 404,
@@ -104,14 +105,42 @@ const dispatchRegisteredKoaRouters = async (ctx) => {
         }
         const routers = getRuntimeAppKoaRouters(item.name);
         for (const koaRouter of routers) {
-            const beforeMatched = Array.isArray(ctx.matched) ? ctx.matched.length : 0;
-            await koaRouter.routes()(ctx, async () => { });
-            const afterMatched = Array.isArray(ctx.matched) ? ctx.matched.length : 0;
-            if (afterMatched <= beforeMatched) {
-                continue;
+            try {
+                const matchedContext = ctx;
+                const beforeMatched = Array.isArray(matchedContext.matched) ? matchedContext.matched.length : 0;
+                await koaRouter.routes()(ctx, async () => { });
+                const afterMatched = Array.isArray(matchedContext.matched) ? matchedContext.matched.length : 0;
+                if (afterMatched <= beforeMatched) {
+                    continue;
+                }
+                await koaRouter.allowedMethods()(ctx, async () => { });
+                return true;
+            }
+            catch (error) {
+                const handled = await dispatchHttpError({
+                    ctx,
+                    error,
+                    appName: item.name,
+                    path: ctx.path,
+                    method: ctx.method,
+                    kind: 'koa-router'
+                });
+                if (handled) {
+                    return true;
+                }
+                logger.warn({
+                    code: ResultCode.Fail,
+                    message: `Error request ${ctx.path}:`,
+                    data: error instanceof Error ? error.message : String(error)
+                });
+                ctx.status = 500;
+                ctx.body = {
+                    code: 500,
+                    message: '处理 Koa Router 请求时发生错误。',
+                    error: error instanceof Error ? error.message : String(error)
+                };
+                return true;
             }
-            await koaRouter.allowedMethods()(ctx, async () => { });
-            return true;
         }
     }
     return false;
@@ -239,12 +268,22 @@ router.all('app/{*path}', async (ctx) => {
             await runMiddlewares(middlewares, ctx, handler);
         }
         catch (err) {
-            console.error(`Error handling API request ${ctx.path}`);
+            const handled = await dispatchHttpError({
+                ctx,
+                error: err,
+                appName: 'main',
+                path: ctx.path,
+                method: ctx.method,
+                kind: 'api'
+            });
+            if (handled) {
+                return;
+            }
             ctx.status = 500;
             ctx.body = {
                 code: 500,
                 message: '处理 API 请求时发生错误。',
-                error: err.message
+                error: err instanceof Error ? err.message : String(err)
             };
         }
         return;
@@ -264,11 +303,22 @@ router.all('app/{*path}', async (ctx) => {
         root = readWebRootConfig(packageRoot);
     }
     catch (err) {
+        const handled = await dispatchHttpError({
+            ctx,
+            error: err,
+            appName: 'main',
+            path: ctx.path,
+            method: ctx.method,
+            kind: 'web'
+        });
+        if (handled) {
+            return;
+        }
         ctx.status = 500;
         ctx.body = {
             code: 500,
             message: '加载 package.json 时发生错误。',
-            error: err.message
+            error: err instanceof Error ? err.message : String(err)
         };
         return;
     }
@@ -291,6 +341,17 @@ router.all('app/{*path}', async (ctx) => {
         ctx.status = 200;
     }
     catch (err) {
+        const handled = await dispatchHttpError({
+            ctx,
+            error: err,
+            appName: 'main',
+            path: ctx.path,
+            method: ctx.method,
+            kind: 'web'
+        });
+        if (handled) {
+            return;
+        }
         if (err?.status === 404) {
             ctx.status = 404;
             ctx.body = {
@@ -304,7 +365,7 @@ router.all('app/{*path}', async (ctx) => {
             ctx.body = {
                 code: 500,
                 message: '加载资源时发生服务器错误。',
-                error: err.message
+                error: err instanceof Error ? err.message : String(err)
             };
         }
     }
@@ -370,16 +431,27 @@ router.all('apps/:app/{*path}', async (ctx) => {
             await runMiddlewares(middlewares, ctx, handler);
         }
         catch (err) {
+            const handled = await dispatchHttpError({
+                ctx,
+                error: err,
+                appName,
+                path: ctx.path,
+                method: ctx.method,
+                kind: 'api'
+            });
+            if (handled) {
+                return;
+            }
             logger.warn({
                 code: ResultCode.Fail,
                 message: `Error request ${ctx.path}:`,
-                data: err?.message ?? ''
+                data: err instanceof Error ? err.message : String(err)
             });
             ctx.status = 500;
             ctx.body = {
                 code: 500,
                 message: '处理 API 请求时发生错误。',
-                error: err.message
+                error: err instanceof Error ? err.message : String(err)
             };
         }
         return;
@@ -399,11 +471,22 @@ router.all('apps/:app/{*path}', async (ctx) => {
         root = readWebRootConfig(packageRoot);
     }
     catch (err) {
+        const handled = await dispatchHttpError({
+            ctx,
+            error: err,
+            appName,
+            path: ctx.path,
+            method: ctx.method,
+            kind: 'web'
+        });
+        if (handled) {
+            return;
+        }
         ctx.status = 500;
         ctx.body = {
             code: 500,
             message: '加载 package.json 时发生错误。',
-            error: err.message
+            error: err instanceof Error ? err.message : String(err)
         };
         return;
     }
@@ -426,6 +509,17 @@ router.all('apps/:app/{*path}', async (ctx) => {
         ctx.status = 200;
     }
     catch (err) {
+        const handled = await dispatchHttpError({
+            ctx,
+            error: err,
+            appName,
+            path: ctx.path,
+            method: ctx.method,
+            kind: 'web'
+        });
+        if (handled) {
+            return;
+        }
         if (err?.status === 404) {
             ctx.status = 404;
             ctx.body = {
@@ -438,13 +532,13 @@ router.all('apps/:app/{*path}', async (ctx) => {
             logger.warn({
                 code: ResultCode.Fail,
                 message: `Error request ${ctx.path}:`,
-                data: err?.message ?? ''
+                data: err instanceof Error ? err.message : String(err)
             });
             ctx.status = 500;
             ctx.body = {
                 code: 500,
                 message: `加载子应用 '${appName}' 资源时发生服务器错误。`,
-                error: err.message
+                error: err instanceof Error ? err.message : String(err)
             };
         }
     }

package/lib/types/actions.d.ts

@@ -1,5 +1,20 @@
 import { DataEnums } from './message';
 import { PaginationParams } from './standard';
+export type MessageActionName = 'message.send' | 'message.send.channel' | 'message.send.user' | 'message.delete' | 'message.edit' | 'message.pin' | 'message.unpin' | 'message.forward.user' | 'message.forward.channel' | 'message.get' | 'message.intent';
+export type MentionActionName = 'mention.get';
+export type ReactionActionName = 'reaction.add' | 'reaction.remove' | 'reaction.list';
+export type FileActionName = 'file.send.channel' | 'file.send.user';
+export type MemberActionName = 'member.info' | 'member.list' | 'member.kick' | 'member.ban' | 'member.unban' | 'member.mute' | 'member.admin' | 'member.card' | 'member.title' | 'member.search';
+export type GuildActionName = 'guild.info' | 'guild.list' | 'guild.update' | 'guild.leave' | 'guild.mute';
+export type ChannelActionName = 'channel.info' | 'channel.list' | 'channel.create' | 'channel.update' | 'channel.delete' | 'channel.announce';
+export type RoleActionName = 'role.list' | 'role.create' | 'role.update' | 'role.delete' | 'role.assign' | 'role.remove';
+export type MeActionName = 'me.info' | 'me.guilds' | 'me.threads' | 'me.friends';
+export type RequestActionName = 'request.friend' | 'request.guild';
+export type UserActionName = 'user.info';
+export type MediaActionName = 'media.upload' | 'media.send.channel' | 'media.send.user';
+export type HistoryActionName = 'history.list';
+export type PermissionActionName = 'permission.get' | 'permission.set';
+export type StandardActionName = MessageActionName | MentionActionName | ReactionActionName | FileActionName | MemberActionName | GuildActionName | ChannelActionName | RoleActionName | MeActionName | RequestActionName | UserActionName | MediaActionName | HistoryActionName | PermissionActionName;
 export type ActionMessageSend = {
     action: 'message.send';
     payload: {
@@ -293,6 +308,10 @@ export type ActionMessageGet = {
         MessageId: string;
     };
 };
+export type ActionMessageIntent = {
+    action: 'message.intent';
+    payload: object;
+};
 export type ActionGuildUpdate = {
     action: 'guild.update';
     payload: {
@@ -488,7 +507,7 @@ type base = {
     actionId?: string;
     DeviceId?: string;
 };
-export type Actions = (ActionMessageSend | ActionMessageSendChannel | ActionMessageSendUser | ActionMessageDelete | ActionMessageEdit | ActionMessagePin | ActionMessageUnpin | ActionMentionGet | ActionReactionAdd | ActionReactionRemove | ActionFileSendChannel | ActionFileSendUser | ActionMessageForwardUser | ActionMessageForwardChannel | ActionMemberInfo | ActionMemberList | ActionMemberKick | ActionMemberBan | ActionMemberUnban | ActionGuildInfo | ActionGuildList | ActionChannelInfo | ActionChannelList | ActionChannelCreate | ActionChannelUpdate | ActionChannelDelete | ActionRoleList | ActionRoleCreate | ActionRoleUpdate | ActionRoleDelete | ActionRoleAssign | ActionRoleRemove | ActionMeInfo | ActionMeGuilds | ActionMeThreads | ActionMeFriends | ActionMessageGet | ActionGuildUpdate | ActionGuildLeave | ActionGuildMute | ActionMemberMute | ActionMemberAdmin | ActionMemberCard | ActionMemberTitle | ActionRequestFriend | ActionRequestGuild | ActionUserInfo | ActionMediaUpload | ActionMediaSendChannel | ActionMediaSendUser | ActionHistoryList | ActionPermissionGet | ActionPermissionSet | ActionReactionList | ActionMemberSearch | ActionChannelAnnounce | {
+export type Actions = (ActionMessageSend | ActionMessageSendChannel | ActionMessageSendUser | ActionMessageDelete | ActionMessageEdit | ActionMessagePin | ActionMessageUnpin | ActionMentionGet | ActionReactionAdd | ActionReactionRemove | ActionFileSendChannel | ActionFileSendUser | ActionMessageForwardUser | ActionMessageForwardChannel | ActionMessageIntent | ActionMemberInfo | ActionMemberList | ActionMemberKick | ActionMemberBan | ActionMemberUnban | ActionGuildInfo | ActionGuildList | ActionChannelInfo | ActionChannelList | ActionChannelCreate | ActionChannelUpdate | ActionChannelDelete | ActionRoleList | ActionRoleCreate | ActionRoleUpdate | ActionRoleDelete | ActionRoleAssign | ActionRoleRemove | ActionMeInfo | ActionMeGuilds | ActionMeThreads | ActionMeFriends | ActionMessageGet | ActionGuildUpdate | ActionGuildLeave | ActionGuildMute | ActionMemberMute | ActionMemberAdmin | ActionMemberCard | ActionMemberTitle | ActionRequestFriend | ActionRequestGuild | ActionUserInfo | ActionMediaUpload | ActionMediaSendChannel | ActionMediaSendUser | ActionHistoryList | ActionPermissionGet | ActionPermissionSet | ActionReactionList | ActionMemberSearch | ActionChannelAnnounce | {
     action: string;
     payload: object;
 }) & base;

package/lib/types/apis.d.ts

@@ -1,5 +1,6 @@
+export type StandardApiName = 'client.api';
 export type Apis = {
-    action: string;
+    action: StandardApiName | string;
     payload: {
         event: any;
         key: string;

package/lib/types/cycle/index.d.ts

@@ -1,4 +1,7 @@
 import { StoreMiddlewareItem, StoreResponseItem } from '../store/res';
+import type { Events } from '../event/map';
+import { EventKeys } from '../event/map';
+import type KoaRouter from 'koa-router';
 type StroreParam = {
     response: StoreResponseItem[];
     responseMiddleware: {
@@ -6,10 +9,57 @@ type StroreParam = {
     };
     middleware: StoreMiddlewareItem[];
 };
+export type EventErrorPhase = 'middleware' | 'response' | 'subscribe' | 'route';
+export type EventTraceReason = 'filtered' | 'completed' | 'consumed' | 'error';
+export type RuntimeLifecycleStatus = 'discovered' | 'loading' | 'ready' | 'failed' | 'disposed';
+export type EventStartContext<T extends EventKeys = EventKeys> = {
+    event: Events[T];
+    name: T;
+};
+export type EventFinishedContext<T extends EventKeys = EventKeys> = {
+    event: Events[T];
+    name: T;
+    reason: EventTraceReason;
+    duration: number;
+    hasSendAttempted: boolean;
+    hasSendSucceeded: boolean;
+    lastSendError: string | null;
+};
+export type EventErrorContext<T extends EventKeys = EventKeys> = {
+    event: Events[T];
+    error: unknown;
+    appName: string;
+    phase: EventErrorPhase;
+};
+export type HttpErrorKind = 'api' | 'web' | 'koa-router';
+export type HttpErrorContext = {
+    ctx: KoaRouter.RouterContext;
+    error: unknown;
+    appName: string;
+    path: string;
+    method: string;
+    kind: HttpErrorKind;
+};
+export type RuntimeStatusChangeContext = {
+    appName: string;
+    previousStatus?: RuntimeLifecycleStatus;
+    status: RuntimeLifecycleStatus;
+    error?: {
+        message: string;
+        time: number;
+    };
+};
 export type ChildrenCycle = {
     onCreated?: () => void | Promise<void>;
     onMounted?: (store: StroreParam) => void | Promise<void>;
+    onReady?: (store: StroreParam) => void | Promise<void>;
+    onEventStart?: <T extends EventKeys>(context: EventStartContext<T>) => void | Promise<void>;
+    onEventError?: <T extends EventKeys>(context: EventErrorContext<T>) => void | 'continue' | Promise<void | 'continue'>;
+    onEventFinished?: <T extends EventKeys>(context: EventFinishedContext<T>) => void | Promise<void>;
+    onHttpError?: (context: HttpErrorContext) => void | 'handled' | Promise<void | 'handled'>;
+    onRuntimeStatusChange?: (context: RuntimeStatusChangeContext) => void | Promise<void>;
     unMounted?: (error: any) => void | Promise<void>;
+    onDispose?: (error?: unknown) => void | Promise<void>;
 };
 export type Next = (...cns: boolean[]) => void;
 export type EventCycleEnum = 'create' | 'mount' | 'unmount';

package/lib/types/event/index.d.ts

@@ -35,6 +35,7 @@ export type OnDataFormatFunc = (...data: DataEnums[]) => DataEnums[];
 export type OnGroupItem<C = any, T extends EventKeys = EventKeys> = OnResponseValue<C, T> | OnMiddlewareValue<C, T>;
 export type OnGroupFunc = <C, T extends EventKeys, TFirst extends OnGroupItem<C, T>>(...calls: [TFirst, ...Array<TFirst>]) => TFirst;
 export type ResponseRoute = {
+    appName?: string;
     platform?: string | string[];
     regular?: RegExp;
     prefix?: string;

package/lib/types/subscribe/index.d.ts

@@ -2,6 +2,7 @@ import { SinglyLinkedList } from '../../app/SinglyLinkedList';
 import { EventCycleEnum } from '../cycle';
 import { EventKeys } from '../event/map';
 export type SubscribeValue = {
+    appName?: string;
     choose: EventCycleEnum;
     selects: EventKeys[];
     keys: {

package/package.json

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