@koishi-ce/plugin-market 1.0.0

package/src/node/locales/message.ja-JP.yml

@@ -0,0 +1,25 @@
+commands.plugin:
+  description: 插件管理
+commands.plugin.install:
+  description: 安装插件
+  messages:
+    expect-name: 请输入插件名。
+    already-installed: 该插件已安装。
+    not-found: 未找到该插件。
+    success: 安装成功！
+commands.plugin.uninstall:
+  description: 卸载插件
+  messages:
+    expect-name: 请输入插件名。
+    not-installed: 该插件未安装。
+    success: 卸载成功！
+commands.plugin.upgrade:
+  description: 升级插件
+  options:
+    self: 升级 Koishi 本体
+  messages:
+    all-updated: 所有插件已是最新版本。
+    available: 有可用的依赖更新：
+    prompt: 输入「Y」升级全部依赖，输入「N」取消操作。
+    cancelled: 已取消操作。
+    success: 升级成功！

package/src/node/locales/message.ru-RU.yml

@@ -0,0 +1,25 @@
+commands.plugin:
+  description: 插件管理
+commands.plugin.install:
+  description: 安装插件
+  messages:
+    expect-name: 请输入插件名。
+    already-installed: 该插件已安装。
+    not-found: 未找到该插件。
+    success: 安装成功！
+commands.plugin.uninstall:
+  description: 卸载插件
+  messages:
+    expect-name: 请输入插件名。
+    not-installed: 该插件未安装。
+    success: 卸载成功！
+commands.plugin.upgrade:
+  description: 升级插件
+  options:
+    self: 升级 Koishi 本体
+  messages:
+    all-updated: 所有插件已是最新版本。
+    available: 有可用的依赖更新：
+    prompt: 输入「Y」升级全部依赖，输入「N」取消操作。
+    cancelled: 已取消操作。
+    success: 升级成功！

package/src/node/locales/message.zh-CN.yml

@@ -0,0 +1,28 @@
+commands.plugin:
+  description: 插件管理
+
+commands.plugin.install:
+  description: 安装插件
+  messages:
+    expect-name: 请输入插件名。
+    already-installed: 该插件已安装。
+    not-found: 未找到该插件。
+    success: 安装成功！
+
+commands.plugin.uninstall:
+  description: 卸载插件
+  messages:
+    expect-name: 请输入插件名。
+    not-installed: 该插件未安装。
+    success: 卸载成功！
+
+commands.plugin.upgrade:
+  description: 升级插件
+  options:
+    self: 升级 Koishi 本体
+  messages:
+    all-updated: 所有插件已是最新版本。
+    available: 有可用的依赖更新：
+    prompt: 输入「Y」升级全部依赖，输入「N」取消操作。
+    cancelled: 已取消操作。
+    success: 升级成功！

package/src/node/locales/message.zh-TW.yml

@@ -0,0 +1,25 @@
+commands.plugin:
+  description: 外掛程式管理
+commands.plugin.install:
+  description: 安裝外掛程式
+  messages:
+    expect-name: 请输入外掛程式名。
+    already-installed: 該外掛程式已安裝。
+    not-found: 未找到該外掛程式。
+    success: 安裝成功！
+commands.plugin.uninstall:
+  description: 卸載外掛程式
+  messages:
+    expect-name: 请输入外掛程式名。
+    not-installed: 該外掛程式未安裝。
+    success: 卸載成功！
+commands.plugin.upgrade:
+  description: 升級外掛程式
+  options:
+    self: 升級 Koishi 本體
+  messages:
+    all-updated: 所有外掛程式已是最新版本。
+    available: 有可用的依賴更新：
+    prompt: 輸入「Y」升級全部依賴，輸入「N」取消操作。
+    cancelled: 已取消操作。
+    success: 升級成功！

package/src/node/locales/schema.de-DE.yml

@@ -0,0 +1,9 @@
+registry:
+  $description: 插件源设置
+  endpoint: 插件的下载源。默认跟随当前项目的 npm config。
+  timeout: 获取插件数据的超时时间。
+search:
+  $description: 搜索设置
+  endpoint: 用于搜索插件市场的网址。默认跟随插件源设置。
+  timeout: 搜索插件市场的超时时间。
+  proxyAgent: 用于搜索插件市场的代理。

