@linyjs/server-module-interface 0.0.5 → 0.0.7

package/dist/application.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 服务端应用接口
+ * 详见 [服务端插件式架构设计](../../spec/服务端插件式架构设计.md)
+ */
+import type { IModule, IModuleHandler } from './di.js';
+/** 服务端应用接口 */
+export interface IServerApplication {
+    /** 设置模块生命周期处理器 */
+    setHandler(handler: IModuleHandler): void;
+    /** 加载一组模块，按依赖拓扑排序后由容器实例化服务 */
+    loadModules(modules: IModule[]): Promise<void>;
+    /** 获取服务实例 */
+    getService<T>(moduleName: string, serviceTag: string): T;
+    /** 销毁所有已加载模块（逆序调用 handler.onModuleUnloaded） */
+    destroyAll(): Promise<void>;
+}
+//# sourceMappingURL=application.d.ts.map

package/dist/application.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application.d.ts","sourceRoot":"","sources":["../src/application.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAoB,MAAM,SAAS,CAAA;AAExE,cAAc;AACd,MAAM,WAAW,kBAAkB;IACjC,kBAAkB;IAClB,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAAA;IAEzC,8BAA8B;IAC9B,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE9C,aAAa;IACb,UAAU,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,CAAC,CAAA;IAExD,+CAA+C;IAC/C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAC5B"}

package/dist/application.js

@@ -0,0 +1,6 @@
+/**
+ * 服务端应用接口
+ * 详见 [服务端插件式架构设计](../../spec/服务端插件式架构设计.md)
+ */
+export {};
+//# sourceMappingURL=application.js.map

package/dist/application.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"application.js","sourceRoot":"","sources":["../src/application.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/di.d.ts

@@ -0,0 +1,100 @@
+/**
+ * 基础依赖注入类型定义
+ * 详见 [依赖注入机制设计](../../spec/依赖注入机制设计.md)
+ */
+/** 所有服务的基础类型 */
+export type IService = object;
+/** 服务类构造器类型 */
+export interface IServiceConstructor<S extends IService> {
+    new (...args: any[]): S;
+}
+/** 服务工厂函数类型 */
+export type IServiceFactory<S extends IService> = (...args: any[]) => S;
+/** 服务实现类型（类或工厂函数） */
+export type IServiceMaker<S extends IService> = IServiceConstructor<S> | IServiceFactory<S>;
+/** 服务元数据基础类型 */
+export type IServiceMetadata = Record<string, any>;
+/** 服务定义 */
+export interface IServiceDef<S extends IService = IService, M extends IServiceMetadata = IServiceMetadata> {
+    /** 服务唯一标识（模块内唯一） */
+    serviceTag: string;
+    /** 服务实现，可以是类或工厂函数 */
+    serviceImpl: IServiceMaker<S>;
+    /** 依赖的其他服务列表，支持 'serviceTag' 或 'moduleName.serviceTag' 格式 */
+    dependencies?: string[];
+    /** 元数据 */
+    meta?: M;
+}
+/** 模块定义 */
+export interface IModule {
+    /** 模块名称 */
+    name: string;
+    /** 依赖的其他模块名称 */
+    moduleDependencies?: string[];
+    /** 服务定义列表 */
+    serviceDefs: IServiceDef[];
+}
+/** 模块状态枚举 */
+export declare enum ModuleState {
+    Unloaded = "unloaded",
+    Loading = "loading",
+    Loaded = "loaded",
+    Error = "error",
+    Unloading = "unloading"
+}
+/** 模块事件类型 */
+export type ModuleEventType = 'module_loaded' | 'module_unloaded' | 'module_error' | 'module_state_changed';
+/** 模块事件 */
+export interface IModuleEvent {
+    type: ModuleEventType;
+    moduleName: string;
+    module?: ILoadedModule;
+    error?: Error;
+    timestamp: number;
+}
+/** 已加载模块的运行时表示 */
+export interface ILoadedModule {
+    /** 模块名称 */
+    name: string;
+    /** 模块状态 */
+    state: ModuleState;
+    /** 服务实例映射表 */
+    services: Map<string, IService>;
+    /** 源模块定义 */
+    sourceModule?: IModule;
+    /** 加载时间戳 */
+    loadedAt?: number;
+}
+/** 模块生命周期处理器 */
+export interface IModuleHandler {
+    /** 模块加载完成后执行 */
+    onModuleLoaded?(module: ILoadedModule): void | Promise<void>;
+    /** 模块卸载后执行 */
+    onModuleUnloaded?(module: ILoadedModule): void | Promise<void>;
+    /** 模块加载错误时执行 */
+    onModuleError?(moduleName: string, error: Error): void | Promise<void>;
+}
+/** 模块容器接口 */
+export interface IModuleContainer {
+    /** 设置模块生命周期处理器 */
+    setModuleHandler(handler: IModuleHandler): void;
+    /** 加载模块 */
+    loadModules(modules: IModule[]): Promise<void>;
+    /** 卸载模块 */
+    unloadModule(moduleName: string): Promise<void>;
+    /** 重新加载模块 */
+    reloadModule(moduleName: string, newModule?: IModule): Promise<void>;
+    /** 检查模块是否已加载 */
+    isModuleLoaded(moduleName: string): boolean;
+    /** 获取已加载模块 */
+    getLoadedModule(moduleName: string): ILoadedModule | undefined;
+    /** 获取模块状态 */
+    getModuleState(moduleName: string): ModuleState;
+    /** 获取服务实例 */
+    getService<T>(moduleName: string, serviceTag: string): T;
+    /** 监听模块事件 */
+    on(event: ModuleEventType, listener: (event: IModuleEvent) => void): void;
+    /** 取消监听模块事件 */
+    off(event: ModuleEventType, listener: (event: IModuleEvent) => void): void;
+}
+//# sourceMappingURL=di.d.ts.map

package/dist/di.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"di.d.ts","sourceRoot":"","sources":["../src/di.ts"],"names":[],"mappings":"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"}

