@napuketto/adapter 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 睦 <oppenheymu@gmail.com>
+
+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.

package/dist/core/index.d.mts

@@ -0,0 +1,2 @@
+import { a as ProtocolAdapterLike, c as BaseAction, i as AdapterRegistry, l as ErrorCodeMap, n as ProtocolHooks, o as ActionRegistry, r as ProtocolConfig, s as ActionResult, t as BaseProtocolAdapter } from "../index-C1nIfPiU.mjs";
+export { ActionRegistry, type ActionResult, AdapterRegistry, BaseAction, BaseProtocolAdapter, type ErrorCodeMap, type ProtocolAdapterLike, ProtocolConfig, type ProtocolHooks };

package/dist/core/index.mjs

@@ -0,0 +1,2 @@
+import { a as ActionRegistry, i as AdapterRegistry, n as BaseProtocolAdapter, r as BaseAction, t as ProtocolConfig } from "../core-Bj5L8WeZ.mjs";
+export { ActionRegistry, AdapterRegistry, BaseAction, BaseProtocolAdapter, ProtocolConfig };

package/dist/core-Bj5L8WeZ.mjs

@@ -0,0 +1,149 @@
+import { ConfigBase } from "@napuketto/kernel";
+//#region src/core/action-registry.ts
+var ActionRegistry = class {
+	actions = /* @__PURE__ */ new Map();
+	register(action) {
+		this.actions.set(action.name, action);
+	}
+	get(name) {
+		return this.actions.get(name);
+	}
+	has(name) {
+		return this.actions.has(name);
+	}
+	get names() {
+		return [...this.actions.keys()];
+	}
+};
+//#endregion
+//#region src/core/adapter-registry.ts
+var AdapterRegistry = class {
+	adapters = /* @__PURE__ */ new Map();
+	register(adapter) {
+		this.adapters.set(adapter.protocol, adapter);
+	}
+	get(protocol) {
+		return this.adapters.get(protocol);
+	}
+	async startAll() {
+		await Promise.all([...this.adapters.values()].map((a) => a.start()));
+	}
+	async stopAll() {
+		await Promise.all([...this.adapters.values()].map((a) => a.stop()));
+	}
+};
+//#endregion
+//#region src/core/BaseAction.ts
+/** 校验失败 retcode：HTTP 入口。 */
+const INVALID_RETCODE_HTTP = 400;
+/** 校验失败 retcode：WS 入口。 */
+const INVALID_RETCODE_WS = 1400;
+/** 动作基类：校验失败 retcode=400（HTTP）/1400（WS）。 */
+var BaseAction = class {
+	/** 校验并执行（HTTP 入口）。 */
+	handle(payload) {
+		return this.run(payload, INVALID_RETCODE_HTTP);
+	}
+	/** 校验并执行（WS 入口，echo 透传）。 */
+	async websocketHandle(payload, echo) {
+		const result = await this.run(payload, INVALID_RETCODE_WS);
+		if (echo !== void 0) result.echo = echo;
+		return result;
+	}
+	async run(payload, invalidRetcode) {
+		const parsed = this.schema.safeParse(payload);
+		if (!parsed.success) return this.fail(invalidRetcode, "参数校验失败");
+		try {
+			return {
+				retcode: 0,
+				status: "ok",
+				data: await this._handle(parsed.data),
+				message: ""
+			};
+		} catch (err) {
+			return this.mapError(err);
+		}
+	}
+	mapError(err) {
+		if (err instanceof Error && "code" in err) {
+			const typed = err;
+			return {
+				retcode: this.errorCodeMap[typed.code] ?? this.errorCodeMap["UNKNOWN"],
+				status: "failed",
+				data: null,
+				message: err.message
+			};
+		}
+		if (err instanceof Error) return this.fail(this.errorCodeMap["UNKNOWN"], err.message);
+		return this.fail(this.errorCodeMap["UNKNOWN"], "未知错误");
+	}
+	fail(retcode, message) {
+		return {
+			retcode,
+			status: "failed",
+			data: null,
+			message
+		};
+	}
+};
+//#endregion
+//#region src/core/BaseProtocolAdapter.ts
+/**
+* 协议适配器骨架。
+* @typeParam TConfig - 协议配置类型
+*/
+var BaseProtocolAdapter = class {
+	config;
+	hooks;
+	broadcaster;
+	started = false;
+	constructor(opts) {
+		this.config = opts.config;
+		this.hooks = opts.hooks;
+		this.broadcaster = opts.broadcaster;
+	}
+	/** 启动：加载配置 → 校验 → 协议层初始化。 */
+	async start() {
+		if (this.started) return;
+		const config = await this.config.load();
+		await this.hooks.onStart(config);
+		this.started = true;
+	}
+	/** 停止：协议层清理资源。 */
+	async stop() {
+		if (!this.started) return;
+		await this.hooks.onStop();
+		this.started = false;
+	}
+	/** 配置热更新：重新加载 → 校验 → 协议层处理。 */
+	async reload() {
+		const config = await this.config.reload();
+		await this.hooks.onReload(config);
+	}
+	/** 广播协议事件给所有 network 适配器。 */
+	broadcastEvent(event) {
+		this.broadcaster?.emit(event);
+	}
+	/** 获取广播器（传输装配等内部使用；未传入返回 undefined）。 */
+	getBroadcaster() {
+		return this.broadcaster;
+	}
+};
+//#endregion
+//#region src/core/config.ts
+/** 协议配置基类：zod schema + 文本读写（JSON/TOML，文件路径由装配层传入）。 */
+var ProtocolConfig = class extends ConfigBase {
+	constructor(opts) {
+		super({
+			path: opts.path,
+			schema: opts.schema,
+			defaults: opts.defaults,
+			seed: opts.seed,
+			format: opts.format
+		});
+	}
+};
+//#endregion
+export { ActionRegistry as a, AdapterRegistry as i, BaseProtocolAdapter as n, BaseAction as r, ProtocolConfig as t };
+
+//# sourceMappingURL=core-Bj5L8WeZ.mjs.map

