@macrulez/devtoolz 0.4.1 → 0.4.2

package/dist/commands/ui/fs-routes.js

@@ -0,0 +1,135 @@
+import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, extname, isAbsolute, join, parse, resolve } from 'node:path';
+import { DEFAULT_IMAGE_EXTENSIONS } from '../image-hash/core.js';
+import { defaultSharpLoaderDeps } from '../image-hash/sharp-loader.js';
+import { HttpError, sendBytes, sendJson } from './http.js';
+const IMAGE_EXTENSIONS = new Set([...DEFAULT_IMAGE_EXTENSIONS, '.svg']);
+const BROWSER_TYPES = {
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.png': 'image/png',
+    '.webp': 'image/webp',
+    '.gif': 'image/gif',
+    '.avif': 'image/avif',
+    '.svg': 'image/svg+xml',
+};
+const MAX_ENTRIES = 5000;
+const MAX_RAW_BYTES = 20 * 1024 * 1024;
+const SHARP_RETRY_MS = 5000;
+let sharpCache;
+export function findSharp(cwd) {
+    if (sharpCache?.factory)
+        return sharpCache.factory;
+    if (sharpCache && Date.now() - sharpCache.checked < SHARP_RETRY_MS)
+        return null;
+    const deps = defaultSharpLoaderDeps();
+    const factory = deps.resolveBundled() ?? deps.resolveFromCwd(cwd) ?? deps.resolveManaged();
+    sharpCache = { factory, checked: Date.now() };
+    return factory;
+}
+export function forgetSharp() {
+    sharpCache = undefined;
+}
+export function isImagePath(path) {
+    return IMAGE_EXTENSIONS.has(extname(path).toLowerCase());
+}
+function roots() {
+    if (process.platform !== 'win32')
+        return ['/'];
+    const found = [];
+    for (let code = 65; code <= 90; code++) {
+        const drive = `${String.fromCharCode(code)}:\\`;
+        if (existsSync(drive))
+            found.push(drive);
+    }
+    return found;
+}
+export function resolveUserPath(raw, fallback) {
+    if (raw === null || raw.trim() === '')
+        return fallback;
+    const path = raw.trim();
+    return isAbsolute(path) ? resolve(path) : resolve(fallback, path);
+}
+export const fsRoutes = [
+    {
+        method: 'GET',
+        path: '/api/fs/list',
+        handler: ({ res, url, server }) => {
+            const path = resolveUserPath(url.searchParams.get('path'), server.cwd);
+            const showHidden = url.searchParams.get('hidden') === '1';
+            const stat = statSync(path, { throwIfNoEntry: false });
+            if (!stat?.isDirectory())
+                throw new HttpError(404, `${path} is not a folder`);
+            let names;
+            try {
+                names = readdirSync(path, { withFileTypes: true });
+            }
+            catch (error) {
+                throw new HttpError(403, error instanceof Error ? error.message : String(error));
+            }
+            const folders = [];
+            const images = [];
+            for (const entry of names) {
+                if (!showHidden && entry.name.startsWith('.'))
+                    continue;
+                if (entry.isDirectory())
+                    folders.push({ name: entry.name, kind: 'dir' });
+                else if (entry.isFile() && isImagePath(entry.name)) {
+                    const size = statSync(join(path, entry.name), { throwIfNoEntry: false })?.size ?? 0;
+                    images.push({ name: entry.name, kind: 'image', size });
+                }
+            }
+            folders.sort((a, b) => a.name.localeCompare(b.name));
+            images.sort((a, b) => a.name.localeCompare(b.name));
+            const entries = [...folders, ...images];
+            const parent = dirname(path);
+            sendJson(res, 200, {
+                path,
+                parent: parent === path ? null : parent,
+                home: homedir(),
+                cwd: server.cwd,
+                root: parse(path).root,
+                roots: roots(),
+                entries: entries.slice(0, MAX_ENTRIES),
+                truncated: entries.length > MAX_ENTRIES,
+            });
+        },
+    },
+    {
+        method: 'GET',
+        path: '/api/fs/image',
+        handler: async ({ res, url, server }) => {
+            const path = resolveUserPath(url.searchParams.get('path'), server.cwd);
+            if (!isImagePath(path))
+                throw new HttpError(400, 'not an image file');
+            const stat = statSync(path, { throwIfNoEntry: false });
+            if (!stat?.isFile())
+                throw new HttpError(404, 'no such file');
+            const requested = Number(url.searchParams.get('size') ?? 0);
+            const size = Number.isFinite(requested) ? Math.min(Math.max(requested, 0), 2000) : 0;
+            const sharp = findSharp(server.cwd);
+            if (sharp && size > 0) {
+                try {
+                    const bytes = await sharp(path, { failOn: 'none' })
+                        .rotate()
+                        .resize({ width: size, height: size, fit: 'inside', withoutEnlargement: true })
+                        .webp({ quality: 78 })
+                        .toBuffer();
+                    sendBytes(res, 'image/webp', bytes, 'private, max-age=60');
+                    return;
+                }
+                catch {
+                    throw new HttpError(422, 'this image could not be read');
+                }
+            }
+            const type = BROWSER_TYPES[extname(path).toLowerCase()];
+            if (!type)
+                throw new HttpError(415, 'this format needs sharp for a preview');
+            if (stat.size > MAX_RAW_BYTES)
+                throw new HttpError(413, 'too large to preview without sharp');
+            sendBytes(res, type, readFileSync(path), 'private, max-age=60');
+        },
+    },
+];
+//# sourceMappingURL=fs-routes.js.map

