@yinuo-ngm/server 1.0.20 → 1.0.22

package/lib/routes/sprite/sprite-quick.utils.js

@@ -0,0 +1,247 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MISC_PROXY_PREFIX = exports.QUICK_SPRITE_PROXY_PREFIX = void 0;
+exports.getBaseUrl = getBaseUrl;
+exports.buildQuickPreviewUrl = buildQuickPreviewUrl;
+exports.quickFetch = quickFetch;
+exports.resolveEnabledRemoteProjectId = resolveEnabledRemoteProjectId;
+exports.fetchRemoteProject = fetchRemoteProject;
+exports.mapToGroup = mapToGroup;
+exports.mapQuickGroupsToSnapshot = mapQuickGroupsToSnapshot;
+exports.copyRawResponseHeaders = copyRawResponseHeaders;
+exports.hasQuickSprite = hasQuickSprite;
+exports.fetchAndCacheRemoteMiscImages = fetchAndCacheRemoteMiscImages;
+exports.buildBrowseFromCache = buildBrowseFromCache;
+exports.buildRemoteMiscUrl = buildRemoteMiscUrl;
+const errors_1 = require("@yinuo-ngm/errors");
+const sprite_1 = require("@yinuo-ngm/sprite");
+function getBaseUrl(cfg) {
+    return (cfg?.quickSpriteBaseUrl?.trim() ||
+        "http://192.168.1.31:7010").replace(/\/+$/, "");
+}
+exports.QUICK_SPRITE_PROXY_PREFIX = "/api/sprite/proxy";
+function buildQuickPreviewUrl(localProjectId, group) {
+    return `${exports.QUICK_SPRITE_PROXY_PREFIX}/${encodeURIComponent(localProjectId)}/${encodeURIComponent(group)}.png`;
+}
+async function quickFetch(fastify, baseUrl, path, init) {
+    const url = `${baseUrl}${path}`;
+    fastify.log.info(`[sprite-quick] → ${init?.method || "GET"} ${url}`);
+    let res;
+    try {
+        res = await fetch(url, {
+            ...init,
+            headers: {
+                "Content-Type": "application/json",
+                ...init?.headers,
+            },
+        });
+    }
+    catch (err) {
+        fastify.log.error(`[sprite-quick] ✗ 无法连接远端 ${url}: ${err?.message || err}`);
+        throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.INTERNAL_ERROR, `无法连接远端雪碧图服务 (${baseUrl})：${err?.message || err}`);
+    }
+    if (!res.ok) {
+        const text = await res.text().catch(() => "");
+        fastify.log.error(`[sprite-quick] ← ${res.status} ${url}: ${text}`);
+        throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.INTERNAL_ERROR, `远端服务返回 ${res.status}: ${text || res.statusText}`);
+    }
+    const data = (await res.json());
+    fastify.log.info(`[sprite-quick] ← ${res.status} ${url}`);
+    return data;
+}
+async function resolveEnabledRemoteProjectId(fastify, projectId) {
+    const cfg = await fastify.core.sprite.getConfig(projectId);
+    if (!cfg?.quickSpriteEnabled || !cfg?.quickSpriteProjectId)
+        return null;
+    return cfg.quickSpriteProjectId;
+}
+async function fetchRemoteProject(fastify, baseUrl, quickProjectId) {
+    try {
+        return await quickFetch(fastify, baseUrl, `/api/projects/${encodeURIComponent(quickProjectId)}`);
+    }
+    catch {
+        return null;
+    }
+}
+function mapToGroup(result, localProjectId, prefix, spriteUrlTemplate) {
+    const classes = (result.classes || []).map((c) => ({
+        name: c.name,
+        className: `${prefix}-${result.group.split("-")[0]}-${c.name}`,
+        x: c.x,
+        y: c.y,
+        width: c.width,
+        height: c.height,
+    }));
+    const derived = deriveSpriteSize(classes);
+    const spriteWidth = derived.width > 0 ? derived.width : result.width || 0;
+    const spriteHeight = derived.height > 0 ? derived.height : result.height || 0;
+    const [tileW, tileH] = parseTileSize(result.group);
+    const resolvedSpriteUrl = spriteUrlTemplate
+        ? spriteUrlTemplate.replace(/{group}/g, result.group).replace(/{size}/g, String(tileW))
+        : result.spriteUrl;
+    const cssOpts = {
+        prefix,
+        spriteUrlResolver: ({ spriteUrl }) => spriteUrl,
+    };
+    const lessText = (0, sprite_1.buildLessForSprite)({ group: result.group, spriteUrl: resolvedSpriteUrl, classes }, cssOpts);
+    return {
+        group: result.group,
+        kind: "png",
+        spriteUrl: resolvedSpriteUrl,
+        previewSpriteUrl: buildQuickPreviewUrl(localProjectId, result.group),
+        lessText,
+        status: "ok",
+        meta: {
+            mode: result.mode,
+            group: result.group,
+            tileWidth: tileW,
+            tileHeight: tileH,
+            spriteWidth,
+            spriteHeight,
+            classes,
+        },
+    };
+}
+function deriveSpriteSize(classes) {
+    if (!classes.length)
+        return { width: 0, height: 0 };
+    let maxW = 0;
+    let maxH = 0;
+    for (const c of classes) {
+        const r = c.x + c.width;
+        const b = c.y + c.height;
+        if (r > maxW)
+            maxW = r;
+        if (b > maxH)
+            maxH = b;
+    }
+    return { width: maxW, height: maxH };
+}
+function parseTileSize(group) {
+    if (!group)
+        return [0, 0];
+    const parts = group.split("-");
+    if (parts.length === 0)
+        return [0, 0];
+    if (parts.length === 1) {
+        const n = parseInt(parts[0], 10);
+        return Number.isFinite(n) ? [n, n] : [0, 0];
+    }
+    const w = parseInt(parts[0], 10);
+    const h = parseInt(parts[1], 10);
+    return [Number.isFinite(w) ? w : 0, Number.isFinite(h) ? h : 0];
+}
+function mapQuickGroupsToSnapshot(projectId, results, remoteProj, localCfg) {
+    const cssPrefix = localCfg?.prefix ?? "sl";
+    const spriteUrlTpl = localCfg?.spriteUrl ?? "";
+    const groups = (results || []).map((r) => mapToGroup(r, projectId, cssPrefix, spriteUrlTpl));
+    return {
+        projectId,
+        sourceId: "",
+        iconsRoot: remoteProj?.iconsPath ?? "",
+        cacheOutDir: remoteProj?.exportSpritesDir ?? "",
+        config: {
+            projectId,
+            enabled: true,
+            sourceId: "",
+            localDir: "",
+            prefix: cssPrefix,
+            algorithm: "binary-tree",
+            persistLess: false,
+            updatedAt: remoteProj?.updatedAt
+                ? new Date(remoteProj.updatedAt).getTime()
+                : Date.now(),
+            template: localCfg?.template ?? '<i class="{base} {class}"></i>',
+            spriteUrl: localCfg?.spriteUrl ?? "",
+            spriteExportDir: localCfg?.spriteExportDir ?? "",
+            lessExportDir: localCfg?.lessExportDir ?? "",
+            localImageRoot: localCfg?.localImageRoot ?? "",
+            localCacheDir: localCfg?.localCacheDir ?? "",
+        },
+        total: groups.length,
+        success: groups.length,
+        failed: 0,
+        groups,
+    };
+}
+function copyRawResponseHeaders(response, reply) {
+    const contentType = response.headers.get("content-type");
+    if (contentType)
+        reply.header("content-type", contentType);
+    const contentLength = response.headers.get("content-length");
+    if (contentLength)
+        reply.header("content-length", contentLength);
+    const cacheControl = response.headers.get("cache-control");
+    if (cacheControl)
+        reply.header("cache-control", cacheControl);
+    const etag = response.headers.get("etag");
+    if (etag)
+        reply.header("etag", etag);
+    const lastModified = response.headers.get("last-modified");
+    if (lastModified)
+        reply.header("last-modified", lastModified);
+}
+async function hasQuickSprite(fastify, projectId) {
+    const cfg = await fastify.core.sprite.getConfig(projectId);
+    return !!cfg?.quickSpriteProjectId;
+}
+const miscCache = new Map();
+const MISC_CACHE_TTL = 5 * 60 * 1000;
+async function fetchAndCacheRemoteMiscImages(fastify, baseUrl, quickProjectId, forceRefresh = false) {
+    const cached = miscCache.get(quickProjectId);
+    if (!forceRefresh && cached && Date.now() - cached.time < MISC_CACHE_TTL) {
+        return cached.data;
+    }
+    const data = await quickFetch(fastify, baseUrl, `/api/misc/list?projectId=${encodeURIComponent(quickProjectId)}`);
+    miscCache.set(quickProjectId, { time: Date.now(), data });
+    return data;
+}
+function buildBrowseFromCache(quickProjectId, cache, dir) {
+    const list = cache.list || [];
+    const quickDir = dir ? `${dir}` : ".";
+    const filtered = list.filter((item) => item.dir === quickDir);
+    const sorted = [...filtered].sort((a, b) => a.name.localeCompare(b.name, "zh-Hans-CN", { numeric: true }));
+    const fileEntries = sorted.map((item) => {
+        const encodedName = encodeURIComponent(item.name);
+        return {
+            name: item.name,
+            kind: "file",
+            ext: item.name.split(".").pop()?.toLowerCase(),
+            url: `/api/sprite/misc-proxy/${encodeURIComponent(quickProjectId)}/${encodeURIComponent(item.dir)}/${encodedName}`,
+        };
+    });
+    const dirSet = new Set();
+    for (const item of list) {
+        if (item.dir)
+            dirSet.add(item.dir);
+    }
+    const subDirSet = new Set();
+    for (const d of dirSet) {
+        if (d === quickDir)
+            continue;
+        if (d.startsWith(quickDir) || quickDir === ".") {
+            const dirName = quickDir === "."
+                ? d.split("/")[0]
+                : d.slice(quickDir.length).split("/")[1];
+            subDirSet.add(dirName);
+        }
+    }
+    const dirEntries = Array.from(subDirSet)
+        .sort((a, b) => a.localeCompare(b, "zh-Hans-CN", { numeric: true }))
+        .map((d) => ({
+        name: d,
+        kind: "dir",
+        ext: undefined,
+        fileCount: list.filter((item) => item.dir === `${quickDir === "." ? "" : quickDir + "/"}${d}`).length,
+    }));
+    const entries = [...dirEntries, ...fileEntries];
+    return {
+        root: `remote:${quickProjectId}`,
+        dir,
+        entries,
+    };
+}
+exports.MISC_PROXY_PREFIX = "/api/sprite/misc-proxy";
+function buildRemoteMiscUrl(baseUrl, quickProjectId, filename) {
+    return `${baseUrl}/misc/${encodeURIComponent(quickProjectId)}/misc/${encodeURIComponent(filename)}`;
+}