package/dist/di.js

@@ -0,0 +1,15 @@
+/**
+ * 基础依赖注入类型定义
+ * 详见 [依赖注入机制设计](../../spec/依赖注入机制设计.md)
+ */
+// ==================== 模块状态与事件 ====================
+/** 模块状态枚举 */
+export var ModuleState;
+(function (ModuleState) {
+    ModuleState["Unloaded"] = "unloaded";
+    ModuleState["Loading"] = "loading";
+    ModuleState["Loaded"] = "loaded";
+    ModuleState["Error"] = "error";
+    ModuleState["Unloading"] = "unloading";
+})(ModuleState || (ModuleState = {}));
+//# sourceMappingURL=di.js.map

package/dist/di.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"di.js","sourceRoot":"","sources":["../src/di.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA8CH,oDAAoD;AAEpD,aAAa;AACb,MAAM,CAAN,IAAY,WAMX;AAND,WAAY,WAAW;IACrB,oCAAqB,CAAA;IACrB,kCAAmB,CAAA;IACnB,gCAAiB,CAAA;IACjB,8BAAe,CAAA;IACf,sCAAuB,CAAA;AACzB,CAAC,EANW,WAAW,KAAX,WAAW,QAMtB"}

package/dist/domain.d.ts

@@ -0,0 +1,62 @@
+/**
+ * 服务端领域类型
+ * 详见 [服务端模块接口设计](../../spec/服务端模块接口设计.md)
+ */
+/** 路由上下文 — 由中间件逐步填充的可变上下文 */
+export interface IRouteContext {
+    [key: string]: unknown;
+}
+/** 中间件 next 函数 */
+export type INextFunction = () => void | Promise<void>;
+/** 路由处理函数返回值 - 根据 responseType 自动推断 */
+export type IRouteHandlerResult = any | string | {
+    filePath: string;
+    filename?: string;
+    contentType?: string;
+} | NodeJS.ReadableStream | {
+    data: any;
+    status?: number;
+} | void;
+/** 路由处理函数 */
+export type IRouteHandler = (params: Record<string, any>, ctx: IRouteContext) => IRouteHandlerResult | Promise<IRouteHandlerResult>;
+/** 中间件处理函数 */
+export type IMiddlewareHandler = (params: Record<string, any>, ctx: IRouteContext, next: INextFunction) => void | Promise<void>;
+/** 路由 */
+export interface IRoute {
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+    path: string;
+    /**
+     * 中间件引用列表，元素为 IMiddleware.middlewareId。
+     * 解析规则：
+     *  - 裸 ID（如 'auth'）：优先在当前模块内查找，找不到则按模块依赖顺序向外查找
+     *  - 跨模块引用（如 'security.auth'）：显式指定 moduleName，格式为 "moduleName.middlewareId"
+     *  - 引用的 middlewareId 不存在时，Handler 应在加载阶段抛出错误，拒绝注册该路由
+     *  - 数组顺序即执行顺序，按从前到后依次调用
+     */
+    middlewares: string[];
+    handler: IRouteHandler;
+    /**
+     * 响应类型声明（可选），用于框架层自动处理响应格式化
+     * - 'json': 自动序列化为 JSON，设置 Content-Type: application/json
+     * - 'file': 自动发送文件，支持断点续传
+     * - 'video_stream': 流式传输视频，支持 range 请求
+     *
+     * 如果未指定，框架会根据 handler 返回值的 type 字段自动推断
+     */
+    responseType?: 'json' | 'file' | 'video_stream';
+    meta?: Record<string, any>;
+}
+/** 中间件 */
+export interface IMiddleware {
+    /** 中间件唯一标识，模块内唯一。跨模块引用时通过 "moduleName.middlewareId" 定位 */
+    middlewareId: string;
+    handler: IMiddlewareHandler;
+}
+/** 定时任务 */
+export interface ICronJob {
+    name: string;
+    /** cron 表达式 */
+    schedule: string;
+    run(): Promise<void>;
+}
+//# sourceMappingURL=domain.d.ts.map

