@oj-module/cli 0.1.16 → 0.1.20

package/src/contract/emit-meta.ts

@@ -1,175 +0,0 @@
-import type { IrEndpoint } from "./ir";
-import { stringify } from "yaml";
-import { z } from "zod";
-
-/**
- * AC-D1/D9：routes.json 与 openapi.yaml 发射器。
- *
- * - routes.json：ojm dev mock 消费；格式 = oj routes.js 规范化
- *   （去 apiPrefix 首斜杠、不含 base、含模块段），method+pattern 排序保证字节稳定。
- * - openapi.yaml：OpenAPI 3.1，文档站（ojm api docs）与外部评审的单一来源。
- *   z.date() 无法进 JSON Schema——先降级为 datetime string（线上传输本就是 ISO 串）。
- * 两者都是提交产物：同输入必须字节稳定，diff 即可评审。
- */
-
-/** routes.json：`[{ method, pattern }]`，pattern 去首斜杠、含模块段（AC-D9） */
-export function emitRoutesJson(ir: IrEndpoint[]): string {
-	const rows = ir
-		.map(ep => ({ method: ep.method, pattern: ep.fullPath.replace(/^\//, "") }))
-		.sort((a, b) => (a.method < b.method ? -1 : a.method > b.method ? 1 : a.pattern < b.pattern ? -1 : a.pattern > b.pattern ? 1 : 0));
-	return `${JSON.stringify(rows, null, "\t")}\n`;
-}
-
-/** z.date() → datetime string（JSON Schema 无 date 类型；线上本就是 ISO 串） */
-function replaceDates(schema: unknown): unknown {
-	const def = (schema as { _zod?: { def?: Record<string, unknown> } })?._zod?.def;
-	if (!def)
-		return schema;
-	switch (def.type) {
-		case "date":
-			return z.string().datetime();
-		case "object": {
-			const shape: Record<string, unknown> = {};
-			for (const [k, v] of Object.entries(def.shape as Record<string, unknown>))
-				shape[k] = replaceDates(v);
-			return z.object(shape as Record<string, z.ZodType>);
-		}
-		case "array":
-			return z.array(replaceDates(def.element) as z.ZodType);
-		case "union":
-			return z.union((def.options as unknown[]).map(s => replaceDates(s) as z.ZodType) as [z.ZodType, ...z.ZodType[]]);
-		case "optional":
-			return (replaceDates(def.innerType) as z.ZodType).optional();
-		case "nullable":
-			return (replaceDates(def.innerType) as z.ZodType).nullable();
-		case "default":
-			return (replaceDates(def.innerType) as z.ZodType).default(def.defaultValue);
-		default:
-			return schema;
-	}
-}
-
-/** zod schema → JSON Schema（剥 $schema——嵌入文档不需要逐份声明 draft） */
-function jsonSchema(schema: unknown): Record<string, unknown> {
-	const out = z.toJSONSchema(replaceDates(schema) as z.ZodType) as Record<string, unknown>;
-	delete out.$schema;
-	return out;
-}
-
-/** `{*path}` → `{path}`（OpenAPI 模板无 catch-all 记号） */
-function openapiPath(fullPath: string): string {
-	return fullPath.replace(/\{\*(\w+)\}/g, "{$1}");
-}
-
-function pathParameters(ep: IrEndpoint): Record<string, unknown>[] {
-	const props = (ep.paramsSchema ? jsonSchema(ep.paramsSchema).properties : {}) as Record<string, unknown> | undefined;
-	return ep.paramNames.map(name => ({
-		name,
-		in: "path",
-		required: true,
-		schema: props?.[name] ?? { type: "string" },
-	}));
-}
-
-function queryParameters(ep: IrEndpoint): Record<string, unknown>[] {
-	if (!ep.querySchema)
-		return [];
-	const s = jsonSchema(ep.querySchema);
-	const required = new Set((s.required as string[]) ?? []);
-	return Object.entries((s.properties as Record<string, unknown>) ?? {}).map(([name, schema]) => ({
-		name,
-		in: "query",
-		required: required.has(name),
-		schema,
-	}));
-}
-
-function successResponse(ep: IrEndpoint): Record<string, unknown> {
-	if (ep.raw) {
-		return {
-			description: "成功（原始流，非信封）",
-			content: { "application/octet-stream": { schema: { type: "string", format: "binary" } } },
-		};
-	}
-	const properties: Record<string, unknown> = { code: { type: "integer" }, msg: { type: "string" } };
-	if (ep.dataSchema)
-		properties.data = jsonSchema(ep.dataSchema);
-	return {
-		description: "成功（oj 信封：code=0）",
-		content: { "application/json": { schema: { type: "object", properties } } },
-	};
-}
-
-/** 业务错误响应（§6.2 通道 b：HTTP status=code，信封 {code,msg}） */
-function errorResponse(): Record<string, unknown> {
-	return {
-		description: "业务错误（oj 信封：code 非 0，HTTP status=code）",
-		content: { "application/json": { schema: { type: "object", properties: { code: { type: "integer" }, msg: { type: "string" } }, required: ["code"] } } },
-	};
-}
-
-/** 文件部件 schema（OpenAPI 3.1 binary；multiple → array of binary） */
-function filePartSchema(multiple: boolean): Record<string, unknown> {
-	const binary = { type: "string", format: "binary" };
-	return multiple ? { type: "array", items: binary } : binary;
-}
-
-/**
- * multipart/form-data 请求体：文本部件取 form.fields 的 JSON Schema properties（键序 = 契约声明序），
- * 文件部件按声明补 `{ type: "string", format: "binary" }`；required = fields 的 required ∪ 必传文件。
- */
-function formRequestBody(ep: IrEndpoint): Record<string, unknown> {
-	const form = ep.form!;
-	const fields = form.fieldsSchema ? jsonSchema(form.fieldsSchema) : {};
-	const fieldProps = (fields.properties as Record<string, unknown>) ?? {};
-	const requiredFields = (fields.required as string[]) ?? [];
-	const properties: Record<string, unknown> = {};
-	// 键序固定：先文本部件（契约 shape 序），再文件部件（DSL 数组序）——字节稳定
-	for (const name of form.fieldNames)
-		properties[name] = fieldProps[name];
-	const required = [...requiredFields];
-	for (const file of form.files) {
-		properties[file.name] = filePartSchema(file.multiple);
-		if (file.required)
-			required.push(file.name);
-	}
-	return {
-		required: true,
-		content: {
-			"multipart/form-data": {
-				schema: { type: "object", properties, ...(required.length ? { required } : {}) },
-			},
-		},
-	};
-}
-
-/** openapi.yaml：OpenAPI 3.1；paths/methods 排序 + 键序固定，保证字节稳定 */
-export function emitOpenapiYaml(ir: IrEndpoint[], opts: { title: string, version: string }): string {
-	const paths: Record<string, Record<string, unknown>> = {};
-	const sorted = [...ir].sort((a, b) => (a.fullPath < b.fullPath ? -1 : a.fullPath > b.fullPath ? 1 : a.method < b.method ? -1 : 1));
-	for (const ep of sorted) {
-		const op: Record<string, unknown> = {};
-		op.operationId = ep.name;
-		if (ep.description)
-			op.description = ep.description;
-		const parameters = [...pathParameters(ep), ...queryParameters(ep)];
-		if (parameters.length)
-			op.parameters = parameters;
-		if (ep.bodySchema)
-			op.requestBody = { required: true, content: { "application/json": { schema: jsonSchema(ep.bodySchema) } } };
-		// form 端点（与 body 互斥）：multipart/form-data 请求体（文本部件 + binary 文件部件）
-		if (ep.form)
-			op.requestBody = formRequestBody(ep);
-		op.responses = ep.raw
-			? { 200: successResponse(ep) }
-			// §6.2 错误通道入交付物（评审 F14/m9）：业务错误为 default 响应，信封 code 非 0
-			: { 200: successResponse(ep), default: errorResponse() };
-		const p = openapiPath(ep.fullPath);
-		(paths[p] ??= {})[ep.method.toLowerCase()] = op;
-	}
-	return stringify({
-		openapi: "3.1.0",
-		info: { title: opts.title, version: opts.version },
-		paths,
-	});
-}

package/src/contract/emit-schema.ts

@@ -1,133 +0,0 @@
-/**
- * 白名单 schema → TS 源码发射器（AC-D12/D6）。
- *
- * 生成物（api.schemas.ts）里的 schema 是**重新发射的源码**而非跨树
- * import——前端模块因此保持自包含，不直接依赖契约源文件。
- * 只处理 AC-D12 白名单内的 def.type（IR 构建期已拦截白名单外 schema），
- * 遇到意料外结构时报人话错误而非静默错发。
- */
-
-interface ZodDef { [key: string]: unknown }
-
-function defOf(schema: unknown): ZodDef {
-	const def = (schema as { _zod?: { def?: ZodDef } })?._zod?.def;
-	if (!def)
-		throw new Error("[ojm-api] schema 发射失败：不是 zod schema（白名单校验应已在 IR 阶段拦截，此为内部不一致）。");
-	return def;
-}
-
-const IDENT = /^[a-z_$][\w$]*$/i;
-
-/** 对象键发射：合法标识符原样，其余 JSON 引号化（emit-stub 的示例值同款复用） */
-export function keyOf(name: string): string {
-	return IDENT.test(name) ? name : JSON.stringify(name);
-}
-
-/** string_format → zod 方法名映射（白名单内常见格式；regex 单列） */
-const STRING_FORMAT_METHOD: Record<string, string> = {
-	email: "email",
-	url: "url",
-	uuid: "uuid",
-	datetime: "datetime",
-	date: "date",
-	time: "time",
-};
-
-function emitChecks(type: string, def: ZodDef): string {
-	let out = "";
-	for (const check of (def.checks as { _zod?: { def?: ZodDef } }[]) ?? []) {
-		const cd = check._zod?.def;
-		if (!cd)
-			continue;
-		switch (cd.check) {
-			case "min_length":
-				out += `.min(${cd.minimum})`;
-				break;
-			case "max_length":
-				out += `.max(${cd.maximum})`;
-				break;
-			case "length_equals":
-				out += `.length(${cd.length})`;
-				break;
-			case "greater_than":
-				out += cd.inclusive === false ? `.gt(${cd.value})` : `.min(${cd.value})`;
-				break;
-			case "less_than":
-				out += cd.inclusive === false ? `.lt(${cd.value})` : `.max(${cd.value})`;
-				break;
-			case "multiple_of":
-				out += `.multipleOf(${cd.value})`;
-				break;
-			case "number_format":
-				if (cd.format === "safeint")
-					out += ".int()";
-				break;
-			case "string_format": {
-				if (cd.format === "regex") {
-					const pattern = cd.pattern as RegExp;
-					// 评审 F10：flags 丢失即语义削弱——不可保真，拒绝而非静默降级
-					if (pattern.flags && pattern.flags !== "u")
-						throw new Error(`[ojm-api] schema 发射失败：regex /${pattern.source}/${pattern.flags} 带 flags 无法保真发射（白名单只支持无 flags 形态）。`);
-					out += `.regex(/${pattern.source}/)`;
-					break;
-				}
-				const method = STRING_FORMAT_METHOD[cd.format as string];
-				if (!method) {
-					throw new Error(`[ojm-api] schema 发射失败：string format "${String(cd.format)}" 不在可保真映射（${Object.keys(STRING_FORMAT_METHOD).join("/")}）——静默放宽校验违背白名单「检出即报错」，请改用已支持格式或纯 string。`);
-				}
-				out += `.${method}()`;
-				break;
-			}
-			default:
-				break;
-		}
-	}
-	return out;
-}
-
-/** 递归发射 schema 为 z 调用链源码 */
-export function emitSchemaSource(schema: unknown): string {
-	const def = defOf(schema);
-	const type = def.type as string;
-	switch (type) {
-		case "string":
-			return `z.string()${emitChecks(type, def)}`;
-		case "number":
-			return `z.number()${emitChecks(type, def)}`;
-		case "boolean":
-			return "z.boolean()";
-		case "date":
-			// 评审 F1：线上传输本就是 ISO 串（emit-meta/mock/stub 三链一致），
-			// z.date() 期望 Date 实例会让 dev 校验对线上数据必误报——发 z.iso.datetime()
-			return "z.iso.datetime()";
-		case "literal": {
-			const values = def.values as unknown[];
-			return `z.literal(${values.length === 1 ? JSON.stringify(values[0]) : JSON.stringify(values)})`;
-		}
-		case "enum":
-			return `z.enum(${JSON.stringify(Object.keys(def.entries as object))})`;
-		case "union":
-			return `z.union([${(def.options as unknown[]).map(emitSchemaSource).join(", ")}])`;
-		case "array":
-			// min/max 等长度约束同样保真发射（评审 F10：此前静默丢弃）
-			return `z.array(${emitSchemaSource(def.element)})${emitChecks(type, def)}`;
-		case "object": {
-			const entries = Object.entries(def.shape as Record<string, unknown>)
-				.map(([k, v]) => `\n\t${keyOf(k)}: ${emitSchemaSource(v).replaceAll("\n", "\n\t")},`);
-			return `z.object({${entries.join("")}\n})`;
-		}
-		case "optional":
-			return `${emitSchemaSource(def.innerType)}.optional()`;
-		case "nullable":
-			return `${emitSchemaSource(def.innerType)}.nullable()`;
-		case "default": {
-			const value = def.defaultValue;
-			if (typeof value === "function" || JSON.stringify(value) === undefined) {
-				throw new Error("[ojm-api] schema 发射失败：default 值必须是 JSON 可序列化字面量（函数/undefined 不支持）。");
-			}
-			return `${emitSchemaSource(def.innerType)}.default(${JSON.stringify(value)})`;
-		}
-		default:
-			throw new Error(`[ojm-api] schema 发射失败：类型 "${type}" 不在白名单（应在 IR 阶段被拦截，此为内部不一致）。`);
-	}
-}

package/src/contract/evaluate.ts

@@ -1,88 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-import { pathToFileURL } from "node:url";
-
-import { build as esbuild } from "esbuild";
-
-/**
- * AC-D13：契约求值——复用 build.ts 的 `readModuleDefinition` 同款链路
- * （esbuild bundle → 工程内临时目录 → 真 import()），但 stub 策略不同：
- *
- * - `@oj-module/runtime/contract` 保持 external，Node 侧命中**真实现**
- *   （contract 子路径零浏览器依赖，其 zod 与浏览器侧 runtime re-export 同源钉版，
- *   版本一致性由 pnpm catalog + 版本矩阵门禁保证）；
- * - `@oj-module/runtime` 若被契约误 import，替换为空壳 stub 并告警
- *   ——runtime 入口是浏览器代码（React/import.meta.env/localStorage），
- *   Node 下求值即崩；
- * - 其余共享依赖全部 external，由 Node 在 import() 时真实解析。
- */
-
-/** runtime 误 import 的空壳 stub（任何具名导出都给占位函数，防 esbuild 报 missing export） */
-const RUNTIME_GUARD_STUB = `
-const warn = (name) => {
-	console.warn("[ojm-api] 契约文件不应 import @oj-module/runtime（浏览器代码），已用空壳替代：" + name);
-};
-const _fn = (...a) => { warn("value"); return a[a.length - 1]; };
-export const defineModule = _fn;
-export const z = new Proxy({}, { get: () => { warn("z"); return _fn; } });
-export default new Proxy({}, { get: () => _fn });
-`;
-
-export async function evaluateContract(
-	contractFile: string,
-	projectRoot: string,
-): Promise<Record<string, unknown>> {
-	if (!fs.existsSync(contractFile)) {
-		throw new Error(`[ojm-api] 契约文件不存在：${contractFile}——请检查路径（默认发现：api/src/*/contract.ts 或 web/src/*/client/contract.ts）。`);
-	}
-
-	// 必须落在工程目录内（而非 os.tmpdir）：bundle 外部化的依赖在 import() 时
-	// 需要从工程 node_modules 解析（同 build.ts readModuleDefinition 的理由）
-	const outDir = fs.mkdtempSync(path.join(projectRoot, ".ojm-tmp-"));
-	try {
-		await esbuild({
-			entryPoints: [contractFile],
-			entryNames: "entry",
-			bundle: true,
-			format: "esm",
-			platform: "node",
-			packages: "external",
-			plugins: [{
-				name: "ojm-contract-runtime-guard",
-				setup(build) {
-					build.onResolve({ filter: /^@oj-module\/runtime$/ }, () => ({
-						path: "ojm-runtime-guard-stub",
-						namespace: "ojm-stub",
-					}));
-					build.onLoad({ filter: /.*/, namespace: "ojm-stub" }, () => ({
-						contents: RUNTIME_GUARD_STUB,
-						loader: "js",
-					}));
-				},
-			}],
-			outdir: outDir,
-			loader: { ".ts": "ts", ".tsx": "tsx", ".json": "json" },
-			logLevel: "silent",
-		});
-		const bundled = path.join(outDir, "entry.js");
-		try {
-			const mod = await import(pathToFileURL(bundled).href) as Record<string, unknown>;
-			return mod;
-		}
-		catch (e) {
-			const msg = e instanceof Error ? e.message : String(e);
-			// 最常见的外部工程缺依赖：给出可操作修复，而不是裸 ERR_MODULE_NOT_FOUND
-			if (msg.includes("@oj-module/runtime/contract")) {
-				throw new Error(
-					"[ojm-api] 契约求值需要工程 node_modules 里能解析 @oj-module/runtime/contract，但当前工程未安装它。\n"
-					+ "修复：把 \"@oj-module/runtime\" 加进工程 devDependencies（版本与宿主对齐）后重跑 pnpm install；"
-					+ "新工程由 ojm init 自动声明。",
-				);
-			}
-			throw e;
-		}
-	}
-	finally {
-		fs.rmSync(outDir, { recursive: true, force: true });
-	}
-}

package/templates/api/src/auth/login/api.ts

@@ -1,27 +0,0 @@
-import { issueTokens } from "../_shared/session";
-
-// POST /api/auth/login —— 登录（devkit 手册 §8：auth 端点是业务路由）。
-// 用户不存在与密码错同报 invalid credentials（不泄露用户存在性）。
-export default {
-	async post() {
-		const body = http.body || {};
-		const rows = await db.query(
-			"select id, password_hash, roles from users where username = ?",
-			[String(body.username ?? "")],
-		);
-		const row = rows[0];
-		if (!row || !(await bcrypt.verify(String(body.password ?? ""), row.password_hash || ""))) {
-			json.fail(401, "invalid credentials");
-			return;
-		}
-		// roles 列按 JSON 数组串解析，失败回落空。
-		let roles: string[] = [];
-		try {
-			roles = JSON.parse(row.roles || "[]");
-		}
-		catch {
-			roles = [];
-		}
-		json.ok(await issueTokens(String(row.id), roles));
-	},
-};

package/templates/api/src/auth/logout/api.ts

@@ -1,10 +0,0 @@
-import { sessionKey } from "../_shared/session";
-
-// POST /api/auth/logout —— 注销（删 refresh session；access 到期前仍有效）。
-export default {
-	async post() {
-		const token = String((http.body || {}).refresh_token ?? "");
-		await kv.del(sessionKey(token));
-		json.ok(null);
-	},
-};

package/templates/api/src/auth/refresh/api.ts

@@ -1,26 +0,0 @@
-import { issueTokens, nowSecs, sessionKey } from "../_shared/session";
-
-// POST /api/auth/refresh —— 刷新（轮换：旧 refresh 立即失效，一次一用）。
-export default {
-	async post() {
-		const token = String((http.body || {}).refresh_token ?? "");
-		const key = sessionKey(token);
-		const raw = await kv.get(key);
-		const sess = raw ? JSON.parse(raw) : null;
-		if (!sess || !(sess.exp > nowSecs())) {
-			json.fail(401, "invalid or expired refresh token");
-			return;
-		}
-		// session 只存 uid——roles 重查库取最新。
-		const rows = await db.query("select roles from users where id = ?", [sess.uid]);
-		let roles: string[] = [];
-		try {
-			roles = JSON.parse((rows[0] || {}).roles || "[]");
-		}
-		catch {
-			roles = [];
-		}
-		await kv.del(key);
-		json.ok(await issueTokens(String(sess.uid), roles));
-	},
-};

package/templates/api/src/notification/contract.ts

@@ -1,52 +0,0 @@
-import { defineApi, z } from "@oj-module/runtime/contract";
-
-/**
- * notification 模块契约（uni-dev 形态，apiPrefix 字面等于 "/notification"，AC-D9）。
- * 通知读写端点——前端经 ctx.register.notificationsApi 全量接管内置通知 API（D9 + G4）：
- * 读 + 单条已读 + 全部已读 + 清空，四端点全必填。
- */
-
-/** 通知项 */
-const notificationItem = z.object({
-	id: z.number(),
-	avatar: z.string(),
-	date: z.string(),
-	isRead: z.boolean().optional(),
-	message: z.string(),
-	title: z.string(),
-});
-
-/* 通知列表 */
-export const fetchNotifications = defineApi({
-	apiPrefix: "/notification",
-	route: "/notifications",
-	data: z.array(notificationItem),
-	description: "通知列表",
-});
-
-/* 单条已读 */
-export const markRead = defineApi({
-	apiPrefix: "/notification",
-	route: "/notifications/read",
-	method: "POST",
-	body: z.object({
-		id: z.number(),
-	}),
-	description: "单条通知已读",
-});
-
-/* 全部已读 */
-export const markAllRead = defineApi({
-	apiPrefix: "/notification",
-	route: "/notifications/read-all",
-	method: "POST",
-	description: "全部通知已读",
-});
-
-/* 清空通知 */
-export const clearAll = defineApi({
-	apiPrefix: "/notification",
-	route: "/notifications/clear",
-	method: "POST",
-	description: "清空通知",
-});

package/templates/api/src/notification/notifications/api.ts

@@ -1,24 +0,0 @@
-// GET /api/notification/notifications —— 通知列表（真实化 P4-2，AC-D9 apiPrefix=/notification）。
-// 真实化：查 notifications 表，is_read 映射布尔；Bearer 守卫保护。
-// G4：补 id（单条已读的前提，评审 A4——查了 id 必须返回）。
-export default {
-	async get() {
-		try {
-			const rows = await db.query(
-				"SELECT id, avatar, date, is_read, message, title FROM notifications ORDER BY id DESC",
-				[],
-			);
-			json.ok(rows.map(r => ({
-				id: Number(r.id),
-				avatar: String(r.avatar),
-				date: String(r.date),
-				isRead: Number(r.is_read) === 1,
-				message: String(r.message),
-				title: String(r.title),
-			})));
-		}
-		catch (e) {
-			json.fail(500, String(e));
-		}
-	},
-};

package/templates/api/src/notification/notifications/clear/api.ts

@@ -1,13 +0,0 @@
-// POST /api/notification/notifications/clear —— 清空通知（G4）。
-// 清空 notifications 全表。Bearer 守卫保护。
-export default {
-	async post() {
-		try {
-			await db.query("DELETE FROM notifications", []);
-			json.ok(null);
-		}
-		catch (e) {
-			json.fail(500, String(e));
-		}
-	},
-};

package/templates/api/src/notification/notifications/read/api.ts

@@ -1,19 +0,0 @@
-// POST /api/notification/notifications/read —— 单条通知已读（G4）。
-// body: { id }；把对应行 is_read 置 1。Bearer 守卫保护。
-export default {
-	async post() {
-		try {
-			const body = (http.body ?? {}) as { id?: unknown };
-			const id = Number(body.id);
-			if (!Number.isFinite(id)) {
-				json.fail(400, "id is required");
-				return;
-			}
-			await db.query("UPDATE notifications SET is_read = 1 WHERE id = ?", [id]);
-			json.ok(null);
-		}
-		catch (e) {
-			json.fail(500, String(e));
-		}
-	},
-};

package/templates/api/src/notification/notifications/read-all/api.ts

@@ -1,13 +0,0 @@
-// POST /api/notification/notifications/read-all —— 全部通知已读（G4）。
-// 把 notifications 表 is_read 全置 1。Bearer 守卫保护。
-export default {
-	async post() {
-		try {
-			await db.query("UPDATE notifications SET is_read = 1", []);
-			json.ok(null);
-		}
-		catch (e) {
-			json.fail(500, String(e));
-		}
-	},
-};

package/templates/api/src/personal-center/contract.ts

@@ -1,16 +0,0 @@
-import { defineApi, z } from "@oj-module/runtime/contract";
-
-/**
- * personal-center 模块契约（uni-dev 形态，apiPrefix 字面等于 "/personal-center"，AC-D9）。
- * 头像/附件上传端点——前端经 ctx.register.uploadApi 接管 form-avatar-item 的 action/headers（见 P4）。
- */
-
-/* 头像上传：实际为 multipart（由 antd Upload 直连 uploadProvider.action 发送，
- * 不经 JSON client），故此处不声明 body schema；data 为上传后返回的资源 URL。 */
-export const upload = defineApi({
-	apiPrefix: "/personal-center",
-	route: "/upload",
-	method: "POST",
-	data: z.string(),
-	description: "头像/附件上传，返回资源 URL",
-});