package/lib/routes/sprite/sprite.routes.d.ts

@@ -0,0 +1,2 @@
+import type { FastifyInstance } from "fastify";
+export declare function spriteRoutes(fastify: FastifyInstance): Promise<void>;

package/lib/routes/sprite/sprite.routes.js

@@ -0,0 +1,212 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.spriteRoutes = spriteRoutes;
+const node_path_1 = __importDefault(require("node:path"));
+const node_stream_1 = require("node:stream");
+const errors_1 = require("@yinuo-ngm/errors");
+const sprite_quick_utils_1 = require("./sprite-quick.utils");
+function toSpriteConfigDto(cfg) {
+    return {
+        projectId: cfg.projectId,
+        enabled: cfg.enabled,
+        sourceId: cfg.sourceId,
+        localDir: cfg.localDir,
+        prefix: cfg.prefix,
+        template: cfg.template,
+        spriteUrl: cfg.spriteUrl,
+        spriteExportDir: cfg.spriteExportDir,
+        lessExportDir: cfg.lessExportDir,
+        algorithm: cfg.algorithm,
+        persistLess: cfg.persistLess,
+        updatedAt: cfg.updatedAt,
+        localImageRoot: cfg.localImageRoot,
+        localCacheDir: cfg.localCacheDir,
+        quickSpriteProjectId: cfg.quickSpriteProjectId,
+        quickSpriteEnabled: cfg.quickSpriteEnabled,
+        quickSpriteBaseUrl: cfg.quickSpriteBaseUrl,
+    };
+}
+function toSpriteGroupItemDto(item) {
+    return {
+        group: item.group,
+        kind: item.kind,
+        previewSpriteUrl: item.previewSpriteUrl,
+        spriteUrl: item.spriteUrl,
+        meta: item.meta,
+        lessText: item.lessText,
+        exported: item.exported,
+        status: item.status,
+        error: item.error,
+    };
+}
+function toSpriteSnapshotDto(snapshot) {
+    return {
+        projectId: snapshot.projectId,
+        sourceId: snapshot.sourceId,
+        iconsRoot: snapshot.iconsRoot,
+        cacheOutDir: snapshot.cacheOutDir,
+        config: toSpriteConfigDto(snapshot.config),
+        total: snapshot.total,
+        success: snapshot.success,
+        failed: snapshot.failed,
+        groups: (snapshot.groups ?? []).map(toSpriteGroupItemDto),
+    };
+}
+function toGenerateSpriteResultDto(snapshot) {
+    return toSpriteSnapshotDto(snapshot);
+}
+async function spriteRoutes(fastify) {
+    fastify.get("/config/:projectId", async (req) => {
+        const { projectId } = req.params;
+        const cfg = await fastify.core.sprite.getConfig(projectId);
+        if (cfg && !cfg?.quickSpriteBaseUrl) {
+            const base = (0, sprite_quick_utils_1.getBaseUrl)(cfg);
+            cfg.quickSpriteBaseUrl = base;
+        }
+        return cfg ? toSpriteConfigDto(cfg) : null;
+    });
+    fastify.post("/config/:projectId", async (req) => {
+        const { projectId } = req.params;
+        const body = req.body;
+        if (!body || !body.config) {
+            throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.BAD_REQUEST, "Missing config in request body");
+        }
+        const nextCfg = body.config;
+        const nextAssets = (body.assets || {});
+        const hasLocalImageRoot = !!String(nextCfg.localImageRoot ?? "").trim();
+        const enableQuickSprite = nextCfg.quickSpriteProjectId && nextCfg.quickSpriteEnabled;
+        if (!enableQuickSprite && !nextAssets.iconsSvn && !hasLocalImageRoot) {
+            throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.BAD_REQUEST, "iconsSvn asset or localImageRoot is required");
+        }
+        if (nextCfg.localDir && nextAssets.iconsSvn) {
+            nextAssets.iconsSvn.localDir = node_path_1.default.join(nextCfg.localDir, nextAssets.iconsSvn.label || "icons");
+            if (nextAssets.cutImageSvn) {
+                nextAssets.cutImageSvn.localDir = node_path_1.default.join(nextCfg.localDir, nextAssets.cutImageSvn.label || "images");
+            }
+        }
+        const shouldUpdateAssets = !!(nextAssets.iconsSvn || nextAssets.cutImageSvn);
+        const project = shouldUpdateAssets
+            ? await fastify.core.project.updateAssets(projectId, nextAssets)
+            : await fastify.core.project.get(projectId);
+        if (project.assets?.iconsSvn) {
+            nextCfg.sourceId = project.assets.iconsSvn.id;
+        }
+        const cfg = await fastify.core.sprite.createConfig(projectId, nextCfg);
+        const assets = project.assets
+            ? {
+                iconsSvn: project.assets.iconsSvn,
+                cutImageSvn: project.assets.cutImageSvn,
+            }
+            : undefined;
+        return {
+            cfg: toSpriteConfigDto(cfg),
+            project: { id: project.id, name: project.name, root: project.root, assets },
+        };
+    });
+    fastify.post("/generate/:projectId", async (req) => {
+        const { projectId } = req.params;
+        const body = req.body || {};
+        const quickProjectId = await (0, sprite_quick_utils_1.resolveEnabledRemoteProjectId)(fastify, projectId);
+        if (quickProjectId) {
+            const localCfg = await fastify.core.sprite.getConfig(projectId);
+            const baseUrl = (0, sprite_quick_utils_1.getBaseUrl)(localCfg);
+            const [results, remoteProj] = await Promise.all([
+                (0, sprite_quick_utils_1.quickFetch)(fastify, baseUrl, `/api/project-sprites?projectId=${encodeURIComponent(quickProjectId)}`),
+                (0, sprite_quick_utils_1.fetchRemoteProject)(fastify, baseUrl, quickProjectId),
+            ]);
+            if (!results?.length) {
+                throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.NOT_FOUND, `远端项目「${quickProjectId}」尚未生成任何雪碧图，请先在远端服务中为该项目生成雪碧图后再试`);
+            }
+            return (0, sprite_quick_utils_1.mapQuickGroupsToSnapshot)(projectId, results, remoteProj, localCfg);
+        }
+        const result = await fastify.core.sprite.generate(projectId, {
+            groups: body.groups,
+            forceRefresh: !!body.forceRefresh,
+            concurrency: body.concurrency ?? 1,
+            continueOnError: body.continueOnError ?? true,
+        });
+        return toGenerateSpriteResultDto(result);
+    });
+    fastify.get("/list/:projectId", async (req) => {
+        const { projectId } = req.params;
+        const local = String(req.query?.local ?? "").toLowerCase() === "true";
+        const quickProjectId = await (0, sprite_quick_utils_1.resolveEnabledRemoteProjectId)(fastify, projectId);
+        if (quickProjectId) {
+            const localCfg = await fastify.core.sprite.getConfig(projectId);
+            const baseUrl = (0, sprite_quick_utils_1.getBaseUrl)(localCfg);
+            const [results, remoteProj] = await Promise.all([
+                (0, sprite_quick_utils_1.quickFetch)(fastify, baseUrl, `/api/project-sprites?projectId=${encodeURIComponent(quickProjectId)}`),
+                (0, sprite_quick_utils_1.fetchRemoteProject)(fastify, baseUrl, quickProjectId),
+            ]);
+            return (0, sprite_quick_utils_1.mapQuickGroupsToSnapshot)(projectId, results, remoteProj, localCfg);
+        }
+        const snapshot = await fastify.core.sprite.getSprites(projectId, local);
+        return toSpriteSnapshotDto(snapshot);
+    });
+    fastify.get("/quick/projects", async (_req) => {
+        const baseUrl = (0, sprite_quick_utils_1.getBaseUrl)();
+        const projects = await (0, sprite_quick_utils_1.quickFetch)(fastify, baseUrl, "/api/projects");
+        return projects;
+    });
+    fastify.get("/quick/groups/:projectId", async (req) => {
+        const { projectId } = req.params;
+        const baseUrl = (0, sprite_quick_utils_1.getBaseUrl)();
+        const groups = await (0, sprite_quick_utils_1.quickFetch)(fastify, baseUrl, `/api/groups?projectId=${encodeURIComponent(projectId)}`);
+        return groups;
+    });
+    fastify.get("/proxy/:projectId/:group.png", async (req, reply) => {
+        const { projectId, group } = req.params;
+        const cfg = await fastify.core.sprite.getConfig(projectId);
+        const quickProjectId = cfg?.quickSpriteProjectId;
+        if (!quickProjectId) {
+            throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.NOT_FOUND, `项目「${projectId}」未配置快捷雪碧图远端映射`);
+        }
+        const baseUrl = (0, sprite_quick_utils_1.getBaseUrl)(cfg);
+        const remoteUrl = `${baseUrl}/sprites/${encodeURIComponent(quickProjectId)}/${encodeURIComponent(group)}.png`;
+        fastify.log.info(`[sprite-proxy] → GET ${remoteUrl}`);
+        let response;
+        try {
+            response = await fetch(remoteUrl);
+        }
+        catch (err) {
+            fastify.log.error(`[sprite-proxy] ✗ ${remoteUrl}: ${err?.message || err}`);
+            throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.INTERNAL_ERROR, `无法连接远端雪碧图服务: ${err?.message || err}`);
+        }
+        if (!response.ok) {
+            throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.NOT_FOUND, `远端雪碧图不存在: ${response.status}`);
+        }
+        (0, sprite_quick_utils_1.copyRawResponseHeaders)(response, reply);
+        const body = response.body;
+        if (!body) {
+            return reply.status(response.status).send();
+        }
+        return reply.status(response.status).send(node_stream_1.Readable.fromWeb(body));
+    });
+    fastify.get("/misc-proxy/:quickProjectId/*", async (req, reply) => {
+        const { quickProjectId } = req.params;
+        const filename = req.params["*"];
+        const baseUrl = (0, sprite_quick_utils_1.getBaseUrl)();
+        const remoteUrl = (0, sprite_quick_utils_1.buildRemoteMiscUrl)(baseUrl, quickProjectId, filename);
+        fastify.log.info(`[sprite-misc-proxy] → GET ${remoteUrl}`);
+        let response;
+        try {
+            response = await fetch(remoteUrl);
+        }
+        catch (err) {
+            fastify.log.error(`[sprite-misc-proxy] ✗ ${remoteUrl}: ${err?.message || err}`);
+            throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.INTERNAL_ERROR, `无法连接远端切图服务: ${err?.message || err}`);
+        }
+        if (!response.ok) {
+            throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.NOT_FOUND, `远端切图不存在: ${response.status}`);
+        }
+        (0, sprite_quick_utils_1.copyRawResponseHeaders)(response, reply);
+        const body = response.body;
+        if (!body) {
+            return reply.status(response.status).send();
+        }
+        return reply.status(response.status).send(node_stream_1.Readable.fromWeb(body));
+    });
+}

