repoimage 0.2.0

package/server/dist/server.js

@@ -0,0 +1,313 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRepoimageServer = createRepoimageServer;
+const http_1 = __importDefault(require("http"));
+const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+const shared_1 = require("@repoimage/shared");
+const fs_list_1 = require("./fs-list");
+const scan_1 = require("./scan");
+const paths_1 = require("./paths");
+const MAX_SCAN_ENTRIES = 100_000;
+function isLoopbackAddress(addr) {
+    if (addr == null)
+        return true;
+    const a = String(addr);
+    return a === '127.0.0.1' || a === '::1' || a === '::ffff:127.0.0.1';
+}
+function assertLoopbackForFsApi(req, res) {
+    if (process.env.REPOIMAGE_FS_TRUST_REMOTE === '1') {
+        return true;
+    }
+    const addr = req.socket.remoteAddress;
+    if (!isLoopbackAddress(addr)) {
+        sendJson(res, 403, {
+            error: 'Filesystem API is only available to loopback clients. Set REPOIMAGE_FS_TRUST_REMOTE=1 to disable this check (not recommended).'
+        });
+        return false;
+    }
+    return true;
+}
+function resolveScanFolders(body) {
+    if (typeof body.folder === 'string' && body.folder.trim()) {
+        return [body.folder.trim()];
+    }
+    if (Array.isArray(body.folders)) {
+        return body.folders
+            .map(f => (typeof f === 'string' ? f.trim() : ''))
+            .filter(Boolean);
+    }
+    return [];
+}
+const IMAGE_FILE_EXTS = new Set(shared_1.IMAGE_EXTENSIONS);
+const MIME = {
+    '.html': 'text/html; charset=utf-8',
+    '.css': 'text/css; charset=utf-8',
+    '.js': 'application/javascript; charset=utf-8',
+    '.json': 'application/json; charset=utf-8',
+    '.ico': 'image/x-icon',
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif',
+    '.bmp': 'image/bmp',
+    '.tif': 'image/tiff',
+    '.tiff': 'image/tiff',
+    '.webp': 'image/webp',
+    '.svg': 'image/svg+xml',
+    '.avif': 'image/avif',
+    '.heic': 'image/heic',
+    '.heif': 'image/heif'
+};
+function readJsonBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on('data', chunk => chunks.push(chunk));
+        req.on('end', () => {
+            const raw = Buffer.concat(chunks).toString('utf8');
+            if (!raw.trim()) {
+                resolve({});
+                return;
+            }
+            try {
+                resolve(JSON.parse(raw));
+            }
+            catch (e) {
+                reject(e);
+            }
+        });
+        req.on('error', reject);
+    });
+}
+function send(res, status, body, headers = {}) {
+    const buf = Buffer.isBuffer(body) ? body : Buffer.from(body, 'utf8');
+    res.writeHead(status, {
+        'Content-Length': buf.length,
+        ...headers
+    });
+    res.end(buf);
+}
+function sendJson(res, status, obj) {
+    send(res, status, JSON.stringify(obj), {
+        'Content-Type': 'application/json; charset=utf-8'
+    });
+}
+function createRepoimageServer(options = {}) {
+    const clientRoot = path_1.default.resolve(options.clientRoot ?? (0, paths_1.defaultClientRoot)());
+    function safeStaticFile(urlPath) {
+        const decoded = decodeURIComponent((urlPath || '').split('?')[0]);
+        if (decoded.includes('..')) {
+            return null;
+        }
+        const rel = decoded === '/' || decoded === '' ? 'index.html' : decoded.replace(/^\/+/, '');
+        const full = path_1.default.resolve(path_1.default.join(clientRoot, rel));
+        const root = path_1.default.resolve(clientRoot);
+        if (full !== root && !full.startsWith(root + path_1.default.sep)) {
+            return null;
+        }
+        return full;
+    }
+    function serveSpaIndex(res) {
+        const indexPath = path_1.default.join(clientRoot, 'index.html');
+        if (!fs_1.default.existsSync(indexPath)) {
+            send(res, 503, 'Client not built. Run npm run build from the repo root.', { 'Content-Type': 'text/plain; charset=utf-8' });
+            return;
+        }
+        send(res, 200, fs_1.default.readFileSync(indexPath), {
+            'Content-Type': 'text/html; charset=utf-8'
+        });
+    }
+    return http_1.default.createServer(async (req, res) => {
+        const url = new URL(req.url || '/', `http://${req.headers.host || 'localhost'}`);
+        if (req.method === 'POST' && url.pathname === '/api/scan') {
+            try {
+                const body = await readJsonBody(req);
+                const rawFolders = resolveScanFolders(body);
+                const normalized = rawFolders.map(f => path_1.default.resolve(f)).filter(Boolean);
+                if (normalized.length === 0) {
+                    sendJson(res, 400, {
+                        error: 'Provide a project root: non-empty string "folder" or "folders" array.'
+                    });
+                    return;
+                }
+                const sortByScore = Boolean(body.sortByScore);
+                const excludeCommon = Boolean(body.excludeCommonFolders);
+                const { images, issues } = (0, scan_1.findImagesInFolders)(normalized, {
+                    verbose: false,
+                    excludeCommon
+                });
+                const imagesOut = sortByScore ? (0, scan_1.sortByCompressionScore)(images) : images;
+                sendJson(res, 200, { images: imagesOut, issues });
+            }
+            catch (e) {
+                sendJson(res, 400, {
+                    error: 'Invalid JSON body',
+                    detail: String(e instanceof Error ? e.message : e)
+                });
+            }
+            return;
+        }
+        if (req.method === 'POST' && url.pathname === '/api/scan-entries') {
+            try {
+                const body = await readJsonBody(req);
+                const entries = Array.isArray(body.entries) ? body.entries : [];
+                if (entries.length === 0) {
+                    sendJson(res, 400, { error: 'Provide a non-empty "entries" array.' });
+                    return;
+                }
+                if (entries.length > MAX_SCAN_ENTRIES) {
+                    sendJson(res, 400, {
+                        error: `Too many entries (max ${MAX_SCAN_ENTRIES}).`
+                    });
+                    return;
+                }
+                const images = [];
+                for (const raw of entries) {
+                    const row = (0, scan_1.enrichImageEntry)(raw);
+                    if (row) {
+                        images.push(row);
+                    }
+                }
+                const sortByScore = Boolean(body.sortByScore);
+                const imagesOut = sortByScore ? (0, scan_1.sortByCompressionScore)(images) : images;
+                sendJson(res, 200, { images: imagesOut, issues: [] });
+            }
+            catch (e) {
+                sendJson(res, 400, {
+                    error: 'Invalid JSON body',
+                    detail: String(e instanceof Error ? e.message : e)
+                });
+            }
+            return;
+        }
+        if (url.pathname === '/api/fs/list') {
+            if (!assertLoopbackForFsApi(req, res)) {
+                return;
+            }
+            let rawPath = '';
+            if (req.method === 'GET') {
+                rawPath = url.searchParams.get('path') ?? '';
+            }
+            else if (req.method === 'POST') {
+                try {
+                    const body = await readJsonBody(req);
+                    rawPath = typeof body.path === 'string' ? body.path : '';
+                }
+                catch {
+                    sendJson(res, 400, { error: 'Invalid JSON body' });
+                    return;
+                }
+            }
+            else {
+                send(res, 405, 'Method not allowed', { 'Content-Type': 'text/plain; charset=utf-8' });
+                return;
+            }
+            const trimmed = rawPath.trim();
+            if (!trimmed) {
+                sendJson(res, 400, {
+                    error: 'Missing path. Use GET ?path=/absolute/path or POST JSON { "path": "/absolute/path" }.'
+                });
+                return;
+            }
+            const result = (0, fs_list_1.listDirectory)(trimmed);
+            if ('error' in result) {
+                let code = 400;
+                if (result.error === 'ENOENT')
+                    code = 404;
+                else if (result.error === 'ENOTDIR')
+                    code = 400;
+                else if (result.error === 'EACCES' || result.error === 'ESTAT')
+                    code = 403;
+                sendJson(res, code, result);
+                return;
+            }
+            sendJson(res, 200, result);
+            return;
+        }
+        if (req.method === 'GET' && url.pathname === '/api/fs/home') {
+            if (!assertLoopbackForFsApi(req, res)) {
+                return;
+            }
+            const home = os_1.default.homedir();
+            sendJson(res, 200, { path: home.split(path_1.default.sep).join('/') });
+            return;
+        }
+        if (req.method === 'GET' && url.pathname === '/api/file') {
+            if (!assertLoopbackForFsApi(req, res)) {
+                return;
+            }
+            const raw = url.searchParams.get('path') ?? '';
+            const trimmed = raw.trim();
+            if (!trimmed) {
+                sendJson(res, 400, { error: 'Missing path. Use ?path=/absolute/path/to/image.png' });
+                return;
+            }
+            const resolved = path_1.default.resolve(trimmed);
+            const ext = path_1.default.extname(resolved).toLowerCase();
+            if (!IMAGE_FILE_EXTS.has(ext)) {
+                sendJson(res, 403, { error: 'Not an allowed image type.' });
+                return;
+            }
+            let st;
+            try {
+                st = fs_1.default.statSync(resolved);
+            }
+            catch (e) {
+                const err = e;
+                const code = err.code === 'ENOENT' ? 404 : 403;
+                sendJson(res, code, {
+                    error: err.code ?? 'ESTAT',
+                    message: String(err.message || e)
+                });
+                return;
+            }
+            if (!st.isFile()) {
+                sendJson(res, 400, { error: 'ENOTFILE', message: 'Path is not a file.' });
+                return;
+            }
+            const type = MIME[ext] || 'application/octet-stream';
+            send(res, 200, fs_1.default.readFileSync(resolved), { 'Content-Type': type });
+            return;
+        }
+        if (req.method === 'GET') {
+            let filePath = safeStaticFile(url.pathname);
+            if (!filePath) {
+                send(res, 403, 'Forbidden', { 'Content-Type': 'text/plain; charset=utf-8' });
+                return;
+            }
+            if (fs_1.default.existsSync(filePath) && fs_1.default.statSync(filePath).isDirectory()) {
+                filePath = path_1.default.join(filePath, 'index.html');
+            }
+            if (!fs_1.default.existsSync(filePath) || !fs_1.default.statSync(filePath).isFile()) {
+                if (!url.pathname.startsWith('/api')) {
+                    serveSpaIndex(res);
+                    return;
+                }
+                send(res, 404, 'Not found', { 'Content-Type': 'text/plain; charset=utf-8' });
+                return;
+            }
+            const ext = path_1.default.extname(filePath).toLowerCase();
+            const type = MIME[ext] || 'application/octet-stream';
+            send(res, 200, fs_1.default.readFileSync(filePath), { 'Content-Type': type });
+            return;
+        }
+        send(res, 405, 'Method not allowed', { 'Content-Type': 'text/plain; charset=utf-8' });
+    });
+}
+if (require.main === module) {
+    const requested = process.env.PORT;
+    const port = requested !== undefined && requested !== '' ? Number(requested) : 3847;
+    const host = process.env.REPOIMAGE_BIND || '127.0.0.1';
+    const server = createRepoimageServer();
+    server.listen(port, host, () => {
+        const addr = server.address();
+        const p = typeof addr === 'object' && addr ? addr.port : port;
+        const h = typeof addr === 'object' && addr ? addr.address : host;
+        process.stderr.write(`RepoImage GUI: http://${h}:${p}/\n`);
+    });
+}
+//# sourceMappingURL=server.js.map

