@koishi-ce/plugin-market 1.0.9 → 1.0.11

package/src/browser/index.ts

@@ -25,6 +25,11 @@ export function apply(ctx: Context, _config: Config) {
 	ctx.console.addEntry(
 		base
 			? [`${base}/dist/index.js`, `${base}/dist/style.css`]
-			: [import.meta.url.replace(/\/src\/[^/]+\/[^/]+$/, "/client/index.ts")],
+			: [
+					import.meta.url.replace(
+						/\/src\/[^/]+\/[^/]+$/,
+						"/client/index.ts",
+					),
+				],
 	);
 }

package/src/browser/market.ts

@@ -12,10 +12,14 @@ export default class MarketProvider extends BaseMarketProvider {
 
 	override async get() {
 		const market = await this.prepare();
-		if (!market) return { data: {}, failed: 0, total: 0, progress: 0 };
+		if (!market)
+			return { data: {}, failed: 0, total: 0, progress: 0 };
 		return {
 			data: Object.fromEntries(
-				market.objects.map((item) => [item.package.name, item]),
+				market.objects.map((item) => [
+					item.package.name,
+					item,
+				]),
 			),
 			failed: 0,
 			total: market.objects.length,

package/src/node/deps.ts

@@ -4,10 +4,15 @@
 
 import { DataService } from "@koishi-ce/console";
 import type { Context, Dict } from "@koishi-ce/koishi";
-import type { DependencyMetaKey, RemotePackage } from "@koishi-ce/registry";
+import type {
+	DependencyMetaKey,
+	RemotePackage,
+} from "@koishi-ce/registry";
 import type { Dependency } from "./installer.ts";
 
-class DependencyProvider extends DataService<Dict<Dependency>> {
+class DependencyProvider extends DataService<
+	Dict<Dependency>
+> {
 	constructor(ctx: Context) {
 		super(ctx, "dependencies", { authority: 4 });
 	}

package/src/node/index.ts

@@ -3,10 +3,21 @@
 // Copyright (c) 2026-present Koishi-CE contributors.
 
 import { resolve } from "node:path";
-import { type Context, type Dict, pick, Schema } from "@koishi-ce/koishi";
-import type { DependencyMetaKey, RemotePackage } from "@koishi-ce/registry";
+import {
+	type Context,
+	type Dict,
+	pick,
+	Schema,
+} from "@koishi-ce/koishi";
+import type {
+	DependencyMetaKey,
+	RemotePackage,
+} from "@koishi-ce/registry";
 import { gt } from "semver";
-import { DependencyProvider, RegistryProvider } from "./deps.ts";
+import {
+	DependencyProvider,
+	RegistryProvider,
+} from "./deps.ts";
 import Installer from "./installer.ts";
 import messageZhCN from "./locales/message.zh-CN.yml";
 import schemaZhCN from "./locales/schema.zh-CN.yml";
@@ -31,15 +42,25 @@ declare module "@koishi-ce/console" {
 	}
 
 	interface Events {
-		"market/install"(deps: Dict<string>, forced?: boolean): Promise<number>;
+		"market/install"(
+			deps: Dict<string>,
+			forced?: boolean,
+		): Promise<number>;
 		"market/registry"(
 			names: string[],
-		): Promise<Dict<Dict<Pick<RemotePackage, DependencyMetaKey>>>>;
+		): Promise<
+			Dict<Dict<Pick<RemotePackage, DependencyMetaKey>>>
+		>;
 	}
 }
 
 export const name = "market";
-export const inject = ["http"];
+// loader 由宿主以 builtin 服务提供，生产恒存在；测试等裸 App 环境可缺席，
+// 声明为非必需注入以免 cordis 报「property loader is not registered」
+export const inject = {
+	http: { required: true },
+	loader: { required: false },
+};
 
 export const usage = `
 如果插件市场页面提示「无法连接到插件市场」，则可以选择一个 Koishi 社区提供的镜像地址，填入下方对应的配置项中。
@@ -101,12 +122,18 @@ export function apply(ctx: Context, config: Config) {
 					return session.text(".already-installed");
 
 				// find proper version
-				const result = await ctx.installer.findVersion(names);
+				const result =
+					await ctx.installer.findVersion(names);
 				if (!result) return session.text(".not-found");
 
 				// set restart message
 				ctx.loader.envData.message = {
-					...pick(session, ["sid", "channelId", "guildId", "isDirect"]),
+					...pick(session, [
+						"sid",
+						"channelId",
+						"guildId",
+						"isDirect",
+					]),
 					content: session.text(".success"),
 				};
 				await ctx.installer.install(result);
@@ -125,7 +152,8 @@ export function apply(ctx: Context, config: Config) {
 				const names = ctx.installer.resolveName(name);
 				const deps = await ctx.installer.getDeps();
 				const installed = names.find((name) => deps[name]);
-				if (!installed) return session.text(".not-installed");
+				if (!installed)
+					return session.text(".not-installed");
 
 				await ctx.installer.install({ [installed]: null });
 				return session.text(".success");
@@ -145,7 +173,9 @@ export function apply(ctx: Context, config: Config) {
 							const names = ctx.installer.resolveName(name);
 							return names.find((name) => deps[name]);
 						})
-						.filter((name): name is string => name !== undefined);
+						.filter(
+							(name): name is string => name !== undefined,
+						);
 					if (options?.self) resolved.push("koishi");
 					return resolved;
 				}
@@ -154,17 +184,25 @@ export function apply(ctx: Context, config: Config) {
 				ctx.installer.refresh(true);
 				const deps = await ctx.installer.getDeps();
 				names = (
-					await getPackages(names.filter((name): name is string => !!name))
+					await getPackages(
+						names.filter((name): name is string => !!name),
+					)
 				).filter((name) => {
-					const { latest, resolved, invalid } = deps[name] ?? {};
-					if (latest === undefined || resolved === undefined) return false;
+					const { latest, resolved, invalid } =
+						deps[name] ?? {};
+					if (
+						latest === undefined ||
+						resolved === undefined
+					)
+						return false;
 					try {
 						return !invalid && gt(latest, resolved);
 					} catch {
 						return false;
 					}
 				});
-				if (!names.length) return session.text(".all-updated");
+				if (!names.length)
+					return session.text(".all-updated");
 
 				const output = names.map((name) => {
 					const { latest, resolved } = deps[name] ?? {};
@@ -180,15 +218,24 @@ export function apply(ctx: Context, config: Config) {
 				}
 
 				ctx.loader.envData.message = {
-					...pick(session, ["sid", "channelId", "guildId", "isDirect"]),
+					...pick(session, [
+						"sid",
+						"channelId",
+						"guildId",
+						"isDirect",
+					]),
 					content: session.text(".success"),
 				};
 				await ctx.installer.install(
-					names.reduce<Dict<string | null>>((result, name) => {
-						const latest = deps[name]?.latest;
-						if (latest !== undefined) result[name] = latest;
-						return result;
-					}, {}),
+					names.reduce<Dict<string | null>>(
+						(result, name) => {
+							const latest = deps[name]?.latest;
+							if (latest !== undefined)
+								result[name] = latest;
+							return result;
+						},
+						{},
+					),
 				);
 				ctx.loader.envData.message = null;
 				return session.text(".success");
@@ -210,7 +257,10 @@ export function apply(ctx: Context, config: Config) {
 		ctx.console.addListener(
 			"market/install",
 			async (deps, forced) => {
-				const code = await ctx.installer.install(deps, forced);
+				const code = await ctx.installer.install(
+					deps,
+					forced,
+				);
 				ctx.get("console")?.refresh("dependencies");
 				ctx.get("console")?.refresh("registry");
 				ctx.get("console")?.refresh("packages");
@@ -223,7 +273,9 @@ export function apply(ctx: Context, config: Config) {
 			"market/registry",
 			async (names) => {
 				const meta = await Promise.all(
-					names.map((name) => ctx.installer.getPackage(name)),
+					names.map((name) =>
+						ctx.installer.getPackage(name),
+					),
 				);
 				return Object.fromEntries(
 					meta.map((meta, index) => [names[index], meta]),

package/src/node/installer.ts

@@ -44,7 +44,9 @@ const logger = new Logger("market");
  * 两者被覆盖或删除都会让 peer 解析失去归属，重新拉下 npm 官方包形成
  * 第二份框架副本。
  */
-function isGuardedRequest(request: string | undefined): boolean {
+function isGuardedRequest(
+	request: string | undefined,
+): boolean {
 	return (
 		request?.startsWith("workspace:") === true ||
 		request?.startsWith("npm:@koishi-ce") === true
@@ -52,10 +54,16 @@ function isGuardedRequest(request: string | undefined): boolean {
 }
 
 /** 从单个 .npmrc 文件提取 registry 配置项；文件不存在或读取出错一律视为未配置 */
-function readNpmrcRegistry(file: string): string | undefined {
+function readNpmrcRegistry(
+	file: string,
+): string | undefined {
 	try {
-		for (const line of readFileSync(file, "utf8").split(/\r?\n/)) {
-			const matched = /^\s*registry\s*=\s*(\S+)\s*$/.exec(line);
+		for (const line of readFileSync(file, "utf8").split(
+			/\r?\n/,
+		)) {
+			const matched = /^\s*registry\s*=\s*(\S+)\s*$/.exec(
+				line,
+			);
 			const value = matched?.[1];
 			if (value) return value;
 		}
@@ -72,14 +80,20 @@ function readNpmrcRegistry(file: string): string | undefined {
  * 源（对齐被移除的 get-registry 的默认值），保证 http 恒有 endpoint
  * 可拼接相对 URL——缺省时相对请求会在 resolveURL 抛 Invalid URL。
  */
-function getLocalRegistry(cwd: string, userHome: string = homedir()): string {
+function getLocalRegistry(
+	cwd: string,
+	userHome: string = homedir(),
+): string {
 	const candidates = [
 		process.env["npm_config_registry"],
 		readNpmrcRegistry(join(cwd, ".npmrc")),
 		readNpmrcRegistry(join(userHome, ".npmrc")),
 	];
 	for (const candidate of candidates) {
-		if (candidate?.startsWith("https://") || candidate?.startsWith("http://")) {
+		if (
+			candidate?.startsWith("https://") ||
+			candidate?.startsWith("http://")
+		) {
 			return candidate;
 		}
 	}
@@ -116,9 +130,15 @@ function loadManifest(name: string) {
 	// resolvePackageJson 以纯 fs 探测为主路径：市场安装流程在包落盘前的
 	// 探测不能触碰解析 API，否则触发 Bun 的父目录快照缓存（装完即失败）
 	const filename = resolvePackageJson(name);
-	const meta: LocalPackage = JSON.parse(readFileSync(filename, "utf8"));
+	const meta: LocalPackage = JSON.parse(
+		readFileSync(filename, "utf8"),
+	);
 	meta.dependencies ||= {};
-	defineProperty(meta, "$workspace", !filename.includes("node_modules"));
+	defineProperty(
+		meta,
+		"$workspace",
+		!filename.includes("node_modules"),
+	);
 	return meta;
 }
 
@@ -143,8 +163,12 @@ function getVersions(versions: RemotePackage[]) {
 class Installer extends Service {
 	declare http: HTTP;
 	declare endpoint: string | undefined;
-	public fullCache: Dict<Dict<Pick<RemotePackage, DependencyMetaKey>>> = {};
-	public tempCache: Dict<Dict<Pick<RemotePackage, DependencyMetaKey>>> = {};
+	public fullCache: Dict<
+		Dict<Pick<RemotePackage, DependencyMetaKey>>
+	> = {};
+	public tempCache: Dict<
+		Dict<Pick<RemotePackage, DependencyMetaKey>>
+	> = {};
 
 	private pkgTasks: Dict<
 		Promise<Dict<Pick<RemotePackage, DependencyMetaKey>>>
@@ -160,7 +184,9 @@ class Installer extends Service {
 		this.config = config;
 		this.manifest = loadManifest(this.cwd);
 		this.flushData = ctx.throttle(() => {
-			ctx.get("console")?.broadcast("market/registry", this.tempCache);
+			ctx
+				.get("console")
+				?.broadcast("market/registry", this.tempCache);
 			this.tempCache = {};
 		}, 500);
 	}
@@ -185,7 +211,10 @@ class Installer extends Service {
 			const [left, right] = name.split("/");
 			return [`${left}/koishi-plugin-${right}`];
 		} else {
-			return [`@koishijs/plugin-${name}`, `koishi-plugin-${name}`];
+			return [
+				`@koishijs/plugin-${name}`,
+				`koishi-plugin-${name}`,
+			];
 		}
 	}
 
@@ -193,7 +222,9 @@ class Installer extends Service {
 		const entries = await Promise.all(
 			names.map(async (name) => {
 				try {
-					const versions = Object.entries(await this.getPackage(name));
+					const versions = Object.entries(
+						await this.getPackage(name),
+					);
 					const [latest] = versions;
 					if (!latest) return undefined;
 					return { [name]: latest[0] };
@@ -202,19 +233,30 @@ class Installer extends Service {
 				}
 			}),
 		);
-		return entries.find((entry): entry is Dict<string> => entry !== undefined);
+		return entries.find(
+			(entry): entry is Dict<string> => entry !== undefined,
+		);
 	}
 
 	private async _getPackage(name: string) {
 		try {
-			const registry = await this.http.get<Registry>(`/${name}`);
+			const registry = await this.http.get<Registry>(
+				`/${name}`,
+			);
 			const versions = getVersions(
-				Object.values(registry.versions).filter((remote) => {
-					if (name === "koishi") return satisfies(remote.version, "4");
-					return !Scanner.isPlugin(name) || Scanner.isCompatible("4", remote);
-				}),
+				Object.values(registry.versions).filter(
+					(remote) => {
+						if (name === "koishi")
+							return satisfies(remote.version, "4");
+						return (
+							!Scanner.isPlugin(name) ||
+							Scanner.isCompatible("4", remote)
+						);
+					},
+				),
 			);
-			this.fullCache[name] = this.tempCache[name] = versions;
+			this.fullCache[name] = this.tempCache[name] =
+				versions;
 			this.flushData();
 			return versions;
 		} catch (error) {
@@ -224,9 +266,12 @@ class Installer extends Service {
 	}
 
 	setPackage(name: string, versions: RemotePackage[]) {
-		this.fullCache[name] = this.tempCache[name] = getVersions(versions);
+		this.fullCache[name] = this.tempCache[name] =
+			getVersions(versions);
 		this.flushData();
-		this.pkgTasks[name] = Promise.resolve(this.fullCache[name]);
+		this.pkgTasks[name] = Promise.resolve(
+			this.fullCache[name],
+		);
 	}
 
 	getPackage(name: string) {
@@ -234,27 +279,36 @@ class Installer extends Service {
 	}
 
 	private async _getDeps() {
-		const result = valueMap(this.manifest.dependencies, (request) => {
-			return { request: request.replace(/^[~^]/, "") } as Dependency;
-		});
-		await mapLimit(Object.keys(result), 10, async (name) => {
-			const dep = result[name];
-			if (!dep) return;
-			try {
-				// some dependencies may be left with no local installation
-				const meta = loadManifest(name);
-				dep.resolved = meta.version;
-				dep.workspace = meta.$workspace;
-				if (meta.$workspace) return;
-			} catch {}
-
-			if (!valid(dep.request)) {
-				dep.invalid = true;
-			}
+		const result = valueMap(
+			this.manifest.dependencies,
+			(request) => {
+				return {
+					request: request.replace(/^[~^]/, ""),
+				} as Dependency;
+			},
+		);
+		await mapLimit(
+			Object.keys(result),
+			10,
+			async (name) => {
+				const dep = result[name];
+				if (!dep) return;
+				try {
+					// some dependencies may be left with no local installation
+					const meta = loadManifest(name);
+					dep.resolved = meta.version;
+					dep.workspace = meta.$workspace;
+					if (meta.$workspace) return;
+				} catch {}
+
+				if (!valid(dep.request)) {
+					dep.invalid = true;
+				}
 
-			const versions = await this.getPackage(name);
-			if (versions) dep.latest = Object.keys(versions)[0];
-		});
+				const versions = await this.getPackage(name);
+				if (versions) dep.latest = Object.keys(versions)[0];
+			},
+		);
 		return result;
 	}
 
@@ -311,26 +365,35 @@ class Installer extends Service {
 		const filename = resolve(this.cwd, "package.json");
 		// 现读现写：this.manifest 原为构造期的启动快照，运行期间根
 		// package.json 可能已被外部更新，基于快照整体重写会抹掉变更
-		this.manifest = JSON.parse(readFileSync(filename, "utf8")) as LocalPackage;
+		this.manifest = JSON.parse(
+			readFileSync(filename, "utf8"),
+		) as LocalPackage;
 		this.manifest.dependencies ||= {};
 		for (const key in deps) {
 			if (deps[key]) {
-				if (isGuardedRequest(this.manifest.dependencies[key])) {
+				if (
+					isGuardedRequest(this.manifest.dependencies[key])
+				) {
 					continue;
 				}
 				this.manifest.dependencies[key] = deps[key];
-			} else if (!isGuardedRequest(this.manifest.dependencies[key])) {
+			} else if (
+				!isGuardedRequest(this.manifest.dependencies[key])
+			) {
 				delete this.manifest.dependencies[key];
 			}
 		}
 		this.manifest.dependencies = Object.fromEntries(
-			Object.entries(this.manifest.dependencies).sort((a, b) =>
-				a[0].localeCompare(b[0]),
+			Object.entries(this.manifest.dependencies).sort(
+				(a, b) => a[0].localeCompare(b[0]),
 			),
 		);
 		// 仓库格式权威是 biome（tab 缩进），按 tab 写出避免装插件后
 		// package.json 被重排成空格、lint 报格式漂移
-		await Bun.write(filename, `${JSON.stringify(this.manifest, null, "\t")}\n`);
+		await Bun.write(
+			filename,
+			`${JSON.stringify(this.manifest, null, "\t")}\n`,
+		);
 	}
 
 	private _install() {
@@ -353,7 +416,10 @@ class Installer extends Service {
 		});
 	}
 
-	async install(deps: Dict<string | null>, forced?: boolean) {
+	async install(
+		deps: Dict<string | null>,
+		forced?: boolean,
+	) {
 		const localDeps = this._getLocalDeps(deps);
 		await this.override(deps);
 
@@ -365,7 +431,9 @@ class Installer extends Service {
 				local?.workspace ||
 				(request &&
 					local?.resolved &&
-					satisfies(local.resolved, request, { includePrerelease: true }))
+					satisfies(local.resolved, request, {
+						includePrerelease: true,
+					}))
 			)
 				continue;
 			shouldInstall = true;
@@ -386,7 +454,8 @@ class Installer extends Service {
 			if (newDep.resolved === local.resolved) continue;
 			// 版本变化且旧版本仍驻留内存时才需要整进程重载（判定不走
 			// 解析 API，规避 Bun 负缓存，见 isResidentInCache）
-			if (isResidentInCache(name)) this.ctx.loader.fullReload();
+			if (isResidentInCache(name))
+				this.ctx.loader.fullReload();
 		}
 		this.refreshData();
 

package/src/node/market.ts

@@ -41,7 +41,8 @@ class MarketProvider extends BaseMarketProvider {
 	constructor(ctx: Context, config: MarketProvider.Config) {
 		super(ctx);
 		this.config = config;
-		if (config.endpoint) this.http = ctx.http.extend(config);
+		if (config.endpoint)
+			this.http = ctx.http.extend(config);
 		this.flushData = ctx.throttle(() => {
 			ctx.console.broadcast("market/patch", {
 				data: this.tempCache,
@@ -88,7 +89,11 @@ class MarketProvider extends BaseMarketProvider {
 				// 可调用的 HTTP 实例本身），须包一层保持绑定
 				return await http.get<T>(url, config);
 			} catch (error) {
-				if (attempt >= maxRetries || !this.isRetryable(error)) throw error;
+				if (
+					attempt >= maxRetries ||
+					!this.isRetryable(error)
+				)
+					throw error;
 				const retryAfter = Number(
 					error.response?.headers.get("retry-after") ?? "",
 				);
@@ -113,16 +118,25 @@ class MarketProvider extends BaseMarketProvider {
 		const registry = this.ctx.installer.http;
 
 		this.failed = [];
-		this.scanner = new Scanner(<T>(url: string, config?: RequestConfig) =>
-			this.request<T>(registry, url, config),
+		this.scanner = new Scanner(
+			<T>(url: string, config?: RequestConfig) =>
+				this.request<T>(registry, url, config),
 		);
 		if (this.http) {
-			const result = await this.request<SearchResult>(this.http, "");
-			this.scanner.objects = result.objects.filter((object) => !object.ignored);
+			const result = await this.request<SearchResult>(
+				this.http,
+				"",
+			);
+			this.scanner.objects = result.objects.filter(
+				(object) => !object.ignored,
+			);
 			this.scanner.total = this.scanner.objects.length;
-			if (result.version !== undefined) this.scanner.version = result.version;
+			if (result.version !== undefined)
+				this.scanner.version = result.version;
 		} else {
-			await this.scanner.collect(timeout !== undefined ? { timeout } : {});
+			await this.scanner.collect(
+				timeout !== undefined ? { timeout } : {},
+			);
 		}
 
 		if (!this.scanner.version) {
@@ -150,16 +164,18 @@ class MarketProvider extends BaseMarketProvider {
 					}
 				},
 				onRegistry: (registry, versions) => {
-					this.ctx.installer.setPackage(registry.name, versions);
+					this.ctx.installer.setPackage(
+						registry.name,
+						versions,
+					);
 				},
 				onSuccess: (object, _versions) => {
 					// npmmirror lacks `links` field
 					object.package.links ||= {
 						npm: `${registry.config.endpoint?.replace("registry.", "www.") ?? ""}/package/${object.package.name}`,
 					};
-					this.fullCache[object.package.name] = this.tempCache[
-						object.package.name
-					] = object;
+					this.fullCache[object.package.name] =
+						this.tempCache[object.package.name] = object;
 				},
 				after: () => this.flushData(),
 			});
@@ -170,13 +186,17 @@ class MarketProvider extends BaseMarketProvider {
 
 	override async get() {
 		await this.prepare();
-		if (this._error) return { data: {}, failed: 0, total: 0, progress: 0 };
+		if (this._error)
+			return { data: {}, failed: 0, total: 0, progress: 0 };
 		const gravatar = process.env["GRAVATAR_MIRROR"];
 		return this.scanner.version
 			? {
 					registry: this.ctx.installer.endpoint,
 					data: Object.fromEntries(
-						this.scanner.objects.map((item) => [item.package.name, item]),
+						this.scanner.objects.map((item) => [
+							item.package.name,
+							item,
+						]),
 					),
 					failed: 0,
 					total: this.scanner.total,
@@ -195,13 +215,14 @@ class MarketProvider extends BaseMarketProvider {
 
 	// erasableSyntaxOnly 禁止含运行时值的 namespace，
 	// 原 namespace 内的 Config 常量移到此处的静态字段，对外形状不变
-	static Config: Schema<MarketProvider.Config> = Schema.object({
-		endpoint: Schema.string().role("link"),
-		timeout: Schema.number()
-			.role("time")
-			.default(Time.second * 30),
-		proxyAgent: Schema.string().role("link"),
-	});
+	static Config: Schema<MarketProvider.Config> =
+		Schema.object({
+			endpoint: Schema.string().role("link"),
+			timeout: Schema.number()
+				.role("time")
+				.default(Time.second * 30),
+			proxyAgent: Schema.string().role("link"),
+		});
 }
 
 declare namespace MarketProvider {

package/src/node/proc.ts

@@ -17,9 +17,15 @@
  * 不真正拉起安装进程（此前 mock execa 包名，全局替换同样可行，
  * 但本地模块拦截范围更小、不受其它包使用 child_process 的干扰）。
  */
-import { type ChildProcess, spawn } from "node:child_process";
+import {
+	type ChildProcess,
+	spawn,
+} from "node:child_process";
 
 /** 在指定工作目录启动 bun 子进程（args 已含子命令与参数），stdio 三路 pipe。 */
-export function spawnBun(args: string[], cwd: string): ChildProcess {
+export function spawnBun(
+	args: string[],
+	cwd: string,
+): ChildProcess {
 	return spawn(process.execPath, args, { cwd });
 }