package/dist/core-Bj5L8WeZ.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-Bj5L8WeZ.mjs","names":[],"sources":["../src/core/action-registry.ts","../src/core/adapter-registry.ts","../src/core/BaseAction.ts","../src/core/BaseProtocolAdapter.ts","../src/core/config.ts"],"sourcesContent":["/**\n * 动作注册表：按动作名索引（构建后只读）。\n */\nimport type { BaseAction } from \"./BaseAction.js\";\n\nexport class ActionRegistry {\n    private readonly actions = new Map<string, BaseAction<unknown, unknown>>();\n\n    register(action: BaseAction<unknown, unknown>): void {\n        this.actions.set(action.name, action);\n    }\n\n    get(name: string): BaseAction<unknown, unknown> | undefined {\n        return this.actions.get(name);\n    }\n\n    has(name: string): boolean {\n        return this.actions.has(name);\n    }\n\n    get names(): string[] {\n        return [...this.actions.keys()];\n    }\n}\n","/**\n * 适配器注册表：cli 按 enabledProtocols 装配用。\n */\n\n/** 协议适配器基类类型（避免 core 与具体协议循环依赖的轻量接口）。 */\nexport interface ProtocolAdapterLike {\n    readonly protocol: string;\n    start: () => Promise<void>;\n    stop: () => Promise<void>;\n}\n\nexport class AdapterRegistry {\n    private readonly adapters = new Map<string, ProtocolAdapterLike>();\n\n    register(adapter: ProtocolAdapterLike): void {\n        this.adapters.set(adapter.protocol, adapter);\n    }\n\n    get(protocol: string): ProtocolAdapterLike | undefined {\n        return this.adapters.get(protocol);\n    }\n\n    async startAll(): Promise<void> {\n        await Promise.all([...this.adapters.values()].map((a) => a.start()));\n    }\n\n    async stopAll(): Promise<void> {\n        await Promise.all([...this.adapters.values()].map((a) => a.stop()));\n    }\n}\n","/**\n * BaseAction：协议动作基类（zod 校验 + 统一错误映射）\n *\n * 各协议动作继承并实现 `_handle`；`handle`（HTTP）/ `websocketHandle`（WS）\n * 统一做 zod 校验 + KernelError → 协议错误码映射。\n */\n\nimport type { KernelErrorCode } from \"@napuketto/kernel\";\nimport type { ZodType } from \"zod\";\n\n/** 校验失败 retcode：HTTP 入口。 */\nconst INVALID_RETCODE_HTTP = 400;\n/** 校验失败 retcode：WS 入口。 */\nconst INVALID_RETCODE_WS = 1400;\n\n/** 动作执行结果（含 retcode，协议错误码由协议层映射表提供）。 */\nexport interface ActionResult<T> {\n    retcode: number;\n    status: string;\n    data: T | null;\n    message: string;\n    echo?: unknown;\n}\n\n/** 协议错误码映射表：KernelErrorCode → 协议错误码（各协议各自实现，ADR-017）。 */\nexport type ErrorCodeMap = Record<KernelErrorCode, number>;\n\n/** 动作基类：校验失败 retcode=400（HTTP）/1400（WS）。 */\nexport abstract class BaseAction<TPayload, TReturn> {\n    abstract readonly name: string;\n    abstract readonly schema: ZodType<TPayload>;\n    protected abstract readonly errorCodeMap: ErrorCodeMap;\n\n    /** 校验并执行（HTTP 入口）。 */\n    handle(payload: unknown): Promise<ActionResult<TReturn>> {\n        return this.run(payload, INVALID_RETCODE_HTTP);\n    }\n\n    /** 校验并执行（WS 入口，echo 透传）。 */\n    async websocketHandle(payload: unknown, echo?: unknown): Promise<ActionResult<TReturn>> {\n        const result = await this.run(payload, INVALID_RETCODE_WS);\n        if (echo !== undefined) {\n            result.echo = echo;\n        }\n        return result;\n    }\n\n    private async run(payload: unknown, invalidRetcode: number): Promise<ActionResult<TReturn>> {\n        const parsed = this.schema.safeParse(payload);\n        if (!parsed.success) {\n            return this.fail(invalidRetcode, \"参数校验失败\");\n        }\n        try {\n            const data = await this._handle(parsed.data);\n            return { retcode: 0, status: \"ok\", data, message: \"\" };\n        } catch (err) {\n            return this.mapError(err);\n        }\n    }\n\n    protected abstract _handle(payload: TPayload): Promise<TReturn>;\n\n    private mapError(err: unknown): ActionResult<TReturn> {\n        if (err instanceof Error && \"code\" in err) {\n            const typed = err as Error & { code: KernelErrorCode };\n            //从断言联合类型访问 code，解构会丢失 err 其余属性\n            const retcode = this.errorCodeMap[typed.code] ?? this.errorCodeMap[\"UNKNOWN\"];\n            return { retcode, status: \"failed\", data: null, message: err.message };\n        }\n        if (err instanceof Error) {\n            return this.fail(this.errorCodeMap[\"UNKNOWN\"], err.message);\n        }\n        return this.fail(this.errorCodeMap[\"UNKNOWN\"], \"未知错误\");\n    }\n\n    private fail(retcode: number, message: string): ActionResult<TReturn> {\n        return { retcode, status: \"failed\", data: null, message };\n    }\n}\n","/**\n * BaseProtocolAdapter：协议适配器骨架（ADR-013，只写一次，各协议薄映射）\n *\n * 生命周期：start（校验配置 → 协议层初始化 → 启动传输）→ stop。\n * 请求分发：协议层把 network 的 onRequest 绑定到 `handleRequest`。\n * 事件广播：协议层翻译 kernel 事件后经 `broadcastEvent` 推给 network。\n */\nimport type { EventBroadcaster } from \"@napuketto/network\";\nimport type { ZodType } from \"zod\";\nimport type { ProtocolConfig } from \"./config.js\";\n\n/** 适配器生命周期钩子：由协议层实现（配置校验、初始化、资源清理）。 */\nexport interface ProtocolHooks {\n    /** 配置校验通过后初始化（如建立 kernel 事件订阅）。 */\n    onStart: (config: unknown) => Promise<void>;\n    /** 停止时清理资源（退订、关闭传输等）。 */\n    onStop: () => Promise<void>;\n    /** 配置热更新。 */\n    onReload: (config: unknown) => Promise<void>;\n}\n\n/**\n * 协议适配器骨架。\n * @typeParam TConfig - 协议配置类型\n */\nexport abstract class BaseProtocolAdapter<TConfig> {\n    abstract readonly protocol: string;\n    abstract readonly configSchema: ZodType<TConfig>;\n\n    protected readonly config: ProtocolConfig<TConfig>;\n    protected readonly hooks: ProtocolHooks;\n    private readonly broadcaster: EventBroadcaster | undefined;\n    private started = false;\n\n    constructor(opts: {\n        config: ProtocolConfig<TConfig>;\n        hooks: ProtocolHooks;\n        broadcaster?: EventBroadcaster;\n    }) {\n        this.config = opts.config;\n        this.hooks = opts.hooks;\n        this.broadcaster = opts.broadcaster;\n    }\n\n    /** 启动：加载配置 → 校验 → 协议层初始化。 */\n    async start(): Promise<void> {\n        if (this.started) {\n            return;\n        }\n        const config = await this.config.load();\n        await this.hooks.onStart(config);\n        this.started = true;\n    }\n\n    /** 停止：协议层清理资源。 */\n    async stop(): Promise<void> {\n        if (!this.started) {\n            return;\n        }\n        await this.hooks.onStop();\n        this.started = false;\n    }\n\n    /** 配置热更新：重新加载 → 校验 → 协议层处理。 */\n    async reload(): Promise<void> {\n        const config = await this.config.reload();\n        await this.hooks.onReload(config);\n    }\n\n    /** 广播协议事件给所有 network 适配器。 */\n    protected broadcastEvent<T>(event: T): void {\n        this.broadcaster?.emit(event);\n    }\n\n    /** 获取广播器（传输装配等内部使用；未传入返回 undefined）。 */\n    protected getBroadcaster(): EventBroadcaster | undefined {\n        return this.broadcaster;\n    }\n}\n","/**\n * 协议配置加载基类：复用 kernel ConfigBase（zod schema 天然满足其校验器接口）。\n */\nimport type { ConfigFormat } from \"@napuketto/kernel\";\nimport { ConfigBase } from \"@napuketto/kernel\";\nimport type { ZodType } from \"zod\";\n\n/** 协议配置基类：zod schema + 文本读写（JSON/TOML，文件路径由装配层传入）。 */\nexport class ProtocolConfig<T> extends ConfigBase<T> {\n    constructor(opts: {\n        path: string;\n        schema: ZodType<T>;\n        defaults: T;\n        /** 内存初值（全局 TOML 分段装配：seed 存在时 load() 直接用它）。 */\n        seed?: T;\n        format?: ConfigFormat;\n    }) {\n        super({\n            path: opts.path,\n            schema: opts.schema,\n            defaults: opts.defaults,\n            seed: opts.seed,\n            format: opts.format,\n        });\n    }\n}\n"],"mappings":"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"}