package/server/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";;;;;AAqHA,sDAiOC;AAtVD,gDAAwB;AACxB,4CAAoB;AACpB,4CAAoB;AACpB,gDAAwB;AACxB,8CAAqD;AACrD,uCAA0C;AAC1C,iCAIgB;AAChB,mCAA4C;AAE5C,MAAM,gBAAgB,GAAG,OAAO,CAAC;AAEjC,SAAS,iBAAiB,CAAC,IAAwB;IACjD,IAAI,IAAI,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IAC9B,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IACvB,OAAO,CAAC,KAAK,WAAW,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,kBAAkB,CAAC;AACtE,CAAC;AAED,SAAS,sBAAsB,CAC7B,GAAyB,EACzB,GAAwB;IAExB,IAAI,OAAO,CAAC,GAAG,CAAC,yBAAyB,KAAK,GAAG,EAAE,CAAC;QAClD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC;IACtC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE;YACjB,KAAK,EACH,gIAAgI;SACnI,CAAC,CAAC;QACH,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,kBAAkB,CAAC,IAA6B;IACvD,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QAC1D,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAC9B,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC,OAAO;aAChB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;aACjD,MAAM,CAAC,OAAO,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,eAAe,GAAG,IAAI,GAAG,CAAS,yBAAgB,CAAC,CAAC;AAE1D,MAAM,IAAI,GAA2B;IACnC,OAAO,EAAE,0BAA0B;IACnC,MAAM,EAAE,yBAAyB;IACjC,KAAK,EAAE,uCAAuC;IAC9C,OAAO,EAAE,iCAAiC;IAC1C,MAAM,EAAE,cAAc;IACtB,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,YAAY;IACrB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,eAAe;IACvB,OAAO,EAAE,YAAY;IACrB,OAAO,EAAE,YAAY;IACrB,OAAO,EAAE,YAAY;CACtB,CAAC;AAEF,SAAS,YAAY,CAAC,GAAyB;IAC7C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAC5C,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;YACjB,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACnD,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;gBAChB,OAAO,CAAC,EAAE,CAAC,CAAC;gBACZ,OAAO;YACT,CAAC;YACD,IAAI,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAC,CAAC;YACtD,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,CAAC,CAAC,CAAC,CAAC;YACZ,CAAC;QACH,CAAC,CAAC,CAAC;QACH,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,IAAI,CACX,GAAwB,EACxB,MAAc,EACd,IAAqB,EACrB,UAAkC,EAAE;IAEpC,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACrE,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE;QACpB,gBAAgB,EAAE,GAAG,CAAC,MAAM;QAC5B,GAAG,OAAO;KACX,CAAC,CAAC;IACH,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED,SAAS,QAAQ,CAAC,GAAwB,EAAE,MAAc,EAAE,GAAY;IACtE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE;QACrC,cAAc,EAAE,iCAAiC;KAClD,CAAC,CAAC;AACL,CAAC;AAMD,SAAgB,qBAAqB,CAAC,UAAkC,EAAE;IACxE,MAAM,UAAU,GAAG,cAAI,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,IAAI,IAAA,yBAAiB,GAAE,CAAC,CAAC;IAE3E,SAAS,cAAc,CAAC,OAAe;QACrC,MAAM,OAAO,GAAG,kBAAkB,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAClE,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,GAAG,GAAG,OAAO,KAAK,GAAG,IAAI,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC3F,MAAM,IAAI,GAAG,cAAI,CAAC,OAAO,CAAC,cAAI,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC;QACtD,MAAM,IAAI,GAAG,cAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACtC,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,GAAG,cAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACvD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,SAAS,aAAa,CAAC,GAAwB;QAC7C,MAAM,SAAS,GAAG,cAAI,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QACtD,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,IAAI,CACF,GAAG,EACH,GAAG,EACH,yDAAyD,EACzD,EAAE,cAAc,EAAE,2BAA2B,EAAE,CAChD,CAAC;YACF,OAAO;QACT,CAAC;QACD,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,YAAE,CAAC,YAAY,CAAC,SAAS,CAAC,EAAE;YACzC,cAAc,EAAE,0BAA0B;SAC3C,CAAC,CAAC;IACL,CAAC;IAED,OAAO,cAAI,CAAC,YAAY,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QAC1C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,EAAE,UAAU,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,WAAW,EAAE,CAAC,CAAC;QAEjF,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,IAAI,GAAG,CAAC,QAAQ,KAAK,WAAW,EAAE,CAAC;YAC1D,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,GAAG,CAAC,CAAC;gBACrC,MAAM,UAAU,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;gBAC5C,MAAM,UAAU,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,cAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBAExE,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC5B,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE;wBACjB,KAAK,EAAE,uEAAuE;qBAC/E,CAAC,CAAC;oBACH,OAAO;gBACT,CAAC;gBAED,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;gBAC9C,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;gBACzD,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAA,0BAAmB,EAAC,UAAU,EAAE;oBACzD,OAAO,EAAE,KAAK;oBACd,aAAa;iBACd,CAAC,CAAC;gBACH,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,CAAC,IAAA,6BAAsB,EAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;gBAExE,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;YACpD,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE;oBACjB,KAAK,EAAE,mBAAmB;oBAC1B,MAAM,EAAE,MAAM,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;iBACnD,CAAC,CAAC;YACL,CAAC;YACD,OAAO;QACT,CAAC;QAED,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,IAAI,GAAG,CAAC,QAAQ,KAAK,mBAAmB,EAAE,CAAC;YAClE,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,GAAG,CAAC,CAAC;gBACrC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;gBAEhE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACzB,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,sCAAsC,EAAE,CAAC,CAAC;oBACtE,OAAO;gBACT,CAAC;gBAED,IAAI,OAAO,CAAC,MAAM,GAAG,gBAAgB,EAAE,CAAC;oBACtC,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE;wBACjB,KAAK,EAAE,yBAAyB,gBAAgB,IAAI;qBACrD,CAAC,CAAC;oBACH,OAAO;gBACT,CAAC;gBAED,MAAM,MAAM,GAAG,EAAE,CAAC;gBAClB,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;oBAC1B,MAAM,GAAG,GAAG,IAAA,uBAAgB,EAAC,GAA6C,CAAC,CAAC;oBAC5E,IAAI,GAAG,EAAE,CAAC;wBACR,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;oBACnB,CAAC;gBACH,CAAC;gBAED,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;gBAC9C,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,CAAC,IAAA,6BAAsB,EAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;gBAExE,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;YACxD,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE;oBACjB,KAAK,EAAE,mBAAmB;oBAC1B,MAAM,EAAE,MAAM,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;iBACnD,CAAC,CAAC;YACL,CAAC;YACD,OAAO;QACT,CAAC;QAED,IAAI,GAAG,CAAC,QAAQ,KAAK,cAAc,EAAE,CAAC;YACpC,IAAI,CAAC,sBAAsB,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;gBACtC,OAAO;YACT,CAAC;YAED,IAAI,OAAO,GAAG,EAAE,CAAC;YACjB,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;gBACzB,OAAO,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YAC/C,CAAC;iBAAM,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;gBACjC,IAAI,CAAC;oBACH,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,GAAG,CAAC,CAAC;oBACrC,OAAO,GAAG,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3D,CAAC;gBAAC,MAAM,CAAC;oBACP,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC,CAAC;oBACnD,OAAO;gBACT,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,oBAAoB,EAAE,EAAE,cAAc,EAAE,2BAA2B,EAAE,CAAC,CAAC;gBACtF,OAAO;YACT,CAAC;YAED,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;YAC/B,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE;oBACjB,KAAK,EACH,uFAAuF;iBAC1F,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YAED,MAAM,MAAM,GAAG,IAAA,uBAAa,EAAC,OAAO,CAAC,CAAC;YACtC,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;gBACtB,IAAI,IAAI,GAAG,GAAG,CAAC;gBACf,IAAI,MAAM,CAAC,KAAK,KAAK,QAAQ;oBAAE,IAAI,GAAG,GAAG,CAAC;qBACrC,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;oBAAE,IAAI,GAAG,GAAG,CAAC;qBAC3C,IAAI,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,KAAK,OAAO;oBAAE,IAAI,GAAG,GAAG,CAAC;gBAC3E,QAAQ,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;gBAC5B,OAAO;YACT,CAAC;YAED,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;YAC3B,OAAO;QACT,CAAC;QAED,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,IAAI,GAAG,CAAC,QAAQ,KAAK,cAAc,EAAE,CAAC;YAC5D,IAAI,CAAC,sBAAsB,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;gBACtC,OAAO;YACT,CAAC;YACD,MAAM,IAAI,GAAG,YAAE,CAAC,OAAO,EAAE,CAAC;YAC1B,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,cAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC7D,OAAO;QACT,CAAC;QAED,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,IAAI,GAAG,CAAC,QAAQ,KAAK,WAAW,EAAE,CAAC;YACzD,IAAI,CAAC,sBAAsB,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;gBACtC,OAAO;YACT,CAAC;YAED,MAAM,GAAG,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YAC/C,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;YAC3B,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,qDAAqD,EAAE,CAAC,CAAC;gBACrF,OAAO;YACT,CAAC;YAED,MAAM,QAAQ,GAAG,cAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YACvC,MAAM,GAAG,GAAG,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;YACjD,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC9B,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,4BAA4B,EAAE,CAAC,CAAC;gBAC5D,OAAO;YACT,CAAC;YAED,IAAI,EAAY,CAAC;YACjB,IAAI,CAAC;gBACH,EAAE,GAAG,YAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAC7B,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,GAAG,GAAG,CAA0B,CAAC;gBACvC,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;gBAC/C,QAAQ,CAAC,GAAG,EAAE,IAAI,EAAE;oBAClB,KAAK,EAAE,GAAG,CAAC,IAAI,IAAI,OAAO;oBAC1B,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC;iBAClC,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YAED,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC;gBACjB,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,qBAAqB,EAAE,CAAC,CAAC;gBAC1E,OAAO;YACT,CAAC;YAED,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,0BAA0B,CAAC;YACrD,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,YAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC;YACpE,OAAO;QACT,CAAC;QAED,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;YACzB,IAAI,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC5C,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,WAAW,EAAE,EAAE,cAAc,EAAE,2BAA2B,EAAE,CAAC,CAAC;gBAC7E,OAAO;YACT,CAAC;YACD,IAAI,YAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,YAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;gBACnE,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;YAC/C,CAAC;YACD,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;gBAChE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;oBACrC,aAAa,CAAC,GAAG,CAAC,CAAC;oBACnB,OAAO;gBACT,CAAC;gBACD,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,WAAW,EAAE,EAAE,cAAc,EAAE,2BAA2B,EAAE,CAAC,CAAC;gBAC7E,OAAO;YACT,CAAC;YACD,MAAM,GAAG,GAAG,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;YACjD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,0BAA0B,CAAC;YACrD,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,YAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC;YACpE,OAAO;QACT,CAAC;QAED,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,oBAAoB,EAAE,EAAE,cAAc,EAAE,2BAA2B,EAAE,CAAC,CAAC;IACxF,CAAC,CAAC,CAAC;AACL,CAAC;AAED,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;IACnC,MAAM,IAAI,GAAG,SAAS,KAAK,SAAS,IAAI,SAAS,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACpF,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,WAAW,CAAC;IACvD,MAAM,MAAM,GAAG,qBAAqB,EAAE,CAAC;IACvC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE;QAC7B,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;QAC9B,MAAM,CAAC,GAAG,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QAC9D,MAAM,CAAC,GAAG,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;QACjE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yBAAyB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC"}