package/dist/domain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.d.ts","sourceRoot":"","sources":["../src/domain.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,6BAA6B;AAC7B,MAAM,WAAW,aAAa;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,kBAAkB;AAClB,MAAM,MAAM,aAAa,GAAG,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAEtD,uCAAuC;AACvC,MAAM,MAAM,mBAAmB,GAC3B,GAAG,GACH,MAAM,GACN;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7D,MAAM,CAAC,cAAc,GACrB;IAAE,IAAI,EAAE,GAAG,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9B,IAAI,CAAA;AAER,aAAa;AACb,MAAM,MAAM,aAAa,GAAG,CAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,GAAG,EAAE,aAAa,KACf,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAA;AAEvD,cAAc;AACd,MAAM,MAAM,kBAAkB,GAAG,CAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,GAAG,EAAE,aAAa,EAClB,IAAI,EAAE,aAAa,KAChB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAEzB,SAAS;AACT,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAA;IACnD,IAAI,EAAE,MAAM,CAAA;IACZ;;;;;;;OAOG;IACH,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,OAAO,EAAE,aAAa,CAAA;IACtB;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,cAAc,CAAA;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAC3B;AAED,UAAU;AACV,MAAM,WAAW,WAAW;IAC1B,0DAA0D;IAC1D,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,kBAAkB,CAAA;CAC5B;AAED,WAAW;AACX,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,eAAe;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACrB"}

package/dist/domain.js

@@ -0,0 +1,6 @@
+/**
+ * 服务端领域类型
+ * 详见 [服务端模块接口设计](../../spec/服务端模块接口设计.md)
+ */
+export {};
+//# sourceMappingURL=domain.js.map

