alemonjs 2.1.79 → 2.1.81

package/lib/app/hook-event-context.js

@@ -96,29 +96,41 @@ const finishCurrentTrace = (reason) => {
 const getTargetEvent = (event) => {
     return event ?? eventStore.getStore()?.event;
 };
+const setSendAttempted = (target) => {
+    target._sendAttempted = true;
+    target._has_send_attempt = true;
+};
+const setSendSucceeded = (target) => {
+    target._sendSucceeded = true;
+    target._has_send_success = true;
+};
+const setLastSendError = (target, error) => {
+    target._lastSendError = error;
+    target._last_send_error = error;
+};
 const markEventSendAttempt = (event) => {
     const target = getTargetEvent(event);
     if (!target) {
         return;
     }
-    target._has_send_attempt = true;
+    setSendAttempted(target);
 };
 const markEventSendSuccess = (event) => {
     const target = getTargetEvent(event);
     if (!target) {
         return;
     }
-    target._has_send_attempt = true;
-    target._has_send_success = true;
-    target._last_send_error = null;
+    setSendAttempted(target);
+    setSendSucceeded(target);
+    setLastSendError(target, null);
 };
 const markEventSendFailure = (error, event) => {
     const target = getTargetEvent(event);
     if (!target) {
         return;
     }
-    target._has_send_attempt = true;
-    target._last_send_error = error instanceof Error ? error.message : typeof error === 'string' ? error : 'Unknown send error';
+    setSendAttempted(target);
+    setLastSendError(target, error instanceof Error ? error.message : typeof error === 'string' ? error : 'Unknown send error');
 };
 const recordEventSendResults = (results, event) => {
     markEventSendAttempt(event);

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

@@ -12,6 +12,7 @@ export * from './permission';
 export * from './reaction';
 export * from './request';
 export * from './role';
+export * from './route';
 export * from './user';
 export * from './subscribe';
 export * from './event';

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

@@ -12,6 +12,7 @@ export { usePermission } from './permission.js';
 export { useReaction } from './reaction.js';
 export { useRequest } from './request.js';
 export { useRole } from './role.js';
+export { useRoute } from './route.js';
 export { useUser } from './user.js';
 export { useObserver, useSubscribe } from './subscribe.js';
 export { createEvent, useEvent } from './event.js';

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

@@ -0,0 +1,32 @@
+import type { EventKeys, Events } from '../../types';
+import type { RouteParams } from '../router/types';
+import type { RouteSchemaValue } from '../router/validator';
+type RouteReader = {
+    param: (name: string) => RouteSchemaValue | undefined;
+    hasParam: (name: string) => boolean;
+};
+export type UseRouteUnmatched = RouteReader & {
+    matched: false;
+    key: undefined;
+    text: undefined;
+    sourceText: undefined;
+    rewrittenText: undefined;
+    rawArgs: [];
+    parsedArgs: [];
+    params: {
+        [key: string]: any;
+    };
+};
+export type UseRouteMatched = RouteReader & {
+    matched: true;
+    key: string;
+    text: string;
+    sourceText?: string;
+    rewrittenText: string;
+    rawArgs: string[];
+    parsedArgs: RouteSchemaValue[];
+    params: RouteParams;
+};
+export type UseRouteResult = UseRouteUnmatched | UseRouteMatched;
+export declare const useRoute: <T extends EventKeys>(event?: Events[T]) => readonly [UseRouteResult];
+export {};

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

@@ -0,0 +1,39 @@
+import { getEventOrThrow } from './common.js';
+
+const createRouteReader = (params) => ({
+    param: (name) => params[name],
+    hasParam: (name) => Object.prototype.hasOwnProperty.call(params, name) && params[name] !== undefined
+});
+const createEmptyRoute = () => ({
+    matched: false,
+    key: undefined,
+    text: undefined,
+    sourceText: undefined,
+    rewrittenText: undefined,
+    rawArgs: [],
+    parsedArgs: [],
+    params: {},
+    ...createRouteReader({})
+});
+const useRoute = (event) => {
+    const currentEvent = getEventOrThrow(event);
+    const route = currentEvent.__route;
+    if (!route) {
+        return [createEmptyRoute()];
+    }
+    return [
+        {
+            matched: true,
+            key: route.key,
+            text: route.text,
+            sourceText: route.sourceText,
+            rewrittenText: route.rewrittenText ?? route.text,
+            rawArgs: [...route.rawArgs],
+            parsedArgs: [...route.parsedArgs],
+            params: { ...route.params },
+            ...createRouteReader(route.params)
+        }
+    ];
+};
+
+export { useRoute };

package/lib/app/index.js

@@ -1,4 +1,4 @@
-export { ChildrenApp, Core, Logger, Middleware, MiddlewareRouter, MiddlewareTree, ProcessorEventAutoClearMap, ProcessorEventUserAutoClearMap, Response, ResponseMiddleware, ResponseRouter, ResponseTree, State, StateSubscribe, SubscribeList, bumpStoreVersion, core, getSubscribeList, logger } from './store.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 './store.js';
 export { Expose, clearAllExpose, disposeExpose, registerExpose } from './expose.js';
 export { loadModels, run } from './load_modules/load.js';
 export { loadChildren, loadChildrenFile } from './load_modules/loadChild.js';
@@ -30,6 +30,7 @@ export { usePermission } from './hook-use/permission.js';
 export { useReaction } from './hook-use/reaction.js';
 export { useRequest } from './hook-use/request.js';
 export { useRole } from './hook-use/role.js';
+export { useRoute } from './hook-use/route.js';
 export { useUser } from './hook-use/user.js';
 export { useObserver, useSubscribe } from './hook-use/subscribe.js';
 export { createEvent, useEvent } from './hook-use/event.js';

package/lib/app/load_modules/load.js

@@ -1,21 +1,36 @@
 import { getConfig } from '../../core/config.js';
 import { loadChildren, loadChildrenFile } from './loadChild.js';
-import { join } from 'path';
+import { join, dirname } from 'path';
 import { existsSync } from 'fs';
 import { ResultCode } from '../../core/variable.js';
+import { registerRuntimeApp } from '../store.js';
 
 const loadApps = () => {
     const cfg = getConfig();
-    const apps = Array.isArray(cfg.value?.apps) ? cfg.value.apps : Object.keys(cfg.value?.apps ?? {}).filter(Boolean);
+    const apps = Array.isArray(cfg.value?.apps)
+        ? cfg.value.apps.filter(Boolean)
+        : Object.entries(cfg.value?.apps ?? {})
+            .filter(([, enabled]) => Boolean(enabled))
+            .map(([name]) => name);
     const uniqueApps = Array.from(new Set(apps));
-    uniqueApps.forEach(app => void loadChildrenFile(app));
+    uniqueApps.forEach(app => {
+        registerRuntimeApp({
+            name: app,
+            kind: 'plugin',
+            enabled: true,
+            status: 'discovered',
+            rootDir: '',
+            mainPath: ''
+        });
+        void loadChildrenFile(app);
+    });
 };
 const run = (input) => {
     if (!input) {
         return;
     }
     const mainPath = join(process.cwd(), input);
-    if (!existsSync(input)) {
+    if (!existsSync(mainPath)) {
         logger.warn({
             code: ResultCode.Warn,
             message: '未找到主要入口文件',
@@ -23,6 +38,14 @@ const run = (input) => {
         });
         return;
     }
+    registerRuntimeApp({
+        name: 'main',
+        kind: 'main',
+        enabled: true,
+        status: 'discovered',
+        rootDir: join(process.cwd(), dirname(input)),
+        mainPath
+    });
     void loadChildren(mainPath, 'main');
 };
 function loadModels() {

package/lib/app/load_modules/loadChild.js

@@ -1,7 +1,7 @@
 import { dirname, join } from 'path';
 import { existsSync } from 'fs';
 import { showErrorModule, getRecursiveDirFiles, createEventName } from '../../core/utils.js';
-import { ChildrenApp } from '../store.js';
+import { registerRuntimeApp, updateRuntimeAppStatus, ChildrenApp, clearRuntimeAppKoaRouters, setRuntimeAppKoaRouters, updateRuntimeAppCapabilities } from '../store.js';
 import { registerExpose } from '../expose.js';
 import { ResultCode, fileSuffixMiddleware } from '../../core/variable.js';
 import { registerAppDir, scheduleCancelByApp, unregisterAppDir } from '../schedule-store.js';
@@ -10,6 +10,33 @@ import module$1 from 'module';
 const initRequire = () => { };
 initRequire.resolve = () => '';
 const require$1 = module$1?.createRequire?.(import.meta.url) ?? initRequire;
+const resolvePackageRoot = (startDir) => {
+    let currentDir = startDir;
+    while (currentDir && currentDir !== dirname(currentDir)) {
+        if (existsSync(join(currentDir, 'package.json'))) {
+            return currentDir;
+        }
+        currentDir = dirname(currentDir);
+    }
+    return startDir;
+};
+const detectWebCapability = (startDir) => {
+    const packageRoot = resolvePackageRoot(startDir);
+    const packageJsonPath = join(packageRoot, 'package.json');
+    if (!existsSync(packageJsonPath)) {
+        return existsSync(join(packageRoot, 'index.html'));
+    }
+    try {
+        const pkg = require$1(packageJsonPath) ?? {};
+        const root = pkg?.alemonjs?.web?.root;
+        if (typeof root === 'string' && root.trim()) {
+            return existsSync(join(packageRoot, root));
+        }
+    }
+    catch {
+    }
+    return existsSync(join(packageRoot, 'index.html'));
+};
 const loadChildren = async (mainPath, appName) => {
     if (!mainPath || typeof mainPath !== 'string') {
         logger.error({
@@ -21,6 +48,24 @@ const loadChildren = async (mainPath, appName) => {
     }
     const mainDir = dirname(mainPath);
     const App = new ChildrenApp(appName);
+    const kind = appName === 'main' ? 'main' : 'plugin';
+    const baseCapabilities = {
+        event: false,
+        httpApi: existsSync(join(mainDir, 'route', 'api')),
+        web: detectWebCapability(mainDir),
+        schedule: false,
+        expose: false
+    };
+    registerRuntimeApp({
+        name: appName,
+        kind,
+        enabled: true,
+        status: 'discovered',
+        rootDir: mainDir,
+        mainPath,
+        capabilities: baseCapabilities
+    });
+    updateRuntimeAppStatus(appName, 'loading');
     registerAppDir(appName, mainDir);
     try {
         const moduleApp = await import(`file://${mainPath}`);
@@ -46,6 +91,8 @@ const loadChildren = async (mainPath, appName) => {
         App.pushCycle(app);
         const unMounted = async (e) => {
             showErrorModule(e);
+            clearRuntimeAppKoaRouters(appName);
+            updateRuntimeAppStatus(appName, 'failed', e);
             scheduleCancelByApp(appName);
             unregisterAppDir(appName);
             App.un();
@@ -69,17 +116,28 @@ const loadChildren = async (mainPath, appName) => {
         }
         const registerMounted = async () => {
             const res = await app?.register();
+            const hasEventCapability = Boolean(res && (res?.response || res?.middleware || res?.responseRouter || res?.middlewareRouter));
+            const hasExposeCapability = Boolean(res?.expose);
+            const hasKoaRouterCapability = Boolean(res?.koaRouter);
             if (res && (res?.response || res?.middleware || res?.responseRouter || res?.middlewareRouter)) {
                 App.register(res);
             }
+            setRuntimeAppKoaRouters(appName, res?.koaRouter);
             if (res?.expose) {
                 registerExpose(appName, res.expose.getConfigs());
             }
+            updateRuntimeAppCapabilities(appName, {
+                ...baseCapabilities,
+                httpApi: baseCapabilities.httpApi || hasKoaRouterCapability,
+                event: hasEventCapability,
+                expose: hasExposeCapability
+            });
             App.on();
             try {
                 if (app?.onMounted) {
                     await app.onMounted({ response: [], responseMiddleware: {}, middleware: [] });
                 }
+                updateRuntimeAppStatus(appName, 'ready');
             }
             catch (e) {
                 void unMounted(e);
@@ -139,11 +197,16 @@ const loadChildren = async (mainPath, appName) => {
                 mwData.push(middleware);
             }
             App.pushMiddleware(mwData);
+            updateRuntimeAppCapabilities(appName, {
+                ...baseCapabilities,
+                event: resData.length > 0 || Object.keys(resAndMwData).length > 0 || mwData.length > 0
+            });
             App.on();
             try {
                 if (app?.onMounted) {
                     await app.onMounted({ response: resData, responseMiddleware: resAndMwData, middleware: mwData });
                 }
+                updateRuntimeAppStatus(appName, 'ready');
             }
             catch (e) {
                 void unMounted(e);
@@ -163,6 +226,8 @@ const loadChildren = async (mainPath, appName) => {
     }
     catch (e) {
         showErrorModule(e);
+        clearRuntimeAppKoaRouters(appName);
+        updateRuntimeAppStatus(appName, 'failed', e);
         App.un();
     }
 };
@@ -178,6 +243,7 @@ const loadChildrenFile = (appName) => {
     try {
         const mainPath = require$1.resolve(appName);
         if (!existsSync(mainPath)) {
+            updateRuntimeAppStatus(appName, 'failed', new Error('The main file does not exist,' + mainPath));
             logger.error({
                 code: ResultCode.FailParams,
                 message: 'The main file does not exist,' + mainPath,
@@ -185,9 +251,18 @@ const loadChildrenFile = (appName) => {
             });
             return;
         }
+        registerRuntimeApp({
+            name: appName,
+            kind: 'plugin',
+            enabled: true,
+            status: 'discovered',
+            rootDir: dirname(mainPath),
+            mainPath
+        });
         void loadChildren(mainPath, appName);
     }
     catch (e) {
+        updateRuntimeAppStatus(appName, 'failed', e);
         showErrorModule(e);
     }
 };

package/lib/app/router/dsl.js

@@ -545,6 +545,8 @@ class Router {
             attachRouteContext(event, {
                 key: match.route.config.path,
                 text: match.normalizedCommand,
+                sourceText: typeof event.MessageText === 'string' ? event.MessageText : undefined,
+                rewrittenText: match.normalizedCommand,
                 rawArgs: match.rawArgs,
                 parsedArgs: [],
                 params: {}
@@ -570,6 +572,8 @@ class Router {
         attachRouteContext(event, {
             key: match.route.config.path,
             text: match.normalizedCommand,
+            sourceText: initialMessageText,
+            rewrittenText: match.normalizedCommand,
             rawArgs: match.rawArgs,
             parsedArgs: match.parsedArgs,
             params
@@ -606,6 +610,8 @@ class Router {
             attachRouteContext(event, {
                 key: '',
                 text: scopedText,
+                sourceText: typeof event.MessageText === 'string' ? event.MessageText : undefined,
+                rewrittenText: scopedText,
                 rawArgs: [],
                 parsedArgs: [],
                 params: {}

package/lib/app/router/types.d.ts

@@ -3,6 +3,8 @@ export type RouteParams = Record<string, RouteSchemaValue | undefined>;
 export type RouteContext = {
     key: string;
     text: string;
+    sourceText?: string;
+    rewrittenText?: string;
     rawArgs: string[];
     parsedArgs: RouteSchemaValue[];
     params: RouteParams;

package/lib/app/store.d.ts

@@ -1,5 +1,31 @@
 import { SinglyLinkedList } from './SinglyLinkedList';
 import { childrenCallbackRes, ChildrenCycle, EventCycleEnum, EventKeys, FileTreeNode, StoreMiddlewareItem, StoreResponseItem, SubscribeValue } from '../types';
+import type KoaRouter from 'koa-router';
+export type RuntimeAppStatus = 'discovered' | 'loading' | 'ready' | 'failed' | 'disposed';
+export type RuntimeAppCapability = {
+    event: boolean;
+    httpApi: boolean;
+    web: boolean;
+    schedule: boolean;
+    expose: boolean;
+};
+export type RuntimeAppError = {
+    message: string;
+    stack?: string;
+    time: number;
+};
+export type RuntimeAppRecord = {
+    name: string;
+    kind: 'main' | 'plugin';
+    enabled: boolean;
+    status: RuntimeAppStatus;
+    rootDir: string;
+    mainPath: string;
+    error?: RuntimeAppError;
+    capabilities: RuntimeAppCapability;
+    createdAt: number;
+    updatedAt: number;
+};
 export declare class Logger {
     #private;
     constructor();
@@ -14,8 +40,92 @@ export declare class Core {
         storeChildrenApp: {
             [key: string]: import("../types").StoreChildrenApp;
         };
+        runtimeApps?: {
+            [key: string]: RuntimeAppRecord;
+        };
+        runtimeAppKoaRouters?: {
+            [key: string]: KoaRouter[];
+        };
     };
 }
+export declare const registerRuntimeApp: (record: Omit<RuntimeAppRecord, "createdAt" | "updatedAt" | "capabilities"> & {
+    capabilities?: Partial<RuntimeAppCapability>;
+}) => RuntimeAppRecord;
+export declare const updateRuntimeAppStatus: (name: string, status: RuntimeAppStatus, error?: unknown) => RuntimeAppRecord;
+export declare const updateRuntimeAppCapabilities: (name: string, capabilities: Partial<RuntimeAppCapability>) => RuntimeAppRecord;
+export declare const setRuntimeAppKoaRouters: (name: string, koaRouters?: KoaRouter | KoaRouter[]) => KoaRouter<any, {}>[];
+export declare const getRuntimeAppKoaRouters: (name: string) => KoaRouter<any, {}>[];
+export declare const clearRuntimeAppKoaRouters: (name: string) => void;
+export declare const listRuntimeAppKoaRouters: () => {
+    name: string;
+    routers: KoaRouter<any, {}>[];
+}[];
+export declare const getRuntimeApp: (name: string) => RuntimeAppRecord;
+export declare const toRuntimeAppSnapshot: (item: RuntimeAppRecord) => {
+    capabilities: {
+        event: boolean;
+        httpApi: boolean;
+        web: boolean;
+        schedule: boolean;
+        expose: boolean;
+    };
+    error: {
+        message: string;
+        time: number;
+    };
+    name: string;
+    kind: "main" | "plugin";
+    enabled: boolean;
+    status: RuntimeAppStatus;
+    rootDir: string;
+    mainPath: string;
+    createdAt: number;
+    updatedAt: number;
+};
+export declare const listRuntimeApps: () => {
+    capabilities: {
+        event: boolean;
+        httpApi: boolean;
+        web: boolean;
+        schedule: boolean;
+        expose: boolean;
+    };
+    error: {
+        message: string;
+        time: number;
+    };
+    name: string;
+    kind: "main" | "plugin";
+    enabled: boolean;
+    status: RuntimeAppStatus;
+    rootDir: string;
+    mainPath: string;
+    createdAt: number;
+    updatedAt: number;
+}[];
+export declare const disposeRuntimeApp: (name: string) => RuntimeAppRecord;
+export declare const disposeAllRuntimeApps: () => {
+    capabilities: {
+        event: boolean;
+        httpApi: boolean;
+        web: boolean;
+        schedule: boolean;
+        expose: boolean;
+    };
+    error: {
+        message: string;
+        time: number;
+    };
+    name: string;
+    kind: "main" | "plugin";
+    enabled: boolean;
+    status: RuntimeAppStatus;
+    rootDir: string;
+    mainPath: string;
+    createdAt: number;
+    updatedAt: number;
+}[];
+export declare const hasRuntimeAppCapability: (name: string, capability: keyof RuntimeAppCapability) => boolean;
 export declare const bumpStoreVersion: () => void;
 export declare class Response {
     #private;
@@ -87,4 +197,10 @@ export declare const core: {
     storeChildrenApp: {
         [key: string]: import("../types").StoreChildrenApp;
     };
+    runtimeApps?: {
+        [key: string]: RuntimeAppRecord;
+    };
+    runtimeAppKoaRouters?: {
+        [key: string]: KoaRouter[];
+    };
 };

package/lib/app/store.js

@@ -107,7 +107,9 @@ class Core {
                     mount: new Map(),
                     unmount: new Map()
                 },
-                storeChildrenApp: {}
+                storeChildrenApp: {},
+                runtimeApps: {},
+                runtimeAppKoaRouters: {}
             };
         }
     }
@@ -116,6 +118,203 @@ class Core {
     }
 }
 let _storeVersion = 0;
+const createEmptyRuntimeCapabilities = () => ({
+    event: false,
+    httpApi: false,
+    web: false,
+    schedule: false,
+    expose: false
+});
+const logRuntimeAppStatus = (level, record) => {
+    if (!global.logger?.[level]) {
+        return;
+    }
+    global.logger[level]({
+        message: 'runtime app status',
+        data: {
+            app: record.name,
+            kind: record.kind,
+            status: record.status,
+            capabilities: record.capabilities,
+            error: record.error?.message ?? null
+        }
+    });
+};
+const normalizeRuntimeAppError = (error) => {
+    if (!error) {
+        return undefined;
+    }
+    if (error instanceof Error) {
+        return {
+            message: error.message,
+            stack: error.stack,
+            time: Date.now()
+        };
+    }
+    return {
+        message: typeof error === 'string' ? error : 'Unknown runtime app error',
+        time: Date.now()
+    };
+};
+const sameRuntimeAppCapabilities = (left, right) => {
+    return (left.event === right.event &&
+        left.httpApi === right.httpApi &&
+        left.web === right.web &&
+        left.schedule === right.schedule &&
+        left.expose === right.expose);
+};
+const sameRuntimeAppError = (left, right) => {
+    if (!left && !right) {
+        return true;
+    }
+    if (!left || !right) {
+        return false;
+    }
+    return left.message === right.message && left.stack === right.stack;
+};
+const getRuntimeAppStore = () => {
+    if (!global.alemonjsCore.runtimeApps) {
+        global.alemonjsCore.runtimeApps = {};
+    }
+    return global.alemonjsCore.runtimeApps;
+};
+const getRuntimeAppKoaRouterStore = () => {
+    if (!global.alemonjsCore.runtimeAppKoaRouters) {
+        global.alemonjsCore.runtimeAppKoaRouters = {};
+    }
+    return global.alemonjsCore.runtimeAppKoaRouters;
+};
+const registerRuntimeApp = (record) => {
+    const runtimeApps = getRuntimeAppStore();
+    const current = runtimeApps[record.name];
+    const now = Date.now();
+    const nextCapabilities = {
+        ...(current?.capabilities ?? createEmptyRuntimeCapabilities()),
+        ...(record.capabilities ?? {})
+    };
+    runtimeApps[record.name] = {
+        name: record.name,
+        kind: record.kind,
+        enabled: record.enabled,
+        status: record.status,
+        rootDir: record.rootDir,
+        mainPath: record.mainPath,
+        error: record.error,
+        capabilities: nextCapabilities,
+        createdAt: current?.createdAt ?? now,
+        updatedAt: now
+    };
+    if (!current || current.status !== record.status) {
+        logRuntimeAppStatus('info', runtimeApps[record.name]);
+    }
+    return runtimeApps[record.name];
+};
+const updateRuntimeAppStatus = (name, status, error) => {
+    const runtimeApps = getRuntimeAppStore();
+    const current = runtimeApps[name];
+    if (!current) {
+        return;
+    }
+    const normalizedError = normalizeRuntimeAppError(error);
+    if (current.status === status && sameRuntimeAppError(current.error, normalizedError)) {
+        return current;
+    }
+    current.status = status;
+    current.updatedAt = Date.now();
+    current.error = normalizedError;
+    logRuntimeAppStatus(status === 'failed' ? 'warn' : 'info', current);
+    return current;
+};
+const updateRuntimeAppCapabilities = (name, capabilities) => {
+    const runtimeApps = getRuntimeAppStore();
+    const current = runtimeApps[name];
+    if (!current) {
+        return;
+    }
+    const nextCapabilities = {
+        ...current.capabilities,
+        ...capabilities
+    };
+    if (sameRuntimeAppCapabilities(current.capabilities, nextCapabilities)) {
+        return current;
+    }
+    current.capabilities = nextCapabilities;
+    current.updatedAt = Date.now();
+    return current;
+};
+const setRuntimeAppKoaRouters = (name, koaRouters) => {
+    const koaRouterStore = getRuntimeAppKoaRouterStore();
+    if (!koaRouters) {
+        delete koaRouterStore[name];
+        return [];
+    }
+    const normalizedRouters = (Array.isArray(koaRouters) ? koaRouters : [koaRouters]).filter(Boolean);
+    koaRouterStore[name] = normalizedRouters;
+    return normalizedRouters;
+};
+const getRuntimeAppKoaRouters = (name) => {
+    return getRuntimeAppKoaRouterStore()[name] ?? [];
+};
+const clearRuntimeAppKoaRouters = (name) => {
+    const koaRouterStore = getRuntimeAppKoaRouterStore();
+    delete koaRouterStore[name];
+};
+const listRuntimeAppKoaRouters = () => {
+    return Object.entries(getRuntimeAppKoaRouterStore())
+        .sort(([left], [right]) => {
+        if (left === 'main' && right !== 'main') {
+            return -1;
+        }
+        if (left !== 'main' && right === 'main') {
+            return 1;
+        }
+        return left.localeCompare(right);
+    })
+        .map(([name, routers]) => ({
+        name,
+        routers: [...routers]
+    }));
+};
+const getRuntimeApp = (name) => {
+    return getRuntimeAppStore()[name];
+};
+const toRuntimeAppSnapshot = (item) => ({
+    ...item,
+    capabilities: { ...item.capabilities },
+    error: item.error
+        ? {
+            message: item.error.message,
+            time: item.error.time
+        }
+        : undefined
+});
+const listRuntimeApps = () => {
+    return Object.values(getRuntimeAppStore())
+        .sort((left, right) => {
+        if (left.name === 'main' && right.name !== 'main') {
+            return -1;
+        }
+        if (left.name !== 'main' && right.name === 'main') {
+            return 1;
+        }
+        return left.name.localeCompare(right.name);
+    })
+        .map(toRuntimeAppSnapshot);
+};
+const disposeRuntimeApp = (name) => {
+    clearRuntimeAppKoaRouters(name);
+    return updateRuntimeAppStatus(name, 'disposed');
+};
+const disposeAllRuntimeApps = () => {
+    const runtimeApps = listRuntimeApps();
+    runtimeApps.forEach(app => {
+        disposeRuntimeApp(app.name);
+    });
+    return runtimeApps;
+};
+const hasRuntimeAppCapability = (name, capability) => {
+    return Boolean(getRuntimeApp(name)?.capabilities?.[capability]);
+};
 const bumpStoreVersion = () => {
     _storeVersion++;
 };
@@ -449,4 +648,4 @@ process?.on?.('exit', code => {
     logger.info?.(`[alemonjs][exit] 进程退出，code=${code}`);
 });
 
-export { ChildrenApp, Core, Logger, Middleware, MiddlewareRouter, MiddlewareTree, ProcessorEventAutoClearMap, ProcessorEventUserAutoClearMap, Response, ResponseMiddleware, ResponseRouter, ResponseTree, State, StateSubscribe, SubscribeList, bumpStoreVersion, core, getSubscribeList, logger };
+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 };

package/lib/client.js

@@ -16,7 +16,7 @@ import '@koa/cors';
 import './cbp/routers/router.js';
 import 'lodash';
 import 'fs/promises';
-import './app/store.js';
+import { disposeAllRuntimeApps } from './app/store.js';
 import { loadModels } from './app/load_modules/load.js';
 import './app/load_modules/loadChild.js';
 import './app/define-children.js';
@@ -28,7 +28,7 @@ import './app/event-processor.js';
 import './app/event-response.js';
 import './app/hook-event-context.js';
 import './app/message-format-old.js';
-import 'cron';
+import { scheduleCancelByApp, unregisterAppDir } from './app/schedule-store.js';
 import './app/event-utils.js';
 import './app/message-api.js';
 import './process/platform.js';
@@ -36,6 +36,18 @@ import './process/module.js';
 import { createServer } from './server/main.js';
 
 global.__client_loaded = true;
+let runtimeDisposed = false;
+const disposeRuntime = () => {
+    if (runtimeDisposed) {
+        return;
+    }
+    runtimeDisposed = true;
+    const apps = disposeAllRuntimeApps();
+    apps.forEach(app => {
+        scheduleCancelByApp(app.name);
+        unregisterAppDir(app.name);
+    });
+};
 const mainServer = () => {
     const port = process.env.serverPort;
     if (!port) {
@@ -72,10 +84,12 @@ const mainProcess = () => {
     ['SIGINT', 'SIGTERM', 'SIGQUIT', 'disconnect'].forEach(sig => {
         process?.on?.(sig, () => {
             logger.info?.(`[alemonjs][${sig}] 收到信号，正在关闭...`);
+            disposeRuntime();
             setImmediate(() => process.exit(0));
         });
     });
     process?.on?.('exit', code => {
+        disposeRuntime();
         logger.info?.(`[alemonjs][exit] 进程退出，code=${code}`);
     });
     process.on('message', msg => {
@@ -86,6 +100,7 @@ const mainProcess = () => {
                 mainServer();
             }
             else if (data?.type === 'stop') {
+                disposeRuntime();
                 process.exit(0);
             }
         }

package/lib/global.d.ts

@@ -1,6 +1,8 @@
 import type { DefineChildrenFunc, OnResponseReversalFunc, OnMiddlewareReversalFunc, OnSelectsFunc, OnDataFormatFunc, OnResponseReversalFuncBack, OnGroupFunc, OnMiddlewareReversalFuncBack, DefineResponseFunc, defineMiddlewareFunc, StoreChildrenApp, StateSubscribeMap, SubscribeKeysMap, LoggerUtils, ResponseState, StartOptions } from './types';
 import WebSocket, { Server } from 'ws';
 import { IncomingMessage } from 'http';
+import type KoaRouter from 'koa-router';
+import type { RuntimeAppRecord } from './app/store.js';
 declare global {
     var __config: any;
     var __options: StartOptions;
@@ -12,6 +14,12 @@ declare global {
         storeChildrenApp: {
             [key: string]: StoreChildrenApp;
         };
+        runtimeApps?: {
+            [key: string]: RuntimeAppRecord;
+        };
+        runtimeAppKoaRouters?: {
+            [key: string]: KoaRouter[];
+        };
     };
     var chatbotServer: Server<typeof WebSocket, typeof IncomingMessage>;
     var chatbotPlatform: WebSocket;

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, core, getSubscribeList, logger } 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, getRuntimeApp, getRuntimeAppKoaRouters, getSubscribeList, hasRuntimeAppCapability, 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';
@@ -37,6 +37,7 @@ export { usePermission } from './app/hook-use/permission.js';
 export { useReaction } from './app/hook-use/reaction.js';
 export { useRequest } from './app/hook-use/request.js';
 export { useRole } from './app/hook-use/role.js';
+export { useRoute } from './app/hook-use/route.js';
 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';

package/lib/main.js

@@ -58,8 +58,8 @@ const start = (options = {}) => {
         cbpServer(port, () => {
             const httpURL = `http://127.0.0.1:${port}`;
             const wsURL = `ws://127.0.0.1:${port}`;
-            logger.info(`[CBP server started at ${httpURL}]`);
-            logger.info(`[CBP server started at ${wsURL}]`);
+            logger.info(`[CBP-Server] ${httpURL}`);
+            logger.info(`[CBP-Server] ${wsURL}]`);
             startClient(options);
             startPlatform(options);
         });
@@ -67,7 +67,7 @@ const start = (options = {}) => {
     else {
         const sockPath = generateSocketPath();
         process.env.__ALEMON_DIRECT_SOCK = sockPath;
-        logger.info('[Direct-IPC mode] 平台↔客户端直连通道，无主进程桥接');
+        logger.info('[Direct-IPC] 平台↔客户端直连');
         startClient(options);
         startPlatform(options);
     }

package/lib/server/routers/router.js

@@ -9,14 +9,113 @@ import module$1 from 'module';
 import { ResultCode } from '../../core/variable.js';
 import 'yaml';
 import '../../core/utils.js';
+import { listRuntimeApps, getRuntimeApp, toRuntimeAppSnapshot, listRuntimeAppKoaRouters, hasRuntimeAppCapability, getRuntimeAppKoaRouters } from '../../app/store.js';
 
 const initRequire = () => { };
 initRequire.resolve = () => '';
 const require$1 = module$1?.createRequire?.(import.meta.url) ?? initRequire;
-const mainDirMap = new Map();
 const router = new KoaRouter({
     prefix: '/'
 });
+const resolvePackageRoot = (startDir) => {
+    let currentDir = startDir;
+    while (currentDir && currentDir !== path__default.dirname(currentDir)) {
+        if (existsSync(path__default.join(currentDir, 'package.json'))) {
+            return currentDir;
+        }
+        currentDir = path__default.dirname(currentDir);
+    }
+    return startDir;
+};
+const readWebRootConfig = (packageRoot) => {
+    const packageJsonPath = path__default.join(packageRoot, 'package.json');
+    if (!existsSync(packageJsonPath)) {
+        return '';
+    }
+    const pkg = require$1(packageJsonPath) ?? {};
+    return pkg?.alemonjs?.web?.root ?? '';
+};
+const denyRuntimeAppAccess = (ctx, appName, capability) => {
+    const runtimeApp = getRuntimeApp(appName);
+    if (!runtimeApp || !runtimeApp.enabled) {
+        ctx.status = 404;
+        ctx.body = {
+            code: 404,
+            message: '应用未注册或未启用',
+            data: null
+        };
+        return null;
+    }
+    if (runtimeApp.status === 'discovered' || runtimeApp.status === 'loading') {
+        ctx.status = 503;
+        ctx.body = {
+            code: 503,
+            message: '应用正在初始化',
+            data: {
+                app: appName,
+                status: runtimeApp.status
+            }
+        };
+        return null;
+    }
+    if (runtimeApp.status === 'failed') {
+        ctx.status = 500;
+        ctx.body = {
+            code: 500,
+            message: '应用生命周期失败',
+            data: {
+                app: appName,
+                status: runtimeApp.status,
+                lifecycle: 'failed'
+            }
+        };
+        return null;
+    }
+    if (runtimeApp.status === 'disposed') {
+        ctx.status = 410;
+        ctx.body = {
+            code: 410,
+            message: '应用已卸载或已结束服务',
+            data: {
+                app: appName,
+                status: runtimeApp.status,
+                lifecycle: 'disposed'
+            }
+        };
+        return null;
+    }
+    if (runtimeApp.status !== 'ready' || !hasRuntimeAppCapability(appName, capability)) {
+        ctx.status = 404;
+        ctx.body = {
+            code: 404,
+            message: '应用未提供对应服务能力',
+            data: null
+        };
+        return null;
+    }
+    return runtimeApp;
+};
+const dispatchRegisteredKoaRouters = async (ctx) => {
+    const registeredRouters = listRuntimeAppKoaRouters();
+    for (const item of registeredRouters) {
+        const runtimeApp = getRuntimeApp(item.name);
+        if (!runtimeApp || !runtimeApp.enabled || runtimeApp.status !== 'ready' || !hasRuntimeAppCapability(item.name, 'httpApi')) {
+            continue;
+        }
+        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;
+            }
+            await koaRouter.allowedMethods()(ctx, async () => { });
+            return true;
+        }
+    }
+    return false;
+};
 router.get('/', ctx => {
     ctx.status = 200;
     ctx.set('Content-Type', 'text/html; charset=utf-8');
@@ -30,6 +129,47 @@ router.get('api/online', ctx => {
         data: null
     };
 });
+router.get('api/runtime/apps', ctx => {
+    const status = String(ctx.query?.status ?? '').trim();
+    const data = listRuntimeApps().filter(item => {
+        if (!status) {
+            return true;
+        }
+        return item.status === status;
+    });
+    ctx.status = 200;
+    ctx.body = {
+        code: 200,
+        message: 'runtime apps',
+        data
+    };
+});
+router.get('api/runtime/apps/:app', ctx => {
+    const appName = ctx.params.app;
+    const runtimeApp = getRuntimeApp(appName);
+    if (!runtimeApp) {
+        ctx.status = 404;
+        ctx.body = {
+            code: 404,
+            message: '应用未注册',
+            data: null
+        };
+        return;
+    }
+    ctx.status = 200;
+    ctx.body = {
+        code: 200,
+        message: 'runtime app',
+        data: toRuntimeAppSnapshot(runtimeApp)
+    };
+});
+router.use(async (ctx, next) => {
+    const handled = await dispatchRegisteredKoaRouters(ctx);
+    if (handled) {
+        return;
+    }
+    await next();
+});
 router.all('app/{*path}', async (ctx) => {
     if (!process.env.input) {
         ctx.status = 400;
@@ -43,6 +183,10 @@ router.all('app/{*path}', async (ctx) => {
     const rootPath = process.cwd();
     const apiPath = '/app/api';
     if (ctx.path.startsWith(apiPath)) {
+        const runtimeApp = denyRuntimeAppAccess(ctx, 'main', 'httpApi');
+        if (!runtimeApp) {
+            return;
+        }
         const mainPath = join(rootPath, process.env.input);
         if (!existsSync(mainPath)) {
             ctx.status = 400;
@@ -111,9 +255,13 @@ router.all('app/{*path}', async (ctx) => {
     }
     let root = '';
     const resourcePath = formatPath(ctx.params?.path);
+    const runtimeApp = denyRuntimeAppAccess(ctx, 'main', 'web');
+    if (!runtimeApp) {
+        return;
+    }
+    const packageRoot = resolvePackageRoot(runtimeApp.rootDir);
     try {
-        const pkg = require$1(path__default.join(rootPath, 'package.json')) ?? {};
-        root = pkg.alemonjs?.web?.root ?? '';
+        root = readWebRootConfig(packageRoot);
     }
     catch (err) {
         ctx.status = 500;
@@ -124,7 +272,7 @@ router.all('app/{*path}', async (ctx) => {
         };
         return;
     }
-    const webRoot = root ? path__default.join(rootPath, root) : rootPath;
+    const webRoot = root ? path__default.join(packageRoot, root) : packageRoot;
     const fullPath = safePath(webRoot, resourcePath);
     if (!fullPath) {
         ctx.status = 403;
@@ -177,22 +325,12 @@ router.all('apps/:app/{*path}', async (ctx) => {
     }
     const apiPath = `/apps/${appName}/api`;
     if (ctx.path.startsWith(apiPath)) {
+        const runtimeApp = denyRuntimeAppAccess(ctx, appName, 'httpApi');
+        if (!runtimeApp) {
+            return;
+        }
         try {
-            if (!mainDirMap.has(appName)) {
-                const mainPath = require$1.resolve(appName);
-                if (!existsSync(mainPath)) {
-                    ctx.status = 400;
-                    ctx.body = {
-                        code: 400,
-                        message: '未找到主要入口文件',
-                        data: null
-                    };
-                    return;
-                }
-                const mainDir = dirname(mainPath);
-                mainDirMap.set(appName, mainDir);
-            }
-            const routeBase = join(mainDirMap.get(appName), 'route');
+            const routeBase = join(runtimeApp.rootDir, 'route');
             const dir = safePath(routeBase, ctx.path?.replace(apiPath, '/api') || '');
             if (!dir) {
                 ctx.status = 403;
@@ -250,12 +388,15 @@ router.all('apps/:app/{*path}', async (ctx) => {
         ctx.status = 405;
         return;
     }
-    const rootPath = path__default.join(process.cwd(), 'node_modules', appName);
+    const runtimeApp = denyRuntimeAppAccess(ctx, appName, 'web');
+    if (!runtimeApp) {
+        return;
+    }
+    const packageRoot = resolvePackageRoot(runtimeApp.rootDir);
     const resourcePath = formatPath(ctx.params?.path);
     let root = '';
     try {
-        const pkg = require$1(`${appName}/package`) ?? {};
-        root = pkg?.alemonjs?.web?.root ?? '';
+        root = readWebRootConfig(packageRoot);
     }
     catch (err) {
         ctx.status = 500;
@@ -266,7 +407,7 @@ router.all('apps/:app/{*path}', async (ctx) => {
         };
         return;
     }
-    const webRoot = root ? path__default.join(rootPath, root) : rootPath;
+    const webRoot = root ? path__default.join(packageRoot, root) : packageRoot;
     const fullPath = safePath(webRoot, resourcePath);
     if (!fullPath) {
         ctx.status = 403;

package/lib/types/event/base/expansion.d.ts

@@ -1,8 +1,11 @@
 export type Expansion = {
     IsAtMe?: boolean;
     IsPrivate?: boolean;
+    _sendAttempted?: boolean;
     _has_send_attempt?: boolean;
+    _sendSucceeded?: boolean;
     _has_send_success?: boolean;
+    _lastSendError?: string | null;
     _last_send_error?: string | null;
     [key: string]: any;
 };

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

@@ -3,6 +3,7 @@ import { ClientAPI } from '../client';
 import { EventKeys, Events } from './map';
 import { DataEnums } from '../message';
 import { Expose } from '../../app/expose';
+import type KoaRouter from 'koa-router';
 export type Current<T extends EventKeys> = (event: Events[T], next: Next) => Promise<boolean | void | undefined> | boolean | void | undefined;
 export type OnResponseValue<C, T extends EventKeys> = {
     current: C;
@@ -56,6 +57,7 @@ export type childrenCallbackRes = {
     middleware?: ReturnType<defineMiddlewareFunc>;
     responseRouter?: ReturnType<DefineRouterFunc>;
     middlewareRouter?: ReturnType<DefineRouterFunc>;
+    koaRouter?: KoaRouter | KoaRouter[];
     expose?: Expose;
 } | undefined;
 export type childrenCallback = ChildrenCycle & {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "alemonjs",
-  "version": "2.1.79",
+  "version": "2.1.81",
   "description": "bot script",
   "author": "lemonade",
   "license": "MIT",
@@ -34,7 +34,6 @@
     "cron": "^4.4.0",
     "file-type": "21.0.0",
     "flatted": "^3.3.3",
-    "https-proxy-agent": "^9.0.0",
     "koa": "^3.0.1",
     "koa-router": "^14.0.0",
     "koa-static": "^5.0.0",
@@ -44,6 +43,7 @@
     "qrcode": "^1.5.4",
     "uuid": "11.1.0",
     "ws": "^8.18.0",
+    "https-proxy-agent": "^9.0.0",
     "yaml": "^2.5.1"
   },
   "devDependencies": {
@@ -71,5 +71,5 @@
     "type": "git",
     "url": "https://github.com/lemonade-lab/alemonjs.git"
   },
-  "gitHead": "7dab16a2167bbdf5706931b67e7eab2fc67835d6"
-}
+  "gitHead": "c6aa5616afe091a37610dad22fbb2d2618d943b8"
+}

package/LICENSE

@@ -1,21 +0,0 @@
-The MIT License (MIT)
-
-Copyright (c) 2013-present, Yuxi (Evan) You
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIdED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.