package/server/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@repoimage/server",
+  "version": "1.0.0",
+  "private": true,
+  "main": "./dist/server.js",
+  "bin": {
+    "repoimage": "./dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsx watch src/server.ts",
+    "start": "node dist/server.js"
+  },
+  "dependencies": {
+    "@repoimage/shared": "*",
+    "image-size": "^1.0.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "tsx": "^4.19.0"
+  }
+}

package/server/src/cli.ts

@@ -0,0 +1,63 @@
+#!/usr/bin/env node
+
+import { findImagesInFolders, sortByCompressionScore } from './scan';
+
+const args = process.argv.slice(2);
+const jsonMode = args.includes('--json');
+const sortByScore = args.includes('--sort-by-score');
+const folders = args.filter(arg => !arg.startsWith('--'));
+
+if (folders.length === 0) {
+  const usage =
+    'Usage: repoimage [--json] [--sort-by-score] <folder1> [folder2] ...\n' +
+    'Example: repoimage --json /path/to/repo\n' +
+    '         repoimage --sort-by-score /path/to/Pictures';
+  if (jsonMode) {
+    process.stderr.write(`${usage}\n`);
+  } else {
+    console.log(usage);
+  }
+  process.exit(1);
+}
+
+let { images, issues } = findImagesInFolders(folders, { verbose: !jsonMode });
+
+if (sortByScore) {
+  images = sortByCompressionScore(images);
+}
+
+if (jsonMode) {
+  process.stdout.write(JSON.stringify({ images, issues }));
+  process.stdout.write('\n');
+  process.exit(0);
+}
+
+if (issues.length) {
+  for (const issue of issues) {
+    console.error(issue.message);
+  }
+  if (issues.some(i => i.code === 'MISSING_FOLDER')) {
+    console.error('');
+  }
+}
+
+function formatFileSize(bytes: number): string {
+  if (bytes === 0) return '0 B';
+  const k = 1024;
+  const sizes = ['B', 'KB', 'MB', 'GB'];
+  const i = Math.floor(Math.log(bytes) / Math.log(k));
+  return `${parseFloat((bytes / k ** i).toFixed(2))} ${sizes[i]}`;
+}
+
+console.log(`\nFound ${images.length} images:`);
+images.forEach((image, index) => {
+  const dimensions =
+    image.width && image.height ? `${image.width}x${image.height}` : 'unknown';
+  const compression = image.compressionRatio ? `${image.compressionRatio}/10` : 'N/A';
+  console.log(
+    `${index + 1}. ${image.path} (${formatFileSize(image.size)}, ${dimensions}, compression: ${compression})`
+  );
+});
+
+const totalSize = images.reduce((sum, image) => sum + image.size, 0);
+console.log(`\nTotal: ${images.length} images found (${formatFileSize(totalSize)})`);

