refactor(*): 稳定期治理 - 收敛核心架构、错误语义并修复跨项目数据竞态

web/test/asset-record.test.ts

@@ -0,0 +1,59 @@
+import { describe, expect, test } from "bun:test";
+
+import { parseAssetRecord, parseAssetRecordList } from "@/lib/asset-record";
+
+const completeImage = {
+    id: "image-1",
+    kind: "image",
+    title: "完整图片",
+    coverUrl: "https://example.com/a.png",
+    tags: ["角色"],
+    createdAt: "2026-08-29T00:00:00.000Z",
+    updatedAt: "2026-08-29T00:00:00.000Z",
+    data: { dataUrl: "https://example.com/a.png", width: 1, height: 1, bytes: 1, mimeType: "image/png" },
+};
+
+describe("parseAssetRecord", () => {
+    test("accepts a complete image asset", () => {
+        expect(parseAssetRecord(completeImage).tags).toEqual(["角色"]);
+    });
+
+    test("rejects missing or malformed tags", () => {
+        expect(() => parseAssetRecord({ ...completeImage, tags: undefined })).toThrow(/tags/);
+        expect(() => parseAssetRecord({ ...completeImage, tags: ["角色", 1] })).toThrow(/tags/);
+    });
+
+    test("rejects incomplete image data instead of filling zeros", () => {
+        expect(() => parseAssetRecord({
+            ...completeImage,
+            data: undefined,
+        })).toThrow(/data/);
+        expect(() => parseAssetRecord({
+            ...completeImage,
+            data: { dataUrl: "", width: 1, height: 1, bytes: 1, mimeType: "image/png" },
+        })).toThrow(/dataUrl 或 storageKey/);
+        expect(() => parseAssetRecord({
+            ...completeImage,
+            data: { dataUrl: "https://example.com/a.png", width: 0, height: 1, bytes: 1, mimeType: "image/png" },
+        })).toThrow(/width/);
+    });
+
+    test("rejects wildcard and cross-kind MIME metadata", () => {
+        expect(() => parseAssetRecord({
+            ...completeImage,
+            data: { ...completeImage.data, mimeType: "image/*" },
+        })).toThrow(/具体 MIME/);
+        expect(() => parseAssetRecord({
+            ...completeImage,
+            data: { ...completeImage.data, mimeType: "audio/mpeg" },
+        })).toThrow(/不匹配/);
+        expect(parseAssetRecord({
+            ...completeImage,
+            data: { ...completeImage.data, mimeType: "application/octet-stream" },
+        }).kind).toBe("image");
+    });
+
+    test("parseAssetRecordList names the failing record", () => {
+        expect(() => parseAssetRecordList([{ ...completeImage, id: "bad", tags: undefined }])).toThrow(/素材 bad/);
+    });
+});