package/lib/routes/sprite-browse.routes.js

@@ -31,7 +31,7 @@ function listDir(root) {
         .filter(d => !SKIP.has(d.name) && !d.name.startsWith("."))
         .map(d => ({
         name: d.name,
-        kind: d.isDirectory() ? "dir" : "file",
+        kind: (d.isDirectory() ? "dir" : "file"),
         ext: d.isDirectory() ? undefined : node_path_1.default.extname(d.name).toLowerCase(),
     })).sort((a, b) => {
         if (a.kind === b.kind) {
@@ -45,6 +45,12 @@ function countFiles(dir) {
         return 0;
     return node_fs_1.default.readdirSync(dir, { withFileTypes: true }).filter(d => d.isFile()).length;
 }
+function toBrowseEntriesDto(root, entries) {
+    return { root, entries };
+}
+function toBrowseFilesDto(root, dir, entries) {
+    return { root, dir, entries };
+}
 async function spriteBrowseRoutes(fastify) {
     fastify.get("/icons/groups/:projectId", async (req) => {
         const { projectId } = req.params;
@@ -53,7 +59,7 @@ async function spriteBrowseRoutes(fastify) {
         const localRoot = String(cfg?.localImageRoot ?? "").trim();
         const root = localRoot || project?.assets?.iconsSvn?.localDir;
         if (!root) {
-            return { root: "", entries: [] };
+            return toBrowseEntriesDto("", []);
         }
         const entries = listDir(root).filter(e => e.kind === "dir");
         if (localRoot) {
@@ -62,7 +68,7 @@ async function spriteBrowseRoutes(fastify) {
                 entries.unshift({ name: "root", kind: "dir", ext: undefined });
             }
         }
-        return { root, entries };
+        return toBrowseEntriesDto(root, entries);
     });
     fastify.get("/icons/files/:projectId", async (req) => {
         const { projectId } = req.params;
@@ -72,10 +78,10 @@ async function spriteBrowseRoutes(fastify) {
         const localRoot = String(cfg?.localImageRoot ?? "").trim();
         const root = localRoot || project?.assets?.iconsSvn?.localDir;
         if (!root) {
-            return { root: "", entries: [] };
+            return toBrowseEntriesDto("", []);
         }
         const isRootGroup = !!localRoot && (group === "root");
-        const groupDir = isRootGroup ? root : safeJoin(root, group || '');
+        const groupDir = isRootGroup ? root : safeJoin(root, group || "");
         const entries = listDir(groupDir)
             .filter(e => e.kind === "file")
             .map(e => ({
@@ -84,22 +90,22 @@ async function spriteBrowseRoutes(fastify) {
                 ? `/api/static/local/${projectId}/${isRootGroup ? e.name : `${group}/${e.name}`}`
                 : `/api/static/svn/${projectId}/icons/${group}/${e.name}`,
         }));
-        return { root: groupDir, entries };
+        return toBrowseEntriesDto(groupDir, entries);
     });
     fastify.get("/images/list/:projectId", async (req) => {
         const { projectId } = req.params;
         const project = await fastify.core.project.get(projectId);
         const root = project?.assets?.cutImageSvn?.localDir;
         if (!root) {
-            return { root: "", entries: [] };
+            return toBrowseEntriesDto("", []);
         }
         const dir = String(req.query?.dir ?? "").trim();
         if (dir.split(/[\\/]/g).some(seg => seg === "..")) {
-            return { root, dir: "", entries: [] };
+            return toBrowseFilesDto(root, "", []);
         }
         const absDir = dir ? safeJoin(root, dir) : root;
         if (!node_fs_1.default.existsSync(absDir))
-            return { root, dir, entries: [] };
+            return toBrowseFilesDto(root, dir, []);
         const entries = listDir(absDir).map(e => {
             if (e.kind === "file") {
                 const rel = dir ? `${dir}/${e.name}` : e.name;
@@ -112,11 +118,11 @@ async function spriteBrowseRoutes(fastify) {
                 const rel = dir ? `${dir}/${e.name}` : e.name;
                 return {
                     ...e,
-                    fileCount: countFiles(safeJoin(root, rel))
+                    fileCount: countFiles(safeJoin(root, rel)),
                 };
             }
             return e;
         });
-        return { root, dir, entries };
+        return toBrowseFilesDto(root, dir, entries);
     });
 }

package/lib/routes/sprite.routes.d.ts

@@ -1,2 +1,2 @@
-import { FastifyInstance } from "fastify";
+import type { FastifyInstance } from "fastify";
 export declare function spriteRoutes(fastify: FastifyInstance): Promise<void>;

package/lib/routes/sprite.routes.js

@@ -6,27 +6,75 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.spriteRoutes = spriteRoutes;
 const node_path_1 = __importDefault(require("node:path"));
 const errors_1 = require("@yinuo-ngm/errors");
+function toSpriteConfigDto(cfg) {
+    return {
+        projectId: cfg.projectId,
+        enabled: cfg.enabled,
+        sourceId: cfg.sourceId,
+        localDir: cfg.localDir,
+        prefix: cfg.prefix,
+        template: cfg.template,
+        spriteUrl: cfg.spriteUrl,
+        spriteExportDir: cfg.spriteExportDir,
+        lessExportDir: cfg.lessExportDir,
+        algorithm: cfg.algorithm,
+        persistLess: cfg.persistLess,
+        updatedAt: cfg.updatedAt,
+        localImageRoot: cfg.localImageRoot,
+        localCacheDir: cfg.localCacheDir,
+    };
+}
+function toSpriteGroupItemDto(item) {
+    return {
+        group: item.group,
+        kind: item.kind,
+        previewSpriteUrl: item.previewSpriteUrl,
+        spriteUrl: item.spriteUrl,
+        meta: item.meta,
+        lessText: item.lessText,
+        exported: item.exported,
+        status: item.status,
+        error: item.error,
+    };
+}
+function toSpriteSnapshotDto(snapshot) {
+    return {
+        projectId: snapshot.projectId,
+        sourceId: snapshot.sourceId,
+        iconsRoot: snapshot.iconsRoot,
+        cacheOutDir: snapshot.cacheOutDir,
+        config: toSpriteConfigDto(snapshot.config),
+        total: snapshot.total,
+        success: snapshot.success,
+        failed: snapshot.failed,
+        groups: (snapshot.groups ?? []).map(toSpriteGroupItemDto),
+    };
+}
+function toGenerateSpriteResultDto(snapshot) {
+    return toSpriteSnapshotDto(snapshot);
+}
 async function spriteRoutes(fastify) {
     fastify.get("/config/:projectId", async (req) => {
         const { projectId } = req.params;
-        return await fastify.core.sprite.getConfig(projectId);
+        const cfg = await fastify.core.sprite.getConfig(projectId);
+        return cfg ? toSpriteConfigDto(cfg) : null;
     });
     fastify.post("/config/:projectId", async (req) => {
         const { projectId } = req.params;
         const body = req.body;
         if (!body || !body.config) {
-            throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.BAD_REQUEST, 'Missing config in request body');
+            throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.BAD_REQUEST, "Missing config in request body");
         }
         const nextCfg = body.config;
-        const nextAssets = body.assets || {};
+        const nextAssets = (body.assets || {});
         const hasLocalImageRoot = !!String(nextCfg.localImageRoot ?? "").trim();
         if (!nextAssets.iconsSvn && !hasLocalImageRoot) {
-            throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.BAD_REQUEST, 'iconsSvn asset or localImageRoot is required');
+            throw new errors_1.GlobalError(errors_1.GlobalErrorCodes.BAD_REQUEST, "iconsSvn asset or localImageRoot is required");
         }
         if (nextCfg.localDir && nextAssets.iconsSvn) {
-            nextAssets.iconsSvn.localDir = node_path_1.default.join(nextCfg.localDir, nextAssets.iconsSvn.label || 'icons');
+            nextAssets.iconsSvn.localDir = node_path_1.default.join(nextCfg.localDir, nextAssets.iconsSvn.label || "icons");
             if (nextAssets.cutImageSvn) {
-                nextAssets.cutImageSvn.localDir = node_path_1.default.join(nextCfg.localDir, nextAssets.cutImageSvn.label || 'images');
+                nextAssets.cutImageSvn.localDir = node_path_1.default.join(nextCfg.localDir, nextAssets.cutImageSvn.label || "images");
             }
         }
         const shouldUpdateAssets = !!(nextAssets.iconsSvn || nextAssets.cutImageSvn);
@@ -37,7 +85,16 @@ async function spriteRoutes(fastify) {
             nextCfg.sourceId = project.assets.iconsSvn.id;
         }
         const cfg = await fastify.core.sprite.createConfig(projectId, nextCfg);
-        return { cfg, project };
+        const assets = project.assets
+            ? {
+                iconsSvn: project.assets.iconsSvn,
+                cutImageSvn: project.assets.cutImageSvn,
+            }
+            : undefined;
+        return {
+            cfg: toSpriteConfigDto(cfg),
+            project: { id: project.id, name: project.name, root: project.root, assets },
+        };
     });
     fastify.post("/generate/:projectId", async (req) => {
         const { projectId } = req.params;
@@ -48,12 +105,12 @@ async function spriteRoutes(fastify) {
             concurrency: body.concurrency ?? 1,
             continueOnError: body.continueOnError ?? true,
         });
-        return result;
+        return toGenerateSpriteResultDto(result);
     });
     fastify.get("/list/:projectId", async (req) => {
         const { projectId } = req.params;
-        const query = req.query;
-        const local = String(query['local'] ?? '').toLowerCase() === 'true';
-        return await fastify.core.sprite.getSprites(projectId, local);
+        const local = String(req.query?.local ?? "").toLowerCase() === "true";
+        const snapshot = await fastify.core.sprite.getSprites(projectId, local);
+        return toSpriteSnapshotDto(snapshot);
     });
 }