package/dist/commands/ui/fs-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-routes.js","sourceRoot":"","sources":["../../../src/commands/ui/fs-routes.ts"],"names":[],"mappings":"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"}

package/dist/commands/ui/http.d.ts

@@ -0,0 +1,41 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+export declare class HttpError extends Error {
+    readonly status: number;
+    constructor(status: number, message: string);
+}
+export interface UiServerOptions {
+    cwd: string;
+    host: string;
+    port: number;
+    token: string;
+    staticDir: string | undefined;
+    version: string;
+}
+export interface RouteContext {
+    req: IncomingMessage;
+    res: ServerResponse;
+    url: URL;
+    params: Record<string, string>;
+    server: UiServerOptions;
+    readBody: () => Promise<unknown>;
+}
+export interface Route {
+    method: 'GET' | 'POST';
+    path: string;
+    handler: (ctx: RouteContext) => Promise<void> | void;
+}
+export interface UiModule {
+    id: string;
+    title: string;
+    description: string;
+    status: 'available' | 'planned';
+    routes: Route[];
+}
+export declare function sendJson(res: ServerResponse, status: number, data: unknown): void;
+export declare function sendBytes(res: ServerResponse, contentType: string, bytes: Uint8Array, cache?: string): void;
+export declare function readJsonBody(req: IncomingMessage): Promise<unknown>;
+export declare function asObject(value: unknown, what?: string): Record<string, unknown>;
+export declare function matchRoute(routes: Route[], method: string, pathname: string): {
+    route: Route;
+    params: Record<string, string>;
+} | undefined;

package/dist/commands/ui/http.js

@@ -0,0 +1,81 @@
+export class HttpError extends Error {
+    status;
+    constructor(status, message) {
+        super(message);
+        this.status = status;
+    }
+}
+const MAX_BODY_BYTES = 4 * 1024 * 1024;
+export function sendJson(res, status, data) {
+    const body = JSON.stringify(data);
+    res.writeHead(status, {
+        'Content-Type': 'application/json; charset=utf-8',
+        'Content-Length': Buffer.byteLength(body),
+        'Cache-Control': 'no-store',
+    });
+    res.end(body);
+}
+export function sendBytes(res, contentType, bytes, cache = 'no-store') {
+    res.writeHead(200, {
+        'Content-Type': contentType,
+        'Content-Length': bytes.length,
+        'Cache-Control': cache,
+    });
+    res.end(bytes);
+}
+export async function readJsonBody(req) {
+    const type = req.headers['content-type'] ?? '';
+    if (!type.toLowerCase().startsWith('application/json')) {
+        throw new HttpError(415, 'expected Content-Type: application/json');
+    }
+    const chunks = [];
+    let size = 0;
+    for await (const chunk of req) {
+        const buffer = chunk;
+        size += buffer.length;
+        if (size > MAX_BODY_BYTES)
+            throw new HttpError(413, 'the request body is too large');
+        chunks.push(buffer);
+    }
+    const text = Buffer.concat(chunks).toString('utf8');
+    if (text.trim() === '')
+        return {};
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        throw new HttpError(400, 'the request body is not valid JSON');
+    }
+}
+export function asObject(value, what = 'the request body') {
+    if (value === null || typeof value !== 'object' || Array.isArray(value)) {
+        throw new HttpError(400, `${what} must be a JSON object`);
+    }
+    return value;
+}
+export function matchRoute(routes, method, pathname) {
+    for (const route of routes) {
+        if (route.method !== method)
+            continue;
+        const want = route.path.split('/');
+        const have = pathname.split('/');
+        if (want.length !== have.length)
+            continue;
+        const params = {};
+        let ok = true;
+        for (let i = 0; i < want.length; i++) {
+            const part = want[i];
+            const value = have[i];
+            if (part.startsWith(':'))
+                params[part.slice(1)] = decodeURIComponent(value);
+            else if (part !== value) {
+                ok = false;
+                break;
+            }
+        }
+        if (ok)
+            return { route, params };
+    }
+    return undefined;
+}
+//# sourceMappingURL=http.js.map