package/dist/domain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.js","sourceRoot":"","sources":["../src/domain.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @linyjs/server-module-interface
+ *
+ * 服务端模块接口定义
+ * 详见 [服务端模块接口设计](../../spec/服务端模块接口设计.md)
+ * 详见 [服务端插件式架构设计](../../spec/服务端插件式架构设计.md)
+ */
+export type { IService, IServiceConstructor, IServiceFactory, IServiceMaker, IServiceMetadata, IServiceDef, IModule, ILoadedModule, IModuleHandler, IModuleContainer, ModuleEventType, IModuleEvent, } from './di.js';
+export { ModuleState } from './di.js';
+export type { IRouteContext, INextFunction, IRouteHandler, IMiddlewareHandler, IRoute, IMiddleware, ICronJob, } from './domain.js';
+export type { IControllerService, IMiddlewareService, ICronService, IServerServiceUsageType, IControllerMetadata, IMiddlewareMetadata, ICronMetadata, IControllerServiceDef, IMiddlewareServiceDef, ICronServiceDef, IServerServiceDef, } from './interfaces.js';
+export type { IServerApplication } from './application.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EACV,QAAQ,EACR,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,OAAO,EACP,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,YAAY,GACb,MAAM,SAAS,CAAA;AAGhB,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAGrC,YAAY,EACV,aAAa,EACb,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,MAAM,EACN,WAAW,EACX,QAAQ,GACT,MAAM,aAAa,CAAA;AAGpB,YAAY,EACV,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,EACZ,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,qBAAqB,EACrB,qBAAqB,EACrB,eAAe,EACf,iBAAiB,GAClB,MAAM,iBAAiB,CAAA;AAGxB,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/index.js

@@ -0,0 +1,10 @@
+/**
+ * @linyjs/server-module-interface
+ *
+ * 服务端模块接口定义
+ * 详见 [服务端模块接口设计](../../spec/服务端模块接口设计.md)
+ * 详见 [服务端插件式架构设计](../../spec/服务端插件式架构设计.md)
+ */
+// 模块状态枚举（运行时值）
+export { ModuleState } from './di.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAkBH,eAAe;AACf,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA"}

package/{src/interfaces.ts → dist/interfaces.d.ts}

@@ -2,57 +2,40 @@
  * 服务端服务接口、元数据类型、ServiceDef 组合类型
  * 详见 [服务端模块接口设计](../../spec/服务端模块接口设计.md)
  */
-
-import type { IServiceDef, IServiceMetadata } from './di.js'
-import type { IRoute, IMiddleware, ICronJob } from './domain.js'
-
-// ==================== 服务接口 ====================
-
+import type { IServiceDef, IServiceMetadata } from './di.js';
+import type { IRoute, IMiddleware, ICronJob } from './domain.js';
 /** 控制器服务 */
 export interface IControllerService {
-  getRoutes(): IRoute[]
+    getRoutes(): IRoute[];
 }
-
 /** 中间件服务 */
 export interface IMiddlewareService {
-  getMiddlewares(): IMiddleware[]
+    getMiddlewares(): IMiddleware[];
 }
-
 /** 定时任务服务 */
 export interface ICronService {
-  getCronJobs(): ICronJob[]
+    getCronJobs(): ICronJob[];
 }
-
-// ==================== 元数据类型 ====================
-
 /** 服务端服务用途类型 */
-export type IServerServiceUsageType = 'controller' | 'middleware' | 'cron'
-
+export type IServerServiceUsageType = 'controller' | 'middleware' | 'cron';
 /** 路由元数据 */
 export interface IControllerMetadata extends IServiceMetadata {
-  usageType: 'controller'
+    usageType: 'controller';
 }
-
 /** 中间件元数据 */
 export interface IMiddlewareMetadata extends IServiceMetadata {
-  usageType: 'middleware'
+    usageType: 'middleware';
 }
-
 /** 定时任务元数据 */
 export interface ICronMetadata extends IServiceMetadata {
-  usageType: 'cron'
+    usageType: 'cron';
 }
-
-// ==================== ServiceDef 组合类型 ====================
-
 /** 控制器服务定义 */
-export type IControllerServiceDef = IServiceDef<IControllerService, IControllerMetadata>
-
+export type IControllerServiceDef = IServiceDef<IControllerService, IControllerMetadata>;
 /** 中间件服务定义 */
-export type IMiddlewareServiceDef = IServiceDef<IMiddlewareService, IMiddlewareMetadata>
-
+export type IMiddlewareServiceDef = IServiceDef<IMiddlewareService, IMiddlewareMetadata>;
 /** 定时任务服务定义 */
-export type ICronServiceDef = IServiceDef<ICronService, ICronMetadata>
-
+export type ICronServiceDef = IServiceDef<ICronService, ICronMetadata>;
 /** 服务端 ServiceDef 联合类型 */
