@oj-module/cli 0.2.5 → 0.2.8

package/templates/web/src/_platform/__client/api.schemas.ts

@@ -4,5 +4,102 @@
 import { z } from "@oj-module/runtime";
 
 export const schemas = {
+	"platformMarketInstallPost": {
+		body: z.object({
+	"source": z.enum(["cdn", "file"]),
+	"name": z.string(),
+	"version": z.string().nullable().optional()
+}),
+		data: z.object({
+	"task_id": z.string().optional()
+}).catchall(z.unknown()),
+	},
+	"platformMarketInstallCancelPost": {
+		body: z.object({
+	"name": z.string()
+}),
+		data: z.object({
+	"ok": z.boolean().optional(),
+	"name": z.string().optional(),
+	"requested": z.boolean().optional()
+}).catchall(z.unknown()),
+	},
+	"platformMarketTaskGet": {
+		query: z.object({
+	"id": z.string()
+}),
+		data: z.object({
 
+}).catchall(z.unknown()),
+	},
+	"platformMarketEnablePost": {
+		body: z.object({
+	"name": z.string(),
+	"enabled": z.boolean()
+}),
+		data: z.object({
+
+}).catchall(z.unknown()),
+	},
+	"platformMarketMetaGet": {
+		data: z.object({
+	"apiVersion": z.string().optional()
+}).catchall(z.unknown()),
+	},
+	"platformMarketTrustGet": {
+		data: z.object({
+
+}).catchall(z.unknown()),
+	},
+	"platformMarketTrustPost": {
+		body: z.object({
+	"task_id": z.string()
+}),
+		data: z.object({
+
+}).catchall(z.unknown()),
+	},
+	"platformMarketTrustKeyPost": {
+		body: z.object({
+	"key_id": z.string(),
+	"public_key": z.string()
+}),
+		data: z.object({
+
+}).catchall(z.unknown()),
+	},
+	"platformMarketTrustKeyDelete": {
+		query: z.object({
+	"key_id": z.string()
+}),
+		data: z.object({
+
+}).catchall(z.unknown()),
+	},
+	"platformMarketIndexGet": {
+		data: z.array(z.object({
+
+}).catchall(z.unknown())),
+	},
+	"platformMarketUninstallImpactGet": {
+		query: z.object({
+	"name": z.string()
+}),
+		data: z.object({
+
+}).catchall(z.unknown()),
+	},
+	"platformMarketUninstallPost": {
+		body: z.object({
+	"name": z.string()
+}),
+		data: z.object({
+
+}).catchall(z.unknown()),
+	},
+	"platformMarketHistoryGet": {
+		data: z.array(z.object({
+
+}).catchall(z.unknown())),
+	},
 };

package/templates/web/src/_platform/__client/api.ts

@@ -94,14 +94,23 @@ export async function platformContactsDetailGet(): Promise<unknown> {
 	}
 }
 