package/dist/commands/ui/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../../src/commands/ui/http.ts"],"names":[],"mappings":"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"}

package/dist/commands/ui/jobs.d.ts

@@ -0,0 +1,15 @@
+import { type Route } from './http.js';
+export type JobEvent = {
+    type: 'progress';
+    data: unknown;
+} | {
+    type: 'done';
+    data: unknown;
+} | {
+    type: 'failed';
+    data: {
+        message: string;
+    };
+};
+export declare function startJob(task: (progress: (data: unknown) => void) => Promise<unknown>): string;
+export declare const jobRoutes: Route[];

package/dist/commands/ui/jobs.js

@@ -0,0 +1,73 @@
+import { randomUUID } from 'node:crypto';
+import { HttpError } from './http.js';
+const MAX_JOBS = 50;
+const jobs = new Map();
+function write(res, event) {
+    res.write(`event: ${event.type}\ndata: ${JSON.stringify(event.data)}\n\n`);
+}
+function prune() {
+    if (jobs.size <= MAX_JOBS)
+        return;
+    const finished = [...jobs.values()]
+        .filter((job) => job.final !== undefined)
+        .sort((a, b) => a.created - b.created);
+    for (const job of finished.slice(0, jobs.size - MAX_JOBS))
+        jobs.delete(job.id);
+}
+function emit(job, event) {
+    if (event.type === 'progress')
+        job.progress = event.data;
+    else
+        job.final = event;
+    for (const res of job.listeners) {
+        write(res, event);
+        if (event.type !== 'progress')
+            res.end();
+    }
+    if (event.type !== 'progress')
+        job.listeners.clear();
+}
+export function startJob(task) {
+    const job = {
+        id: randomUUID(),
+        progress: undefined,
+        final: undefined,
+        listeners: new Set(),
+        created: Date.now(),
+    };
+    jobs.set(job.id, job);
+    prune();
+    task((data) => emit(job, { type: 'progress', data }))
+        .then((data) => emit(job, { type: 'done', data }))
+        .catch((error) => emit(job, {
+        type: 'failed',
+        data: { message: error instanceof Error ? error.message : String(error) },
+    }));
+    return job.id;
+}
+export const jobRoutes = [
+    {
+        method: 'GET',
+        path: '/api/jobs/:id/events',
+        handler: ({ req, res, params }) => {
+            const job = jobs.get(params.id ?? '');
+            if (!job)
+                throw new HttpError(404, 'no such job');
+            res.writeHead(200, {
+                'Content-Type': 'text/event-stream; charset=utf-8',
+                'Cache-Control': 'no-store',
+                Connection: 'keep-alive',
+            });
+            if (job.progress !== undefined)
+                write(res, { type: 'progress', data: job.progress });
+            if (job.final) {
+                write(res, job.final);
+                res.end();
+                return;
+            }
+            job.listeners.add(res);
+            req.on('close', () => job.listeners.delete(res));
+        },
+    },
+];
+//# sourceMappingURL=jobs.js.map

package/dist/commands/ui/jobs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.js","sourceRoot":"","sources":["../../../src/commands/ui/jobs.ts"],"names":[],"mappings":"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"}

package/dist/commands/ui/modules/checks.d.ts

@@ -0,0 +1,28 @@
+import { type UiModule } from '../http.js';
+export type Severity = 'error' | 'warning' | 'info';
+export interface CheckFinding {
+    file?: string;
+    line?: number;
+    column?: number;
+    severity: Severity;
+    code: string;
+    message: string;
+    hint?: string;
+    files?: string[];
+}
+export interface CheckOutcome {
+    summary: string;
+    filesScanned?: number;
+    findings: CheckFinding[];
+    error?: string;
+    exitCode: number;
+    notes?: string[];
+}
+export interface OptionDef {
+    key: string;
+    label: string;
+    type: 'boolean' | 'list';
+    default: boolean | string;
+    help: string;
+}
+export declare const checksModule: UiModule;