package/server/src/fs-list.ts

@@ -0,0 +1,70 @@
+import fs from 'fs';
+import path from 'path';
+import type { FsListEntry, FsListResult } from '@repoimage/shared';
+
+function typeFromDirent(d: fs.Dirent): FsListEntry['type'] {
+  if (d.isSymbolicLink()) return 'symlink';
+  if (d.isDirectory()) return 'directory';
+  if (d.isFile()) return 'file';
+  return 'other';
+}
+
+export function listDirectory(inputPath: string): FsListResult {
+  const resolved = path.resolve(inputPath);
+
+  if (!fs.existsSync(resolved)) {
+    return { error: 'ENOENT', message: `Path not found: ${resolved}` };
+  }
+
+  let st: fs.Stats;
+  try {
+    st = fs.statSync(resolved);
+  } catch (e) {
+    return {
+      error: 'ESTAT',
+      message: e instanceof Error ? e.message : String(e)
+    };
+  }
+
+  if (!st.isDirectory()) {
+    return { error: 'ENOTDIR', message: `Not a directory: ${resolved}` };
+  }
+
+  let dirents: fs.Dirent[];
+  try {
+    dirents = fs.readdirSync(resolved, { withFileTypes: true });
+  } catch (e) {
+    return {
+      error: 'EACCES',
+      message: e instanceof Error ? e.message : String(e)
+    };
+  }
+
+  const entries: FsListEntry[] = dirents.map(d => {
+    const name = d.name;
+    const fullPath = path.join(resolved, name);
+    return {
+      name,
+      path: fullPath.split(path.sep).join('/'),
+      type: typeFromDirent(d)
+    };
+  });
+
+  entries.sort((a, b) => {
+    const order: Record<FsListEntry['type'], number> = {
+      directory: 0,
+      symlink: 1,
+      file: 2,
+      other: 3
+    };
+    const oa = order[a.type] ?? 3;
+    const ob = order[b.type] ?? 3;
+    if (oa !== ob) return oa - ob;
+    return a.name.localeCompare(b.name, undefined, { sensitivity: 'base' });
+  });
+
+  return {
+    path: resolved.split(path.sep).join('/'),
+    entries
+  };
+}

package/server/src/paths.ts

@@ -0,0 +1,6 @@
+import path from 'path';
+
+/** Default production client bundle: `client/dist` from repo root. */
+export function defaultClientRoot(): string {
+  return path.resolve(__dirname, '../../client/dist');
+}