package/dist/index-C1nIfPiU.d.mts

@@ -0,0 +1,109 @@
+import { ConfigBase, ConfigFormat, KernelErrorCode } from "@napuketto/kernel";
+import { ZodType } from "zod";
+import { EventBroadcaster } from "@napuketto/network";
+//#region src/core/BaseAction.d.ts
+/** 动作执行结果（含 retcode，协议错误码由协议层映射表提供）。 */
+interface ActionResult<T> {
+  retcode: number;
+  status: string;
+  data: T | null;
+  message: string;
+  echo?: unknown;
+}
+/** 协议错误码映射表：KernelErrorCode → 协议错误码（各协议各自实现，ADR-017）。 */
+type ErrorCodeMap = Record<KernelErrorCode, number>;
+/** 动作基类：校验失败 retcode=400（HTTP）/1400（WS）。 */
+declare abstract class BaseAction<TPayload, TReturn> {
+  abstract readonly name: string;
+  abstract readonly schema: ZodType<TPayload>;
+  protected abstract readonly errorCodeMap: ErrorCodeMap;
+  /** 校验并执行（HTTP 入口）。 */
+  handle(payload: unknown): Promise<ActionResult<TReturn>>;
+  /** 校验并执行（WS 入口，echo 透传）。 */
+  websocketHandle(payload: unknown, echo?: unknown): Promise<ActionResult<TReturn>>;
+  private run;
+  protected abstract _handle(payload: TPayload): Promise<TReturn>;
+  private mapError;
+  private fail;
+}
+//#endregion
+//#region src/core/action-registry.d.ts
+declare class ActionRegistry {
+  private readonly actions;
+  register(action: BaseAction<unknown, unknown>): void;
+  get(name: string): BaseAction<unknown, unknown> | undefined;
+  has(name: string): boolean;
+  get names(): string[];
+}
+//#endregion
+//#region src/core/adapter-registry.d.ts
+/**
+ * 适配器注册表：cli 按 enabledProtocols 装配用。
+ */
+/** 协议适配器基类类型（避免 core 与具体协议循环依赖的轻量接口）。 */
+interface ProtocolAdapterLike {
+  readonly protocol: string;
+  start: () => Promise<void>;
+  stop: () => Promise<void>;
+}
+declare class AdapterRegistry {
+  private readonly adapters;
+  register(adapter: ProtocolAdapterLike): void;
+  get(protocol: string): ProtocolAdapterLike | undefined;
+  startAll(): Promise<void>;
+  stopAll(): Promise<void>;
+}
+//#endregion
+//#region src/core/config.d.ts
+/** 协议配置基类：zod schema + 文本读写（JSON/TOML，文件路径由装配层传入）。 */
+declare class ProtocolConfig<T> extends ConfigBase<T> {
+  constructor(opts: {
+    path: string;
+    schema: ZodType<T>;
+    defaults: T;
+    /** 内存初值（全局 TOML 分段装配：seed 存在时 load() 直接用它）。 */
+    seed?: T;
+    format?: ConfigFormat;
+  });
+}
+//#endregion
+//#region src/core/BaseProtocolAdapter.d.ts
+/** 适配器生命周期钩子：由协议层实现（配置校验、初始化、资源清理）。 */
+interface ProtocolHooks {
+  /** 配置校验通过后初始化（如建立 kernel 事件订阅）。 */
+  onStart: (config: unknown) => Promise<void>;
+  /** 停止时清理资源（退订、关闭传输等）。 */
+  onStop: () => Promise<void>;
+  /** 配置热更新。 */
+  onReload: (config: unknown) => Promise<void>;
+}
+/**
+ * 协议适配器骨架。
+ * @typeParam TConfig - 协议配置类型
+ */
+declare abstract class BaseProtocolAdapter<TConfig> {
+  abstract readonly protocol: string;
+  abstract readonly configSchema: ZodType<TConfig>;
+  protected readonly config: ProtocolConfig<TConfig>;
+  protected readonly hooks: ProtocolHooks;
+  private readonly broadcaster;
+  private started;
+  constructor(opts: {
+    config: ProtocolConfig<TConfig>;
+    hooks: ProtocolHooks;
+    broadcaster?: EventBroadcaster;
+  });
+  /** 启动：加载配置 → 校验 → 协议层初始化。 */
+  start(): Promise<void>;
+  /** 停止：协议层清理资源。 */
+  stop(): Promise<void>;
+  /** 配置热更新：重新加载 → 校验 → 协议层处理。 */
+  reload(): Promise<void>;
+  /** 广播协议事件给所有 network 适配器。 */
+  protected broadcastEvent<T>(event: T): void;
+  /** 获取广播器（传输装配等内部使用；未传入返回 undefined）。 */
+  protected getBroadcaster(): EventBroadcaster | undefined;
+}
+//#endregion
+export { ProtocolAdapterLike as a, BaseAction as c, AdapterRegistry as i, ErrorCodeMap as l, ProtocolHooks as n, ActionRegistry as o, ProtocolConfig as r, ActionResult as s, BaseProtocolAdapter as t };
+//# sourceMappingURL=index-C1nIfPiU.d.mts.map