package/src/node/locales/schema.en-US.yml

@@ -0,0 +1,9 @@
+registry:
+  $description: 插件源设置
+  endpoint: 插件的下载源。默认跟随当前项目的 npm config。
+  timeout: 获取插件数据的超时时间。
+search:
+  $description: 搜索设置
+  endpoint: 用于搜索插件市场的网址。默认跟随插件源设置。
+  timeout: 搜索插件市场的超时时间。
+  proxyAgent: 用于搜索插件市场的代理。

package/src/node/locales/schema.fr-FR.yml

@@ -0,0 +1,9 @@
+registry:
+  $description: 插件源设置
+  endpoint: 插件的下载源。默认跟随当前项目的 npm config。
+  timeout: 获取插件数据的超时时间。
+search:
+  $description: 搜索设置
+  endpoint: 用于搜索插件市场的网址。默认跟随插件源设置。
+  timeout: 搜索插件市场的超时时间。
+  proxyAgent: 用于搜索插件市场的代理。

package/src/node/locales/schema.ja-JP.yml

@@ -0,0 +1,9 @@
+registry:
+  $description: 插件源设置
+  endpoint: 插件的下载源。默认跟随当前项目的 npm config。
+  timeout: 获取插件数据的超时时间。
+search:
+  $description: 搜索设置
+  endpoint: 用于搜索插件市场的网址。默认跟随插件源设置。
+  timeout: 搜索插件市场的超时时间。
+  proxyAgent: 用于搜索插件市场的代理。

package/src/node/locales/schema.ru-RU.yml

@@ -0,0 +1,9 @@
+registry:
+  $description: 插件源设置
+  endpoint: 插件的下载源。默认跟随当前项目的 npm config。
+  timeout: 获取插件数据的超时时间。
+search:
+  $description: 搜索设置
+  endpoint: 用于搜索插件市场的网址。默认跟随插件源设置。
+  timeout: 搜索插件市场的超时时间。
+  proxyAgent: 用于搜索插件市场的代理。

package/src/node/locales/schema.zh-CN.yml

@@ -0,0 +1,10 @@
+registry:
+  $description: 插件源设置
+  endpoint: 插件的下载源。默认跟随当前项目的 npm config。
+  timeout: 获取插件数据的超时时间。
+
+search:
+  $description: 搜索设置
+  endpoint: 用于搜索插件市场的网址。默认跟随插件源设置。
+  timeout: 搜索插件市场的超时时间。
+  proxyAgent: 用于搜索插件市场的代理。

package/src/node/locales/schema.zh-TW.yml

@@ -0,0 +1,9 @@
+registry:
+  $description: 外掛程式源設定
+  endpoint: 外掛程式的下載源。默認跟隨當前項目的 npm config。
+  timeout: 獲取外掛程式數據的超時時間。
+search:
+  $description: 搜尋設定
+  endpoint: 用於搜尋外掛程式市場的網址。默認跟隨外掛程式源設置。
+  timeout: 搜尋外掛程式市場的超時時間。
+  proxyAgent: 用於搜尋外掛程式市場的代理。

package/src/node/market.ts

