@yunzai-ng/core 0.1.0

package/dist/scheduler/index.js.map

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

package/dist/server/api.d.ts

@@ -0,0 +1,179 @@
+/**
+ * 模块职责：面板 API —— 把内核各子系统的能力翻译成一组 HTTP / WebSocket 端点
+ * 依赖方向：依赖 config / logger / plugin / adapter / render / pipeline 的**具体实现**，
+ *          以及本目录的 ManagedServer 类型；不认识前端，也不被任何子系统反向依赖
+ * 生命周期：`registerApi()` 由 `App.start()` 之前的装配步骤调用一次，返回的 Disposer
+ *          交给 `App.own()`；端点本身随服务器一起活到停机
+ * 注意事项：本模块只产出描述，注册由调用方做（`createApiRoutes` 给出 `ApiSurface`，
+ *          `registerApi` 才挂上去）—— 直接 import `kernel/app.ts` 会形成 app → api → app 的环。
+ *
+ *          只读模式（`server.readonly`）是面板策略而非服务器策略：插件注册的路由一律照常放行，
+ *          适配器的 webhook 不该因为面板设成只读而收不到消息。故判断在 `requireWritable()`。
+ *
+ *          日志走 WebSocket 而非 SSE：令牌只走请求头，而 `EventSource` 设不了请求头，
+ *          退到 Cookie 会引回 CSRF 面、退到查询串会把令牌写进访问日志。
+ *
+ *          历史日志与实时日志分两条路。合成一条时「握手瞬间同步发出的那一帧」在部分客户端会丢，
+ *          历史缺一段而无人察觉。
+ */
+import type { AdapterRegistryView, BotRegistryView, CommandInfo, Disposer, HttpMethod, Logger, MiddlewareInfo, PlatformInfo, ResourceUsage, RouteHandler, RouteOptions, RuntimePaths, TaskInfo, WebSocketHandler } from "@yunzai-ng/types";
+import type { CoreConfigHandle } from "../config/core-config.js";
+import type { ConfigStore } from "../config/store.js";
+import type { LoggerHub } from "../logger/index.js";
+import type { AccountManager } from "../adapter/accounts.js";
+import type { LoginManager } from "../adapter/login.js";
+import type { RenderRegistry } from "../render/registry.js";
+import type { EventDispatcher } from "../pipeline/dispatch.js";
+import type { PluginHost } from "../plugin/host.js";
+import type { PluginMarket } from "../plugin/market.js";
+import type { SystemInfo } from "../platform/system.js";
+import type { ServerSink } from "../plugin/hooks.js";
+import type { ManagedServer } from "./index.js";
+/** 面板 API 的挂载前缀 */
+export declare const API_SCOPE = "/api";
+/** 一条面板 HTTP 端点的描述 */
+export interface ApiRoute {
+    /** HTTP 方法 */
+    readonly method: HttpMethod;
+    /** 相对 `API_SCOPE` 的路径，如 `config/:name` */
+    readonly path: string;
+    /** 处理函数 */
+    readonly handler: RouteHandler;
+    /** 注册选项；缺省即"要令牌、1MB 体上限" */
+    readonly options?: RouteOptions;
+}
+/** 一条面板 WebSocket 端点的描述 */
+export interface ApiWebSocket {
+    /** 相对 `API_SCOPE` 的路径 */
+    readonly path: string;
+    /** 每个连接调用一次 */
+    readonly handler: WebSocketHandler;
+}
+/** 面板 API 的完整端点清单 */
+export interface ApiSurface {
+    /** HTTP 端点 */
+    readonly routes: readonly ApiRoute[];
+    /** WebSocket 端点 */
+    readonly websockets: readonly ApiWebSocket[];
+}
+/**
+ * 命令、定时任务与中间件清单
+ *
+ * 与 `kernel/app.ts` 的 `KernelSubsystems.registries` 同形。这里重新声明一份而不是
+ * import 那个类型，是为了不让 api 反向依赖 kernel（见文件头第 1 条）。
+ */
+export interface ApiRegistries {
+    /**
+     * 列出全部命令
+     * @returns 命令描述数组
+     */
+    commands(): CommandInfo[];
+    /**
+     * 列出全部定时任务
+     * @returns 任务描述数组
+     */
+    tasks(): TaskInfo[];
+    /**
+     * 列出全部中间件，顺序即实际的执行顺序
+     * @returns 中间件描述数组
+     */
+    middlewares(): MiddlewareInfo[];
+}
+/** 面板 API 需要的全部依赖 */
+export interface ApiDeps {
+    /** 内核版本 */
+    readonly version: string;
+    /** 目录布局 */
+    readonly paths: RuntimePaths;
+    /** 运行环境 */
+    readonly platform: PlatformInfo;
+    /** 面板自己的日志器 */
+    readonly logger: Logger;
+    /** 内核配置句柄（读 `server.readonly` 与各项设置） */
+    readonly config: CoreConfigHandle;
+    /** 配置仓库（面板要能改任意插件的配置） */
+    readonly configStore: ConfigStore;
+    /** 日志枢纽 */
+    readonly loggerHub: LoggerHub;
+    /** 插件宿主 */
+    readonly plugins: PluginHost;
+    /**
+     * 插件市场
+     *
+     * 可选：市场依赖网络与插件目录写权限，嵌入式使用场景可以不提供，
+     * 此时相关端点一律返回 501，而不是让面板拿到一个空列表误以为市场是空的。
+     */
+    readonly market?: PluginMarket;
+    /** 命令与任务清单 */
+    readonly registries: ApiRegistries;
+    /** 适配器注册表（此处只读视图即可满足需要：注册由插件负责） */
+    readonly adapters: AdapterRegistryView;
+    /** 账号管理器 */
+    readonly accounts: AccountManager;
+    /** 登录会话管理器 */
+    readonly logins: LoginManager;
+    /** 在线 Bot 注册表 */
+    readonly bots: BotRegistryView;
+    /** 渲染器注册表 */
+    readonly renderers: RenderRegistry;
+    /** 事件分发器（读积压计数） */
+    readonly dispatcher: EventDispatcher;
+    /** 共享服务器（读监听信息与路由表） */
+    readonly server: ManagedServer;
+    /**
+     * 取应用状态
+     *
+     * 是取值函数而不是字段：状态会变，而端点清单只建一次。
+     * @returns `created` / `starting` / `running` / `stopping` / `stopped`
+     */
+    status(): string;
+    /**
+     * 取启动时间戳（毫秒）
+     * @returns 时间戳
+     */
+    startedAt(): number;
+    /**
+     * 采样资源占用
+     * @returns 内存与 CPU 快照
+     */
+    usage(): ResourceUsage;
+    /**
+     * 采样磁盘与显卡
+     *
+     * 与 `usage()` 分开的理由是**耗时不同量级**：`usage()` 只读进程自己的计数器，
+     * 同步且微秒级；本项要量文件系统、还可能 spawn 一个 nvidia-smi，故是异步的。
+     * 合成一个的话，`GET /api/overview` 就得跟着变成「等磁盘」的端点 ——
+     * 而它是面板每 5 秒必拉的那一个。
+     * @returns 磁盘与显卡快照
+     */
+    system(): Promise<SystemInfo>;
+}
+/**
+ * 造出面板 API 的全部端点描述
+ *
+ * 只造描述，不注册 —— 注册由 `registerApi()` 或调用方自己做，理由见文件头第 1 条。
+ * 想单测某个端点时，直接从返回值里挑出来调它的 `handler` 即可，不需要起服务器。
+ * @param deps 依赖
+ * @returns 端点清单
+ */
+export declare function createApiRoutes(deps: ApiDeps): ApiSurface;
+/**
+ * 将面板 API 挂载至服务器
+ *
+ * 接收 `ServerSink` 而非 `ManagedServer`：注册仅使用接缝中的三个方法，
+ * 收窄接口使该函数可在测试中对接一个测试替身服务器。
+ * @param server 服务器接缝
+ * @param surface 端点清单
+ * @returns 摘除全部端点的句柄；由 `App.stop()` 调用
+ */
+export declare function installApiRoutes(server: ServerSink, surface: ApiSurface): Disposer;
+/**
+ * 构造并挂载面板 API
+ *
+ * `createApiRoutes` 与 `installApiRoutes` 的便捷组合，由 `kernel/app.ts` 使用。
+ * @param server 服务器接缝
+ * @param deps 依赖
+ * @returns 摘除全部端点的句柄
+ */
+export declare function registerApi(server: ServerSink, deps: ApiDeps): Disposer;
+//# sourceMappingURL=api.d.ts.map

package/dist/server/api.d.ts.map

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