package/dist/index-C1nIfPiU.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-C1nIfPiU.d.mts","names":[],"sources":["../src/core/BaseAction.ts","../src/core/action-registry.ts","../src/core/adapter-registry.ts","../src/core/config.ts","../src/core/BaseProtocolAdapter.ts"],"mappings":";;;;;UAgBiB,aAAa;EAC1B;EACA;EACA,MAAM;EACN;EACA;;;KAIQ,eAAe,OAAO;;uBAGZ,WAAW,UAAU;oBACrB;oBACA,QAAQ,QAAQ;8BACN,cAAc;;EAG1C,OAAO,mBAAmB,QAAQ,aAAa;;EAKzC,gBAAgB,kBAAkB,iBAAiB,QAAQ,aAAa;UAQhE;qBAaK,QAAQ,SAAS,WAAW,QAAQ;UAE/C;UAaA;;;;cCtEC;mBACQ;EAEjB,SAAS,QAAQ;EAIjB,IAAI,eAAe;EAInB,IAAI;MAIA;;;;;;;;UCfS;WACJ;EACT,aAAa;EACb,YAAY;;cAGH;mBACQ;EAEjB,SAAS,SAAS;EAIlB,IAAI,mBAAmB;EAIjB,YAAY;EAIZ,WAAW;;;;;cClBR,eAAe,WAAW,WAAW;EAC9C,YAAY;IACR;IACA,QAAQ,QAAQ;IAChB,UAAU;;IAEV,OAAO;IACP,SAAS;;;;;;UCHA;;EAEb,UAAU,oBAAoB;;EAE9B,cAAc;;EAEd,WAAW,oBAAoB;;;;;;uBAOb,oBAAoB;oBACpB;oBACA,cAAc,QAAQ;qBAErB,QAAQ,eAAe;qBACvB,OAAO;mBACT;UACT;EAER,YAAY;IACR,QAAQ,eAAe;IACvB,OAAO;IACP,cAAc;;;EAQZ,SAAS;;EAUT,QAAQ;;EASR,UAAU;;YAMN,eAAe,GAAG,OAAO;;YAKzB,kBAAkB"}

package/dist/index.d.mts

@@ -0,0 +1,11 @@
+//#region src/index.d.ts
+/**
+ * @napuketto/adapter 入口
+ * 协议适配器容器：core 框架 + onebot11 / satori。
+ * 根入口保持轻量（ADR-014）：只导出公共类型，不聚合三个协议；协议面走子路径（./core、./onebot11 等）。
+ */
+/** 协议标识（多协议共存的装配 key）。 */
+type ProtocolId = "onebot11" | "satori";
+//#endregion
+export { ProtocolId };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;;;KAOY"}

package/dist/index.mjs

@@ -0,0 +1 @@
+export {};