-export async function platformMarketInstallPost(): Promise<unknown> {
+export type PlatformMarketInstallPostBody = z.input<(typeof schemas)["platformMarketInstallPost"]["body"]>;
+export type PlatformMarketInstallPostData = z.infer<(typeof schemas)["platformMarketInstallPost"]["data"]>;
+
+export async function platformMarketInstallPost(body: PlatformMarketInstallPostBody): Promise<PlatformMarketInstallPostData> {
 	const client = ensureReq();
 	try {
-		const env = await client.post(`_platform/market/install`).json<OjEnvelope<unknown>>();
+		const env = await client.post(`_platform/market/install`, { json: body }).json<OjEnvelope<PlatformMarketInstallPostData>>();
 		// 2xx + code!==0 也是业务错误（§6.2 通道 a）：oj 不会这么发，但契约机制的价值恰是防漂移
 		if (typeof env.code === "number" && env.code !== 0)
 			throw new ContractApiError(env.code, env.msg ?? "业务错误（信封 code 非 0）");
-		const data = env.data as unknown;
+		const data = env.data as PlatformMarketInstallPostData;
+		if (import.meta.env.DEV) {
+			const { schemas } = await import("./api.schemas");
+			const r = schemas["platformMarketInstallPost"].data.safeParse(data);
+			if (!r.success)
+				throw new ContractApiError(-1, `[契约违例] platformMarketInstallPost 响应与契约不符：${r.error.issues.map(i => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ")}`);
+		}
 		return data;
 	}
 	catch (e) {
@@ -109,14 +118,23 @@ export async function platformMarketInstallPost(): Promise<unknown> {
 	}
 }
 
-export async function platformMarketInstallCancelPost(): Promise<unknown> {
+export type PlatformMarketInstallCancelPostBody = z.input<(typeof schemas)["platformMarketInstallCancelPost"]["body"]>;
+export type PlatformMarketInstallCancelPostData = z.infer<(typeof schemas)["platformMarketInstallCancelPost"]["data"]>;
+
+export async function platformMarketInstallCancelPost(body: PlatformMarketInstallCancelPostBody): Promise<PlatformMarketInstallCancelPostData> {
 	const client = ensureReq();
 	try {
-		const env = await client.post(`_platform/market/install/cancel`).json<OjEnvelope<unknown>>();
+		const env = await client.post(`_platform/market/install/cancel`, { json: body }).json<OjEnvelope<PlatformMarketInstallCancelPostData>>();
 		// 2xx + code!==0 也是业务错误（§6.2 通道 a）：oj 不会这么发，但契约机制的价值恰是防漂移
 		if (typeof env.code === "number" && env.code !== 0)
 			throw new ContractApiError(env.code, env.msg ?? "业务错误（信封 code 非 0）");
-		const data = env.data as unknown;
+		const data = env.data as PlatformMarketInstallCancelPostData;
+		if (import.meta.env.DEV) {
+			const { schemas } = await import("./api.schemas");
+			const r = schemas["platformMarketInstallCancelPost"].data.safeParse(data);
+			if (!r.success)
+				throw new ContractApiError(-1, `[契约违例] platformMarketInstallCancelPost 响应与契约不符：${r.error.issues.map(i => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ")}`);
+		}
 		return data;
 	}
 	catch (e) {
@@ -124,14 +142,23 @@ export async function platformMarketInstallCancelPost(): Promise<unknown> {
 	}
 }
 
-export async function platformMarketTaskGet(): Promise<unknown> {
+export type PlatformMarketTaskGetQuery = z.input<(typeof schemas)["platformMarketTaskGet"]["query"]>;
+export type PlatformMarketTaskGetData = z.infer<(typeof schemas)["platformMarketTaskGet"]["data"]>;
+
+export async function platformMarketTaskGet(query: PlatformMarketTaskGetQuery): Promise<PlatformMarketTaskGetData> {
 	const client = ensureReq();
 	try {
-		const env = await client.get(`_platform/market/task`).json<OjEnvelope<unknown>>();
+		const env = await client.get(`_platform/market/task`, { searchParams: query as Record<string, string | number | boolean> }).json<OjEnvelope<PlatformMarketTaskGetData>>();
 		// 2xx + code!==0 也是业务错误（§6.2 通道 a）：oj 不会这么发，但契约机制的价值恰是防漂移
 		if (typeof env.code === "number" && env.code !== 0)
 			throw new ContractApiError(env.code, env.msg ?? "业务错误（信封 code 非 0）");
-		const data = env.data as unknown;
+		const data = env.data as PlatformMarketTaskGetData;
+		if (import.meta.env.DEV) {
+			const { schemas } = await import("./api.schemas");
+			const r = schemas["platformMarketTaskGet"].data.safeParse(data);
+			if (!r.success)
+				throw new ContractApiError(-1, `[契约违例] platformMarketTaskGet 响应与契约不符：${r.error.issues.map(i => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ")}`);
+		}
 		return data;
 	}
 	catch (e) {
@@ -139,14 +166,23 @@ export async function platformMarketTaskGet(): Promise<unknown> {
 	}
 }
 
-export async function platformMarketEnablePost(): Promise<unknown> {
+export type PlatformMarketEnablePostBody = z.input<(typeof schemas)["platformMarketEnablePost"]["body"]>;
+export type PlatformMarketEnablePostData = z.infer<(typeof schemas)["platformMarketEnablePost"]["data"]>;
+
+export async function platformMarketEnablePost(body: PlatformMarketEnablePostBody): Promise<PlatformMarketEnablePostData> {
 	const client = ensureReq();
 	try {
-		const env = await client.post(`_platform/market/enable`).json<OjEnvelope<unknown>>();
+		const env = await client.post(`_platform/market/enable`, { json: body }).json<OjEnvelope<PlatformMarketEnablePostData>>();
 		// 2xx + code!==0 也是业务错误（§6.2 通道 a）：oj 不会这么发，但契约机制的价值恰是防漂移
 		if (typeof env.code === "number" && env.code !== 0)
 			throw new ContractApiError(env.code, env.msg ?? "业务错误（信封 code 非 0）");
-		const data = env.data as unknown;
+		const data = env.data as PlatformMarketEnablePostData;
+		if (import.meta.env.DEV) {
+			const { schemas } = await import("./api.schemas");
+			const r = schemas["platformMarketEnablePost"].data.safeParse(data);
+			if (!r.success)
+				throw new ContractApiError(-1, `[契约违例] platformMarketEnablePost 响应与契约不符：${r.error.issues.map(i => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ")}`);
+		}
 		return data;
 	}
 	catch (e) {
@@ -154,14 +190,22 @@ export async function platformMarketEnablePost(): Promise<unknown> {
 	}
 }
 
-export async function platformMarketMetaGet(): Promise<unknown> {
+export type PlatformMarketMetaGetData = z.infer<(typeof schemas)["platformMarketMetaGet"]["data"]>;
+
+export async function platformMarketMetaGet(): Promise<PlatformMarketMetaGetData> {
 	const client = ensureReq();
 	try {
-		const env = await client.get(`_platform/market/meta`).json<OjEnvelope<unknown>>();
+		const env = await client.get(`_platform/market/meta`).json<OjEnvelope<PlatformMarketMetaGetData>>();
 		// 2xx + code!==0 也是业务错误（§6.2 通道 a）：oj 不会这么发，但契约机制的价值恰是防漂移
 		if (typeof env.code === "number" && env.code !== 0)
 			throw new ContractApiError(env.code, env.msg ?? "业务错误（信封 code 非 0）");
-		const data = env.data as unknown;
+		const data = env.data as PlatformMarketMetaGetData;
+		if (import.meta.env.DEV) {
+			const { schemas } = await import("./api.schemas");
+			const r = schemas["platformMarketMetaGet"].data.safeParse(data);
+			if (!r.success)
+				throw new ContractApiError(-1, `[契约违例] platformMarketMetaGet 响应与契约不符：${r.error.issues.map(i => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ")}`);
+		}
 		return data;
 	}
 	catch (e) {
@@ -169,14 +213,22 @@ export async function platformMarketMetaGet(): Promise<unknown> {
 	}
 }
 
-export async function platformMarketTrustGet(): Promise<unknown> {
+export type PlatformMarketTrustGetData = z.infer<(typeof schemas)["platformMarketTrustGet"]["data"]>;
+
+export async function platformMarketTrustGet(): Promise<PlatformMarketTrustGetData> {
 	const client = ensureReq();
 	try {
-		const env = await client.get(`_platform/market/trust`).json<OjEnvelope<unknown>>();
+		const env = await client.get(`_platform/market/trust`).json<OjEnvelope<PlatformMarketTrustGetData>>();
 		// 2xx + code!==0 也是业务错误（§6.2 通道 a）：oj 不会这么发，但契约机制的价值恰是防漂移
 		if (typeof env.code === "number" && env.code !== 0)
 			throw new ContractApiError(env.code, env.msg ?? "业务错误（信封 code 非 0）");
-		const data = env.data as unknown;
+		const data = env.data as PlatformMarketTrustGetData;
+		if (import.meta.env.DEV) {
+			const { schemas } = await import("./api.schemas");
+			const r = schemas["platformMarketTrustGet"].data.safeParse(data);
+			if (!r.success)
+				throw new ContractApiError(-1, `[契约违例] platformMarketTrustGet 响应与契约不符：${r.error.issues.map(i => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ")}`);
+		}
 		return data;
 	}
 	catch (e) {
@@ -184,14 +236,23 @@ export async function platformMarketTrustGet(): Promise<unknown> {
 	}
 }
 
-export async function platformMarketTrustPost(): Promise<unknown> {
+export type PlatformMarketTrustPostBody = z.input<(typeof schemas)["platformMarketTrustPost"]["body"]>;
+export type PlatformMarketTrustPostData = z.infer<(typeof schemas)["platformMarketTrustPost"]["data"]>;
+
+export async function platformMarketTrustPost(body: PlatformMarketTrustPostBody): Promise<PlatformMarketTrustPostData> {
 	const client = ensureReq();
 	try {
-		const env = await client.post(`_platform/market/trust`).json<OjEnvelope<unknown>>();
+		const env = await client.post(`_platform/market/trust`, { json: body }).json<OjEnvelope<PlatformMarketTrustPostData>>();
 		// 2xx + code!==0 也是业务错误（§6.2 通道 a）：oj 不会这么发，但契约机制的价值恰是防漂移
 		if (typeof env.code === "number" && env.code !== 0)
 			throw new ContractApiError(env.code, env.msg ?? "业务错误（信封 code 非 0）");
-		const data = env.data as unknown;
+		const data = env.data as PlatformMarketTrustPostData;
+		if (import.meta.env.DEV) {
+			const { schemas } = await import("./api.schemas");
+			const r = schemas["platformMarketTrustPost"].data.safeParse(data);
+			if (!r.success)
+				throw new ContractApiError(-1, `[契约违例] platformMarketTrustPost 响应与契约不符：${r.error.issues.map(i => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ")}`);
+		}
 		return data;
 	}
 	catch (e) {
@@ -199,14 +260,23 @@ export async function platformMarketTrustPost(): Promise<unknown> {
 	}
 }
 
-export async function platformMarketTrustKeyPost(): Promise<unknown> {
+export type PlatformMarketTrustKeyPostBody = z.input<(typeof schemas)["platformMarketTrustKeyPost"]["body"]>;
+export type PlatformMarketTrustKeyPostData = z.infer<(typeof schemas)["platformMarketTrustKeyPost"]["data"]>;
+
+export async function platformMarketTrustKeyPost(body: PlatformMarketTrustKeyPostBody): Promise<PlatformMarketTrustKeyPostData> {
 	const client = ensureReq();
 	try {
-		const env = await client.post(`_platform/market/trust/key`).json<OjEnvelope<unknown>>();
+		const env = await client.post(`_platform/market/trust/key`, { json: body }).json<OjEnvelope<PlatformMarketTrustKeyPostData>>();
 		// 2xx + code!==0 也是业务错误（§6.2 通道 a）：oj 不会这么发，但契约机制的价值恰是防漂移
 		if (typeof env.code === "number" && env.code !== 0)
 			throw new ContractApiError(env.code, env.msg ?? "业务错误（信封 code 非 0）");
-		const data = env.data as unknown;
+		const data = env.data as PlatformMarketTrustKeyPostData;
+		if (import.meta.env.DEV) {
+			const { schemas } = await import("./api.schemas");
+			const r = schemas["platformMarketTrustKeyPost"].data.safeParse(data);
+			if (!r.success)
+				throw new ContractApiError(-1, `[契约违例] platformMarketTrustKeyPost 响应与契约不符：${r.error.issues.map(i => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ")}`);
+		}
 		return data;
 	}
 	catch (e) {
@@ -214,14 +284,23 @@ export async function platformMarketTrustKeyPost(): Promise<unknown> {
 	}
 }
 
-export async function platformMarketTrustKeyDelete(): Promise<unknown> {
+export type PlatformMarketTrustKeyDeleteQuery = z.input<(typeof schemas)["platformMarketTrustKeyDelete"]["query"]>;
+export type PlatformMarketTrustKeyDeleteData = z.infer<(typeof schemas)["platformMarketTrustKeyDelete"]["data"]>;
+
+export async function platformMarketTrustKeyDelete(query: PlatformMarketTrustKeyDeleteQuery): Promise<PlatformMarketTrustKeyDeleteData> {
 	const client = ensureReq();
 	try {
-		const env = await client.delete(`_platform/market/trust/key`).json<OjEnvelope<unknown>>();
+		const env = await client.delete(`_platform/market/trust/key`, { searchParams: query as Record<string, string | number | boolean> }).json<OjEnvelope<PlatformMarketTrustKeyDeleteData>>();
 		// 2xx + code!==0 也是业务错误（§6.2 通道 a）：oj 不会这么发，但契约机制的价值恰是防漂移
 		if (typeof env.code === "number" && env.code !== 0)
 			throw new ContractApiError(env.code, env.msg ?? "业务错误（信封 code 非 0）");
-		const data = env.data as unknown;
+		const data = env.data as PlatformMarketTrustKeyDeleteData;
+		if (import.meta.env.DEV) {
+			const { schemas } = await import("./api.schemas");
+			const r = schemas["platformMarketTrustKeyDelete"].data.safeParse(data);
+			if (!r.success)
+				throw new ContractApiError(-1, `[契约违例] platformMarketTrustKeyDelete 响应与契约不符：${r.error.issues.map(i => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ")}`);
+		}
 		return data;
 	}
 	catch (e) {
@@ -229,14 +308,22 @@ export async function platformMarketTrustKeyDelete(): Promise<unknown> {
 	}
 }
 
-export async function platformMarketIndexGet(): Promise<unknown> {
+export type PlatformMarketIndexGetData = z.infer<(typeof schemas)["platformMarketIndexGet"]["data"]>;
+
+export async function platformMarketIndexGet(): Promise<PlatformMarketIndexGetData> {
 	const client = ensureReq();
 	try {
-		const env = await client.get(`_platform/market/index`).json<OjEnvelope<unknown>>();
+		const env = await client.get(`_platform/market/index`).json<OjEnvelope<PlatformMarketIndexGetData>>();
 		// 2xx + code!==0 也是业务错误（§6.2 通道 a）：oj 不会这么发，但契约机制的价值恰是防漂移
 		if (typeof env.code === "number" && env.code !== 0)
 			throw new ContractApiError(env.code, env.msg ?? "业务错误（信封 code 非 0）");
-		const data = env.data as unknown;
+		const data = env.data as PlatformMarketIndexGetData;
+		if (import.meta.env.DEV) {
+			const { schemas } = await import("./api.schemas");
+			const r = schemas["platformMarketIndexGet"].data.safeParse(data);
+			if (!r.success)
+				throw new ContractApiError(-1, `[契约违例] platformMarketIndexGet 响应与契约不符：${r.error.issues.map(i => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ")}`);
+		}
 		return data;
 	}
 	catch (e) {
@@ -244,14 +331,23 @@ export async function platformMarketIndexGet(): Promise<unknown> {
 	}
 }
 
-export async function platformMarketUninstallImpactGet(): Promise<unknown> {
+export type PlatformMarketUninstallImpactGetQuery = z.input<(typeof schemas)["platformMarketUninstallImpactGet"]["query"]>;
+export type PlatformMarketUninstallImpactGetData = z.infer<(typeof schemas)["platformMarketUninstallImpactGet"]["data"]>;
+
+export async function platformMarketUninstallImpactGet(query: PlatformMarketUninstallImpactGetQuery): Promise<PlatformMarketUninstallImpactGetData> {
 	const client = ensureReq();
 	try {
-		const env = await client.get(`_platform/market/uninstall-impact`).json<OjEnvelope<unknown>>();
+		const env = await client.get(`_platform/market/uninstall-impact`, { searchParams: query as Record<string, string | number | boolean> }).json<OjEnvelope<PlatformMarketUninstallImpactGetData>>();
 		// 2xx + code!==0 也是业务错误（§6.2 通道 a）：oj 不会这么发，但契约机制的价值恰是防漂移
 		if (typeof env.code === "number" && env.code !== 0)
 			throw new ContractApiError(env.code, env.msg ?? "业务错误（信封 code 非 0）");
-		const data = env.data as unknown;
+		const data = env.data as PlatformMarketUninstallImpactGetData;
+		if (import.meta.env.DEV) {
+			const { schemas } = await import("./api.schemas");
+			const r = schemas["platformMarketUninstallImpactGet"].data.safeParse(data);
+			if (!r.success)
+				throw new ContractApiError(-1, `[契约违例] platformMarketUninstallImpactGet 响应与契约不符：${r.error.issues.map(i => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ")}`);
+		}
 		return data;
 	}
 	catch (e) {
@@ -259,14 +355,23 @@ export async function platformMarketUninstallImpactGet(): Promise<unknown> {
 	}
 }
 
-export async function platformMarketUninstallPost(): Promise<unknown> {
+export type PlatformMarketUninstallPostBody = z.input<(typeof schemas)["platformMarketUninstallPost"]["body"]>;
+export type PlatformMarketUninstallPostData = z.infer<(typeof schemas)["platformMarketUninstallPost"]["data"]>;
+
+export async function platformMarketUninstallPost(body: PlatformMarketUninstallPostBody): Promise<PlatformMarketUninstallPostData> {
 	const client = ensureReq();
 	try {
-		const env = await client.post(`_platform/market/uninstall`).json<OjEnvelope<unknown>>();
+		const env = await client.post(`_platform/market/uninstall`, { json: body }).json<OjEnvelope<PlatformMarketUninstallPostData>>();
 		// 2xx + code!==0 也是业务错误（§6.2 通道 a）：oj 不会这么发，但契约机制的价值恰是防漂移
 		if (typeof env.code === "number" && env.code !== 0)
 			throw new ContractApiError(env.code, env.msg ?? "业务错误（信封 code 非 0）");
-		const data = env.data as unknown;
+		const data = env.data as PlatformMarketUninstallPostData;
+		if (import.meta.env.DEV) {
+			const { schemas } = await import("./api.schemas");
+			const r = schemas["platformMarketUninstallPost"].data.safeParse(data);
+			if (!r.success)
+				throw new ContractApiError(-1, `[契约违例] platformMarketUninstallPost 响应与契约不符：${r.error.issues.map(i => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ")}`);
+		}
 		return data;
 	}
 	catch (e) {
@@ -274,14 +379,22 @@ export async function platformMarketUninstallPost(): Promise<unknown> {
 	}
 }
 
-export async function platformMarketHistoryGet(): Promise<unknown> {
+export type PlatformMarketHistoryGetData = z.infer<(typeof schemas)["platformMarketHistoryGet"]["data"]>;
+
+export async function platformMarketHistoryGet(): Promise<PlatformMarketHistoryGetData> {
 	const client = ensureReq();
 	try {
-		const env = await client.get(`_platform/market/history`).json<OjEnvelope<unknown>>();
+		const env = await client.get(`_platform/market/history`).json<OjEnvelope<PlatformMarketHistoryGetData>>();
 		// 2xx + code!==0 也是业务错误（§6.2 通道 a）：oj 不会这么发，但契约机制的价值恰是防漂移
 		if (typeof env.code === "number" && env.code !== 0)
 			throw new ContractApiError(env.code, env.msg ?? "业务错误（信封 code 非 0）");
-		const data = env.data as unknown;
+		const data = env.data as PlatformMarketHistoryGetData;
+		if (import.meta.env.DEV) {
+			const { schemas } = await import("./api.schemas");
+			const r = schemas["platformMarketHistoryGet"].data.safeParse(data);
+			if (!r.success)
+				throw new ContractApiError(-1, `[契约违例] platformMarketHistoryGet 响应与契约不符：${r.error.issues.map(i => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ")}`);
+		}
 		return data;
 	}
 	catch (e) {

package/templates/web/src/oj-market/__tests__/CardGrid.test.tsx

@@ -73,6 +73,25 @@ describe("cardGrid 卡片网格（BDD）", () => {
 		expect(handlers.onRollback).toHaveBeenCalledWith(installed);
 	});
 
+	it("given canManage=false（非 superadmin）When 渲染 Then 安装/启停/回滚/卸载按钮禁用、详情/历史保持可用", () => {
+		renderWithProviders(
+			<CardGrid rows={[installed]} canManage={false} {...handlers} />,
+			new InMemoryMarketClient(),
+		);
+		const btn = (name: string) => screen.getByRole("button", { name }) as HTMLButtonElement;
+		// 写操作禁用
+		expect(btn("升级").disabled).toBe(true);
+		expect(btn("停用").disabled).toBe(true);
+		expect(btn("卸载").disabled).toBe(true);
+		expect((screen.getByTestId("card-rollback-alpha") as HTMLButtonElement).disabled).toBe(true);
+		// 只读操作不受影响
+		expect(btn("详情").disabled).toBe(false);
+		expect(btn("历史").disabled).toBe(false);
+		// 禁用时不应触发写回调
+		btn("卸载").click();
+		expect(handlers.onUninstall).not.toHaveBeenCalled();
+	});
+
 	it("given 空列表 When 渲染 Then 显示空态", () => {
 		renderWithProviders(<CardGrid rows={[]} {...handlers} />, new InMemoryMarketClient());
 		expect(screen.getByTestId("card-grid-empty")).toBeTruthy();

package/templates/web/src/oj-market/__tests__/InstallDialog.test.tsx

@@ -18,6 +18,7 @@ describe("installDialog 安装进度（BDD）", () => {
 			progress: 100,
 			message: "ok",
 			stages: [],
+			startedAt: 0,
 		};
 		const client = new InMemoryMarketClient({ taskRecord: done, installResult: { task_id: "t1" } });
 		renderWithProviders(<InstallDialog row={row} open onClose={() => {}} />, client);
@@ -37,6 +38,7 @@ describe("installDialog 安装进度（BDD）", () => {
 			message: "verify failed",
 			stages: [{ stage: "verifying", ok: false, message: "bad hash" }],
 			error: { reason: "包校验失败", retryable: false, hintKey: "lifecycle.stage.verifying.hint" },
+			startedAt: 0,
 		};
 		const client = new InMemoryMarketClient({ taskRecord: failed, installResult: { task_id: "t1" } });
 		renderWithProviders(<InstallDialog row={row} open onClose={() => {}} />, client);
@@ -54,6 +56,7 @@ describe("installDialog 安装进度（BDD）", () => {
 			progress: 100,
 			message: "ok",
 			stages: [],
+			startedAt: 0,
 		};
 		const client = new InMemoryMarketClient({ taskRecord: done, installResult: { task_id: "t1" } });
 		const rollbackRow: IndexRow = { name: "alpha", latest: "1.2.0", installed: "1.2.0", enabled: true, upgradable: false };

package/templates/web/src/oj-market/__tests__/RollbackDialog.test.tsx

@@ -4,6 +4,7 @@ import { describe, expect, it, vi } from "vitest";
 import { RollbackDialog } from "../components/RollbackDialog";
 import { InMemoryMarketClient } from "./marketClient.fake";
 import { renderWithProviders } from "./render";
+import "@testing-library/jest-dom/vitest";
 
 const row: IndexRow = { name: "alpha", latest: "1.2.0", installed: "1.2.0", enabled: true, upgradable: false };
 

package/templates/web/src/oj-market/__tests__/marketClient.fake.ts

@@ -45,6 +45,7 @@ export class InMemoryMarketClient implements MarketClient {
 			progress: 100,
 			message: "ok",
 			stages: [],
+			startedAt: 0,
 		} as TaskRecord);
 	}
 

package/templates/web/src/oj-market/api/client.ts

@@ -1,6 +1,9 @@
-// 市场 API 客户端（DIP）：定义与宿主 _platform 编排面 + market_history 端点的契约。
-// 实现与 ky 形态解耦——组件/hooks 注入 MarketClient，测试可注入内存 fake（见 __tests__）。
+// 市场 API 客户端契约（DIP  seams）：组件/hooks 依赖此接口，而非具体 http 实现；
+// 测试可注入内存 fake（见 __tests__/marketClient.fake.ts）。
 // 第一方专用调用面（R29）：仅市场应用消费 /api/_platform/market/*，第三方方案不得仿照。
+//
+// 实现见同目录 defaultClient.ts——统一委托给 ojm 从契约生成的 __client，消除手写
+// URL/信封解包与契约漂移（DEV 下生成 client 还会对响应做 zod 校验）。
 
 import type {
 	EnableInput,
@@ -11,27 +14,6 @@ import type {
 	UninstallImpact,
 } from "../types";
 
-/** ky 形态的最小请求子集（get/post 返回带 .json<T>() 的响应） */
-export interface HttpRequest {
-	get: <T = unknown>(
-		url: string,
-		// silentError：错误体由本客户端消化（未配置市场地址走空态），不弹全局 toast；
-		// retry: 0：503 是配置态而非抖动，默认重试 3 次只会刷出 4 条同样错误。
-		opts?: { searchParams?: Record<string, string>, silentError?: boolean, retry?: number },
-	) => Promise<{ json: <R = T>() => Promise<R> }>
-	post: <T = unknown>(
-		url: string,
-		opts?: { json?: unknown },
-	) => Promise<{ json: <R = T>() => Promise<R> }>
-}
-
-/** 与运行时/生成客户端一致的响应信封（DIP：服务端统一 {code,msg,data} 包裹） */
-interface OjEnvelope<T> {
-	code: number
-	msg?: string
-	data?: T
-}
-
 /** 市场客户端契约（组件/hooks 依赖此接口，而非具体 http 实现） */
 export interface MarketClient {
 	/** 登录即可：{ apiVersion }（peerPlatform 预检口径） */
@@ -51,85 +33,3 @@ export interface MarketClient {
 	/** 卸载（P1-15a 补齐后接通） */
 	uninstall: (name: string) => Promise<{ ok: boolean, message: string }>
 }
-
-// 第一方市场端点：相对前缀，由运行时 request 的 VITE_API_BASE_URL（/api）统一加前缀；
-// 此处若再写 /api 会与运行时前缀叠加成 /api/api/（R29 联调发现）。
-const PLATFORM = "/_platform/market";
-const HISTORY = "/_platform/market/history";
-
-/**
- * 503 = 服务端「未配置市场地址（framework.market_cdn_url）」，是**预期空态**而非故障
- * （PRD §5.3：卡片区显示「未配置市场地址」）。模板默认不配市场地址，新工程一进市场页
- * 就会撞它——在此归空数组，交由卡片空态文案承载；其它状态码照旧上抛。
- */
-function isUnconfigured(e: unknown): boolean {
-	return (e as { response?: { status?: number } } | null)?.response?.status === 503;
-}
-
-/** 默认 HTTP 实现：基于运行时 request（ky 形态） */
-export function createHttpMarketClient(request: HttpRequest): MarketClient {
-	return {
-		async meta() {
-			const r = await request.get<OjEnvelope<{ apiVersion: string }>>(`${PLATFORM}/meta`);
-			const env = await r.json();
-			return env.data!;
-		},
-		async index() {
-			try {
-				const r = await request.get<OjEnvelope<IndexRow[]>>(`${PLATFORM}/index`, {
-					silentError: true,
-					retry: 0,
-				});
-				const env = await r.json();
-				return env.data!;
-			}
-			catch (e) {
-				if (isUnconfigured(e))
-					return [];
-				throw e;
-			}
-		},
-		async install(input: InstallInput) {
-			const r = await request.post<OjEnvelope<{ task_id: string }>>(`${PLATFORM}/install`, {
-				json: {
-					name: input.name,
-					version: input.version ?? null,
-					source: input.source ?? "cdn",
-				},
-			});
-			const env = await r.json();
-			return env.data!;
-		},
-		async task(id: string) {
-			const r = await request.get<OjEnvelope<TaskRecord>>(`${PLATFORM}/task`, { searchParams: { id } });
-			const env = await r.json();
-			return env.data!;
-		},
-		async enable(input: EnableInput) {
-			const r = await request.post<OjEnvelope<{ ok: boolean, message: string }>>(`${PLATFORM}/enable`, {
-				json: { name: input.name, enabled: input.enabled },
-			});
-			const env = await r.json();
-			return env.data!;
-		},
-		async history() {
-			const r = await request.get<OjEnvelope<MarketHistory[]>>(HISTORY);
-			const env = await r.json();
-			return env.data!;
-		},
-		async uninstallImpact(name: string) {
-			const r = await request.get<OjEnvelope<UninstallImpact>>(`${PLATFORM}/uninstall-impact`, {
-				searchParams: { name },
-			});
-			const env = await r.json();
-			return env.data!;
-		},
-		async uninstall(name: string) {
-			const r = await request.post<OjEnvelope<{ ok: boolean, message: string }>>(`${PLATFORM}/uninstall`, {
-				json: { name },
-			});
-			const env = await r.json();
-			return env.data!;
-		},
-	};
-}