-export type IServerServiceDef = IControllerServiceDef | IMiddlewareServiceDef | ICronServiceDef
+export type IServerServiceDef = IControllerServiceDef | IMiddlewareServiceDef | ICronServiceDef;
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../src/interfaces.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAC5D,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAIhE,YAAY;AACZ,MAAM,WAAW,kBAAkB;IACjC,SAAS,IAAI,MAAM,EAAE,CAAA;CACtB;AAED,YAAY;AACZ,MAAM,WAAW,kBAAkB;IACjC,cAAc,IAAI,WAAW,EAAE,CAAA;CAChC;AAED,aAAa;AACb,MAAM,WAAW,YAAY;IAC3B,WAAW,IAAI,QAAQ,EAAE,CAAA;CAC1B;AAID,gBAAgB;AAChB,MAAM,MAAM,uBAAuB,GAAG,YAAY,GAAG,YAAY,GAAG,MAAM,CAAA;AAE1E,YAAY;AACZ,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IAC3D,SAAS,EAAE,YAAY,CAAA;CACxB;AAED,aAAa;AACb,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IAC3D,SAAS,EAAE,YAAY,CAAA;CACxB;AAED,cAAc;AACd,MAAM,WAAW,aAAc,SAAQ,gBAAgB;IACrD,SAAS,EAAE,MAAM,CAAA;CAClB;AAID,cAAc;AACd,MAAM,MAAM,qBAAqB,GAAG,WAAW,CAAC,kBAAkB,EAAE,mBAAmB,CAAC,CAAA;AAExF,cAAc;AACd,MAAM,MAAM,qBAAqB,GAAG,WAAW,CAAC,kBAAkB,EAAE,mBAAmB,CAAC,CAAA;AAExF,eAAe;AACf,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,YAAY,EAAE,aAAa,CAAC,CAAA;AAEtE,0BAA0B;AAC1B,MAAM,MAAM,iBAAiB,GAAG,qBAAqB,GAAG,qBAAqB,GAAG,eAAe,CAAA"}

package/dist/interfaces.js

@@ -0,0 +1,6 @@
+/**
+ * 服务端服务接口、元数据类型、ServiceDef 组合类型
+ * 详见 [服务端模块接口设计](../../spec/服务端模块接口设计.md)
+ */
+export {};
+//# sourceMappingURL=interfaces.js.map

