alemonjs 2.1.80 → 2.1.82

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';

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/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,200 @@ 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(record.status === 'failed' ? 'warn' : 'debug', 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;
+    const level = status === 'failed' ? 'warn' : status === 'disposed' ? 'info' : 'debug';
+    logRuntimeAppStatus(level, 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 +645,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';

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/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.80",
+  "version": "2.1.82",
   "description": "bot script",
   "author": "lemonade",
   "license": "MIT",