@@ -0,0 +1,149 @@
+import {
+	type Context,
+	type Dict,
+	type HTTP,
+	Schema,
+	Time,
+} from "@koishi-ce/koishi";
+import Scanner, {
+	type SearchObject,
+	type SearchResult,
+} from "@koishi-ce/registry";
+import { MarketProvider as BaseMarketProvider } from "../shared/index.ts";
+
+class MarketProvider extends BaseMarketProvider {
+	private http?: HTTP;
+	private failed: string[] = [];
+	private scanner!: Scanner;
+	private fullCache: Dict<SearchObject> = {};
+	private tempCache: Dict<SearchObject> = {};
+	private flushData: () => void;
+
+	override config: MarketProvider.Config;
+
+	constructor(ctx: Context, config: MarketProvider.Config) {
+		super(ctx);
+		this.config = config;
+		if (config.endpoint) this.http = ctx.http.extend(config);
+		this.flushData = ctx.throttle(() => {
+			ctx.console.broadcast("market/patch", {
+				data: this.tempCache,
+				failed: this.failed.length,
+				total: this.scanner.total,
+				progress: this.scanner.progress,
+			});
+			this.tempCache = {};
+		}, 500);
+	}
+
+	override async start(refresh = false) {
+		this.failed = [];
+		this.fullCache = {};
+		this.tempCache = {};
+		if (refresh) this.ctx.installer.refresh(true);
+		await this.prepare();
+		super.start();
+	}
+
+	override async collect() {
+		const { timeout } = this.config;
+		const registry = this.ctx.installer.http;
+
+		this.failed = [];
+		this.scanner = new Scanner(registry.get);
+		if (this.http) {
+			const result = await this.http.get<SearchResult>("");
+			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;
+		} else {
+			await this.scanner.collect(timeout !== undefined ? { timeout } : {});
+		}
+
+		if (!this.scanner.version) {
+			// npmmirror 的 404 需要静默忽略；origin 精确比对防止
+			// "https://registry.npmmirror.com.evil.io" 之类前缀伪造绕过
+			let isNpmmirror = false;
+			try {
+				isNpmmirror =
+					new URL(registry.config.endpoint ?? "").origin ===
+					"https://registry.npmmirror.com";
+			} catch {
+				// endpoint 缺失或非合法 URL：按非 npmmirror 处理
+			}
+			this.scanner.analyze({
+				version: "4",
+				onFailure: (name, reason) => {
+					this.failed.push(name);
+					if (isNpmmirror) {
+						if (
+							this.ctx.http.isError(reason) &&
+							reason.response?.status === 404
+						) {
+							// ignore 404 error for npmmirror
+						}
+					}
+				},
+				onRegistry: (registry, 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;
+				},
+				after: () => this.flushData(),
+			});
+		}
+
+		return undefined;
+	}
+
+	override async get() {
+		await this.prepare();
+		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]),
+					),
+					failed: 0,
+					total: this.scanner.total,
+					progress: this.scanner.total,
+					gravatar,
+				}
+			: {
+					registry: this.ctx.installer.endpoint,
+					data: this.fullCache,
+					failed: this.failed.length,
+					total: this.scanner.total,
+					progress: this.scanner.progress,
+					gravatar,
+				};
+	}
+
+	// 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"),
+	});
+}
+
+declare namespace MarketProvider {
+	export interface Config {
+		endpoint?: string;
+		timeout?: number;
+	}
+}
+
+export default MarketProvider;

package/src/shared/index.ts

@@ -0,0 +1,73 @@
+import { DataService } from "@koishi-ce/console";
+import {
+	type Awaitable,
+	type Context,
+	type Dict,
+	Logger,
+	Time,
+} from "@koishi-ce/koishi";
+import type { SearchObject, SearchResult } from "@koishi-ce/registry";
+
+declare module "@koishi-ce/console" {
+	interface Events {
+		"market/refresh"(): void;
+	}
+
+	namespace Console {
+		interface Services {
+			market: MarketProvider;
+		}
+	}
+}
+
+const logger = new Logger("market");
+
+export abstract class MarketProvider extends DataService<MarketProvider.Payload> {
+	private _task: Promise<SearchResult | undefined> | null = null;
+	private _timestamp = 0;
+	protected _error: unknown;
+
+	constructor(ctx: Context) {
+		super(ctx, "market", { authority: 4 });
+
+		ctx.console.addListener("market/refresh", () => this.start(true), {
+			authority: 4,
+		});
+
+		ctx.on("console/connection", async (client) => {
+			if (!ctx.console.clients[client.id]) return;
+			if (Date.now() - this._timestamp <= Time.hour * 12) return;
+			if (await this.ctx.serial("console/intercept", client, { authority: 4 }))
+				return;
+			this.start();
+		});
+	}
+
+	override start(_refresh = false): Awaitable<void> {
+		this._task = null;
+		this._error = null;
+		this._timestamp = Date.now();
+		this.refresh();
+	}
+
+	abstract collect(): Promise<SearchResult | undefined>;
+
+	async prepare(): Promise<SearchResult | undefined> {
+		return (this._task ||= this.collect().catch((error: unknown) => {
+			logger.warn(error);
+			this._error = error;
+			return undefined;
+		}));
+	}
+}
+
+export namespace MarketProvider {
+	export interface Payload {
+		registry?: string | undefined;
+		data: Dict<SearchObject>;
+		total: number;
+		failed: number;
+		progress: number;
+		gravatar?: string | undefined;
+	}
+}