package/dist/interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../src/interfaces.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@linyjs/server-module-interface",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -11,6 +11,10 @@
       "default": "./dist/index.js"
     }
   },
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "scripts": {
     "build": "tsc -b",
     "clean": "rm -rf dist *.tsbuildinfo"

package/src/application.ts

@@ -1,21 +0,0 @@
-/**
- * 服务端应用接口
- * 详见 [服务端插件式架构设计](../../spec/服务端插件式架构设计.md)
- */
-
-import type { IModule, IModuleHandler, IModuleContainer } from './di.js'
-
-/** 服务端应用接口 */
-export interface IServerApplication {
-  /** 设置模块生命周期处理器 */
-  setHandler(handler: IModuleHandler): void
-
-  /** 加载一组模块，按依赖拓扑排序后由容器实例化服务 */
-  loadModules(modules: IModule[]): Promise<void>
-
-  /** 获取服务实例 */
-  getService<T>(moduleName: string, serviceTag: string): T
-
-  /** 销毁所有已加载模块（逆序调用 handler.onModuleUnloaded） */
-  destroyAll(): Promise<void>
-}

package/src/di.ts

@@ -1,127 +0,0 @@
-/**
- * 基础依赖注入类型定义
- * 详见 [依赖注入机制设计](../../spec/依赖注入机制设计.md)
- */
-
-/** 所有服务的基础类型 */
-export type IService = object
-
-/** 服务类构造器类型 */
-export interface IServiceConstructor<S extends IService> {
-  new (...args: any[]): S
-}
-
-/** 服务工厂函数类型 */
-export type IServiceFactory<S extends IService> = (...args: any[]) => S
-
-/** 服务实现类型（类或工厂函数） */
-export type IServiceMaker<S extends IService> =
-  | IServiceConstructor<S>
-  | IServiceFactory<S>
-
-/** 服务元数据基础类型 */
-export type IServiceMetadata = Record<string, any>
-
-/** 服务定义 */
-export interface IServiceDef<
-  S extends IService = IService,
-  M extends IServiceMetadata = IServiceMetadata
-> {
-  /** 服务唯一标识（模块内唯一） */
-  serviceTag: string
-  /** 服务实现，可以是类或工厂函数 */
-  serviceImpl: IServiceMaker<S>
-  /** 依赖的其他服务列表，支持 'serviceTag' 或 'moduleName.serviceTag' 格式 */
-  dependencies?: string[]
-  /** 元数据 */
-  meta?: M
-}
-
-/** 模块定义 */
-export interface IModule {
-  /** 模块名称 */
-  name: string
-  /** 依赖的其他模块名称 */
-  moduleDependencies?: string[]
-  /** 服务定义列表 */
-  serviceDefs: IServiceDef[]
-}
-
-// ==================== 模块状态与事件 ====================
-
-/** 模块状态枚举 */
-export enum ModuleState {
-  Unloaded = 'unloaded',
-  Loading = 'loading',
-  Loaded = 'loaded',
-  Error = 'error',
-  Unloading = 'unloading',
-}
-
-/** 模块事件类型 */
-export type ModuleEventType =
-  | 'module_loaded'
-  | 'module_unloaded'
-  | 'module_error'
-  | 'module_state_changed'
-
-/** 模块事件 */
-export interface IModuleEvent {
-  type: ModuleEventType
-  moduleName: string
-  module?: ILoadedModule
-  error?: Error
-  timestamp: number
-}
-
-/** 已加载模块的运行时表示 */
-export interface ILoadedModule {
-  /** 模块名称 */
-  name: string
-  /** 模块状态 */
-  state: ModuleState
-  /** 服务实例映射表 */
-  services: Map<string, IService>
-  /** 源模块定义 */
-  sourceModule?: IModule
-  /** 加载时间戳 */
-  loadedAt?: number
-}
-
-/** 模块生命周期处理器 */
-export interface IModuleHandler {
-  /** 模块加载完成后执行 */
-  onModuleLoaded?(module: ILoadedModule): void | Promise<void>
-  /** 模块卸载后执行 */
-  onModuleUnloaded?(module: ILoadedModule): void | Promise<void>
-  /** 模块加载错误时执行 */
-  onModuleError?(moduleName: string, error: Error): void | Promise<void>
-}
-
-/** 模块容器接口 */
-export interface IModuleContainer {
-  /** 设置模块生命周期处理器 */
-  setModuleHandler(handler: IModuleHandler): void
-
-  /** 加载模块 */
-  loadModules(modules: IModule[]): Promise<void>
-
-  /** 卸载模块 */
-  unloadModule(moduleName: string): Promise<void>
-  /** 重新加载模块 */
-  reloadModule(moduleName: string, newModule?: IModule): Promise<void>
-
-  /** 检查模块是否已加载 */
-  isModuleLoaded(moduleName: string): boolean
-  /** 获取已加载模块 */
-  getLoadedModule(moduleName: string): ILoadedModule | undefined
-  /** 获取模块状态 */
-  getModuleState(moduleName: string): ModuleState
-  /** 获取服务实例 */
-  getService<T>(moduleName: string, serviceTag: string): T
-
-  /** 监听模块事件 */
-  on(event: ModuleEventType, listener: (event: IModuleEvent) => void): void
-  /** 取消监听模块事件 */
-  off(event: ModuleEventType, listener: (event: IModuleEvent) => void): void
-}

package/src/domain.ts

@@ -1,75 +0,0 @@
-/**
- * 服务端领域类型
- * 详见 [服务端模块接口设计](../../spec/服务端模块接口设计.md)
- */
-
-/** 路由上下文 — 由中间件逐步填充的可变上下文 */
-export interface IRouteContext {
-  [key: string]: unknown
-}
-
-/** 中间件 next 函数 */
-export type INextFunction = () => void | Promise<void>
-
-/** 路由处理函数返回值 - 根据 responseType 自动推断 */
-export type IRouteHandlerResult = 
-  | any                                    // responseType='json': 直接返回任意数据
-  | string                                 // responseType='file': 返回文件路径（简单场景）
-  | { filePath: string; filename?: string; contentType?: string }  // responseType='file': 完整配置
-  | NodeJS.ReadableStream                  // responseType='video_stream': 返回流对象
-  | { data: any; status?: number }        // responseType='json': 带状态码的响应
-  | void                                   // 无返回值
-
-/** 路由处理函数 */
-export type IRouteHandler = (
-  params: Record<string, any>,
-  ctx: IRouteContext
-) => IRouteHandlerResult | Promise<IRouteHandlerResult>
-
-/** 中间件处理函数 */
-export type IMiddlewareHandler = (
-  params: Record<string, any>,
-  ctx: IRouteContext,
-  next: INextFunction
-) => void | Promise<void>
-
-/** 路由 */
-export interface IRoute {
-  method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH'
-  path: string
-  /**
-   * 中间件引用列表，元素为 IMiddleware.middlewareId。
-   * 解析规则：
-   *  - 裸 ID（如 'auth'）：优先在当前模块内查找，找不到则按模块依赖顺序向外查找
-   *  - 跨模块引用（如 'security.auth'）：显式指定 moduleName，格式为 "moduleName.middlewareId"
-   *  - 引用的 middlewareId 不存在时，Handler 应在加载阶段抛出错误，拒绝注册该路由
-   *  - 数组顺序即执行顺序，按从前到后依次调用
-   */
-  middlewares: string[]
-  handler: IRouteHandler
-  /**
-   * 响应类型声明（可选），用于框架层自动处理响应格式化
-   * - 'json': 自动序列化为 JSON，设置 Content-Type: application/json
-   * - 'file': 自动发送文件，支持断点续传
-   * - 'video_stream': 流式传输视频，支持 range 请求
-   * 
-   * 如果未指定，框架会根据 handler 返回值的 type 字段自动推断
-   */
-  responseType?: 'json' | 'file' | 'video_stream'
-  meta?: Record<string, any>
-}
-
-/** 中间件 */
-export interface IMiddleware {
-  /** 中间件唯一标识，模块内唯一。跨模块引用时通过 "moduleName.middlewareId" 定位 */
-  middlewareId: string
-  handler: IMiddlewareHandler
-}
-
-/** 定时任务 */
-export interface ICronJob {
-  name: string
-  /** cron 表达式 */
-  schedule: string
-  run(): Promise<void>
-}

package/src/index.ts

@@ -1,55 +0,0 @@
-/**
- * @linyjs/server-module-interface
- *
- * 服务端模块接口定义
- * 详见 [服务端模块接口设计](../../spec/服务端模块接口设计.md)
- * 详见 [服务端插件式架构设计](../../spec/服务端插件式架构设计.md)
- */
-
-// 基础依赖注入类型
-export type {
-  IService,
-  IServiceConstructor,
-  IServiceFactory,
-  IServiceMaker,
-  IServiceMetadata,
-  IServiceDef,
-  IModule,
-  ILoadedModule,
-  IModuleHandler,
-  IModuleContainer,
-  ModuleEventType,
-  IModuleEvent,
-} from './di.js'
-
-// 模块状态枚举（运行时值）
-export { ModuleState } from './di.js'
-
-// 服务端领域类型
-export type {
-  IRouteContext,
-  INextFunction,
-  IRouteHandler,
-  IMiddlewareHandler,
-  IRoute,
-  IMiddleware,
-  ICronJob,
-} from './domain.js'
-
-// 服务接口、元数据、ServiceDef 组合类型
-export type {
-  IControllerService,
-  IMiddlewareService,
-  ICronService,
-  IServerServiceUsageType,
-  IControllerMetadata,
-  IMiddlewareMetadata,
-  ICronMetadata,
-  IControllerServiceDef,
-  IMiddlewareServiceDef,
-  ICronServiceDef,
-  IServerServiceDef,
-} from './interfaces.js'
-
-// 服务端应用接口
-export type { IServerApplication } from './application.js'

package/tsconfig.json

@@ -1,8 +0,0 @@
-{
-  "extends": "../../tsconfig.base.json",
-  "compilerOptions": {
-    "outDir": "./dist",
-    "rootDir": "./src"
-  },
-  "include": ["src"]
-}