html2pptx-local-mcp 1.1.32 → 1.1.33

package/cli/dist/commands/edit.d.ts

@@ -1,3 +1,4 @@
+import { type IncomingMessage, type ServerResponse } from "node:http";
 export interface EditOptions {
     port?: string;
     baseUrl?: string;
@@ -17,7 +18,7 @@ declare function normalizeBaseUrl(raw: string): URL;
 declare function readRegisteredEditorBaseUrl(root: string): Promise<string | null>;
 declare function resolveEditorBaseUrl(root: string, explicitBaseUrl: string | undefined): Promise<URL>;
 declare function buildEditorUrl(baseUrl: URL, rel: string, bridgeUrl: string, sessionToken: string): URL;
-declare function createBridgeServer(ctx: BridgeContext): any;
+declare function createBridgeServer(ctx: BridgeContext): import("http").Server<typeof IncomingMessage, typeof ServerResponse>;
 declare function listen(server: ReturnType<typeof createBridgeServer>, requestedPort: number): Promise<number>;
 export declare function editCommand(input: string | undefined, options?: EditOptions): Promise<void>;
 export declare const editCommandInternalsForTest: {

package/cli/dist/commands/edit.js

@@ -8,13 +8,11 @@ import * as p from "@clack/prompts";
 import pc from "picocolors";
 const AUTO_PORT = 0;
 const MAX_WRITE_BYTES = 5 * 1024 * 1024;
-const MAX_ASSET_BYTES = 64 * 1024 * 1024;
+const MAX_ASSET_BYTES = 8 * 1024 * 1024;
 const ALLOWED_EXTENSIONS = [".html", ".htm"];
 const ALLOWED_EXT = new Set(ALLOWED_EXTENSIONS);
 const ASSET_IMAGE_EXTENSIONS = [".png", ".jpg", ".jpeg", ".gif", ".webp", ".svg", ".avif"];
-const ASSET_VIDEO_EXTENSIONS = [".mp4", ".webm", ".mov", ".m4v", ".ogv"];
-const ASSET_VIDEO_EXT = new Set(ASSET_VIDEO_EXTENSIONS);
-const ASSET_MEDIA_EXT = new Set([...ASSET_IMAGE_EXTENSIONS, ...ASSET_VIDEO_EXTENSIONS]);
+const ASSET_IMAGE_EXT = new Set(ASSET_IMAGE_EXTENSIONS);
 const ASSET_CONTENT_TYPES = {
     ".png": "image/png",
     ".jpg": "image/jpeg",
@@ -23,11 +21,6 @@ const ASSET_CONTENT_TYPES = {
     ".webp": "image/webp",
     ".svg": "image/svg+xml",
     ".avif": "image/avif",
-    ".mp4": "video/mp4",
-    ".webm": "video/webm",
-    ".mov": "video/quicktime",
-    ".m4v": "video/x-m4v",
-    ".ogv": "video/ogg",
 };
 const ASSET_CONTENT_TYPE_EXT = {
     "image/png": ".png",
@@ -36,11 +29,6 @@ const ASSET_CONTENT_TYPE_EXT = {
     "image/webp": ".webp",
     "image/svg+xml": ".svg",
     "image/avif": ".avif",
-    "video/mp4": ".mp4",
-    "video/webm": ".webm",
-    "video/quicktime": ".mov",
-    "video/x-m4v": ".m4v",
-    "video/ogg": ".ogv",
 };
 const DISALLOWED_TOP_DIRECTORIES = [
     "public",
@@ -472,8 +460,8 @@ async function safeAssetPath(ctx, rel) {
         throw new Error("path escape");
     }
     const ext = extname(abs).toLowerCase();
-    if (!ASSET_MEDIA_EXT.has(ext)) {
-        throw new Error("only image, GIF, and video files are allowed");
+    if (!ASSET_IMAGE_EXT.has(ext)) {
+        throw new Error("only image files are allowed");
     }
     const real = await resolveReal(abs);
     if (real !== ctx.root && !real.startsWith(ctx.root + sep)) {
@@ -489,21 +477,18 @@ async function safeAssetPath(ctx, rel) {
 }
 function assetExt(name, contentType) {
     const fromName = extname(String(name || "")).toLowerCase();
-    if (ASSET_MEDIA_EXT.has(fromName))
+    if (ASSET_IMAGE_EXT.has(fromName))
         return fromName;
     return ASSET_CONTENT_TYPE_EXT[String(contentType || "").toLowerCase()] || "";
 }
 function assetSlug(name) {
-    const base = String(name || "asset").replace(/\.[^.]+$/, "");
+    const base = String(name || "image").replace(/\.[^.]+$/, "");
     const slug = base
         .normalize("NFKD")
         .replace(/[^\w.-]+/g, "-")
         .replace(/^[-.]+|[-.]+$/g, "")
         .toLowerCase();
-    return slug || "asset";
-}
-function assetKind(ext) {
-    return ASSET_VIDEO_EXT.has(ext) ? "video" : "image";
+    return slug || "image";
 }
 function assetDirRel(scope, htmlDirRel) {
     if (scope === "global")
@@ -545,11 +530,10 @@ async function handleAssetGet(ctx, req, reqUrl, res) {
             if (absDir === ctx.root || absDir.startsWith(ctx.root + sep)) {
                 const names = await readdir(absDir);
                 assets = names
-                    .filter((name) => ASSET_MEDIA_EXT.has(extname(name).toLowerCase()))
+                    .filter((name) => ASSET_IMAGE_EXT.has(extname(name).toLowerCase()))
                     .map((name) => ({
                     name,
                     src: toPosixPath(relative(htmlDirAbs, join(absDir, name))),
-                    kind: assetKind(extname(name).toLowerCase()),
                 }));
             }
         }
@@ -592,21 +576,21 @@ async function handleAssetPost(ctx, req, res) {
     }
     const { file, scope: rawScope, name, contentType, dataBase64 } = body || {};
     if (typeof dataBase64 !== "string" || !dataBase64) {
-        sendJson(res, 400, { error: "missing asset data" });
+        sendJson(res, 400, { error: "missing image data" });
         return;
     }
     const buf = Buffer.from(dataBase64, "base64");
     if (!buf.length) {
-        sendJson(res, 400, { error: "empty asset data" });
+        sendJson(res, 400, { error: "empty image data" });
         return;
     }
     if (buf.length > MAX_ASSET_BYTES) {
-        sendJson(res, 413, { error: "asset too large (>64MB)" });
+        sendJson(res, 413, { error: "image too large (>8MB)" });
         return;
     }
     const ext = assetExt(name, contentType);
-    if (!ASSET_MEDIA_EXT.has(ext)) {
-        sendJson(res, 400, { error: "unsupported asset type" });
+    if (!ASSET_IMAGE_EXT.has(ext)) {
+        sendJson(res, 400, { error: "unsupported image type" });
         return;
     }
     const scope = rawScope === "global" ? "global" : "project";
@@ -633,7 +617,6 @@ async function handleAssetPost(ctx, req, res) {
             name: fileName,
             path: toPosixPath(relative(ctx.root, absTarget)),
             src: toPosixPath(relative(htmlDirAbs, absTarget)),
-            kind: assetKind(ext),
             bytes: buf.length,
             reused: alreadyIdentical,
             policy: buildPolicy(ctx),

package/lib/local-editor-server.js

@@ -1,5 +1,5 @@
 import { spawn } from 'node:child_process';
-import { existsSync } from 'node:fs';
+import { existsSync, readdirSync, rmSync } from 'node:fs';
 import net from 'node:net';
 import { access } from 'node:fs/promises';
 import { dirname, join, resolve } from 'node:path';
@@ -64,6 +64,21 @@ export function createLocalEditorServerManager(options = {}) {
     const baseUrl = `http://localhost:${port}`;
     const invocation = await resolveNextInvocation(appRoot, options);
 
+    // Give every editor instance its own Turbopack build dir. A shared `.next`
+    // gets corrupted two ways, both surfacing as a runtime ChunkLoadError:
+    //   (a) npx reuses one cache dir across `@latest` version bumps, so a stale
+    //       `.next` from the previous version is loaded against new source.
+    //   (b) editors from different projects/sessions run `next dev` against the
+    //       same appRoot concurrently and overwrite each other's chunks.
+    // The bundled next.config reads distDir from HTML2PPTX_EDITOR_DIST_DIR.
+    const distDir = `.next-${port}`;
+    await pruneStaleEditorDistDirs(appRoot);
+    try {
+      rmSync(join(appRoot, distDir), { recursive: true, force: true });
+    } catch {
+      // Best-effort: a fresh build dir is preferred but not required.
+    }
+
     // Issue #78: do not pass `--webpack`. Next.js 16.2.x webpack mode fails
     // to compile App Router `.jsx` files (next-swc-loader emits JSX that the
     // webpack default parser then chokes on with "Unexpected token"). Use
@@ -79,6 +94,7 @@ export function createLocalEditorServerManager(options = {}) {
       env: {
         ...process.env,
         HTML2PPTX_EDITOR_BASE_URL: baseUrl,
+        HTML2PPTX_EDITOR_DIST_DIR: distDir,
         NEXT_TELEMETRY_DISABLED: '1',
         PORT: String(port),
       },
@@ -206,6 +222,30 @@ export async function isEditorServer(port) {
   }
 }
 
+// Remove per-instance `.next-<port>` build dirs whose editor server is gone, so
+// isolated build caches from crashed/closed sessions do not accumulate. The dir
+// for a still-listening editor is kept. Best-effort: never throws.
+async function pruneStaleEditorDistDirs(appRoot) {
+  let entries;
+  try {
+    entries = readdirSync(appRoot, { withFileTypes: true });
+  } catch {
+    return;
+  }
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    const match = /^\.next-(\d+)$/.exec(entry.name);
+    if (!match) continue;
+    const port = Number.parseInt(match[1], 10);
+    if (await isEditorServer(port)) continue;
+    try {
+      rmSync(join(appRoot, entry.name), { recursive: true, force: true });
+    } catch {
+      // Best-effort cleanup.
+    }
+  }
+}
+
 function waitForEditorServer(session, timeoutMs) {
   return new Promise((resolvePromise, rejectPromise) => {
     const startedAt = Date.now();

package/local-editor-app/next.config.mjs

@@ -22,6 +22,7 @@ const localEditorSecurityHeaders = [
 ];
 
 export default {
+  distDir: process.env.HTML2PPTX_EDITOR_DIST_DIR || '.next',
   async headers() {
     return [
       { source: '/edit-slide', headers: localEditorSecurityHeaders },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "html2pptx-local-mcp",
-  "version": "1.1.32",
+  "version": "1.1.33",
   "type": "module",
   "description": "Local stdio MCP server for opening html2pptx slide HTML in the local edit-slide editor.",
   "bin": {

package/cli/dist/dist/commands/config-show.d.ts

@@ -1 +0,0 @@
-export declare function configShowCommand(): Promise<void>;

package/cli/dist/dist/commands/config-show.js

@@ -1,16 +0,0 @@
-import * as p from "@clack/prompts";
-import pc from "picocolors";
-import { loadConfig, getConfigPath } from "../config.js";
-export async function configShowCommand() {
-    const config = await loadConfig();
-    const configPath = getConfigPath();
-    p.log.info(pc.bold("Config file: ") + pc.dim(configPath));
-    if (!config.apiKey) {
-        p.log.warn("No configuration found. Run " + pc.cyan("html2pptx login") + " to set up.");
-        return;
-    }
-    p.log.info(pc.bold("API Key: ") +
-        pc.dim(config.apiKey.slice(0, 12) + "..." + config.apiKey.slice(-4)));
-    p.log.info(pc.bold("API Base URL: ") +
-        (config.baseUrl ?? "https://html2pptx.app") + pc.dim(" (default)"));
-}

package/cli/dist/dist/commands/convert.d.ts

@@ -1,10 +0,0 @@
-interface ConvertOptions {
-    output?: string;
-    size?: string;
-    css?: string;
-    json?: boolean;
-    open?: boolean;
-    baseUrl?: string;
-}
-export declare function convertCommand(input?: string, options?: ConvertOptions): Promise<void>;
-export {};

package/cli/dist/dist/commands/convert.js

@@ -1,311 +0,0 @@
-import { readFile, writeFile } from "node:fs/promises";
-import { exec } from "node:child_process";
-import { platform } from "node:os";
-import { basename, resolve } from "node:path";
-import * as p from "@clack/prompts";
-import pc from "picocolors";
-import { loadConfig } from "../config.js";
-function parseSize(size) {
-    if (size === "16:9")
-        return { layout: "LAYOUT_16x9" };
-    if (size === "4:3")
-        return { layout: "LAYOUT_4x3" };
-    const match = size.match(/^(\d+)x(\d+)$/);
-    if (match)
-        return { width: parseInt(match[1]), height: parseInt(match[2]) };
-    return { layout: "LAYOUT_16x9" };
-}
-function formatDuration(ms) {
-    if (ms < 1000)
-        return `${ms}ms`;
-    return `${(ms / 1000).toFixed(1)}s`;
-}
-function openFile(filePath) {
-    const os = platform();
-    const cmd = os === "darwin" ? "open" : os === "win32" ? "start" : "xdg-open";
-    exec(`${cmd} "${filePath}"`);
-}
-async function interactivePrompt() {
-    p.intro(pc.bgCyan(pc.black(" html2pptx convert ")));
-    const result = await p.group({
-        input: () => p.text({
-            message: "HTML file to convert",
-            placeholder: "./slides.html",
-            validate(value) {
-                if (!value)
-                    return "HTML file path is required";
-                if (!value.endsWith(".html") && !value.endsWith(".htm"))
-                    return "File must be .html or .htm";
-            },
-        }),
-        size: () => p.select({
-            message: "Slide size",
-            options: [
-                { value: "16:9", label: "16:9 (1600x900)", hint: "default" },
-                { value: "4:3", label: "4:3 (1024x768)" },
-                { value: "custom", label: "Custom size" },
-            ],
-        }),
-        customSize: ({ results }) => {
-            if (results.size !== "custom")
-                return;
-            return p.text({
-                message: "Enter custom size (WxH)",
-                placeholder: "1920x1080",
-                validate(value) {
-                    if (!value?.match(/^\d+x\d+$/))
-                        return 'Format: WIDTHxHEIGHT (e.g. 1920x1080)';
-                },
-            });
-        },
-        css: () => p.text({
-            message: "External CSS file (optional)",
-            placeholder: "Press Enter to skip",
-        }),
-        output: ({ results }) => {
-            const defaultName = basename(results.input).replace(/\.html?$/, "") + ".pptx";
-            return p.text({
-                message: "Output filename",
-                placeholder: defaultName,
-                initialValue: defaultName,
-            });
-        },
-    }, {
-        onCancel() {
-            p.cancel("Conversion cancelled.");
-            process.exit(0);
-        },
-    });
-    return {
-        input: result.input,
-        output: result.output,
-        size: result.customSize ?? result.size,
-        css: result.css || undefined,
-    };
-}
-async function runExport(html, css, size, fileName, baseUrl, apiKey) {
-    const sizeParams = parseSize(size);
-    const body = {
-        html,
-        fileName,
-        responseFormat: "url",
-        ...sizeParams,
-    };
-    if (css)
-        body.css = css;
-    const res = await fetch(`${baseUrl}/api/v1/export/jobs`, {
-        method: "POST",
-        headers: {
-            "Content-Type": "application/json",
-            Authorization: `Bearer ${apiKey}`,
-        },
-        body: JSON.stringify(body),
-    });
-    if (res.status === 401) {
-        throw new Error("Invalid API key. Run `html2pptx login` to update your key.");
-    }
-    if (res.status === 403) {
-        throw new Error("Access denied. Your API key may be expired or your plan may have changed. Visit https://html2pptx.app/dashboard to check.");
-    }
-    if (res.status === 413) {
-        throw new Error("HTML payload too large for your plan. Try reducing the HTML size or upgrading your plan.");
-    }
-    if (res.status === 429) {
-        throw new Error("Rate limit exceeded. Please wait a moment and try again, or upgrade your plan for higher limits.");
-    }
-    if (!res.ok) {
-        const text = await res.text();
-        throw new Error(`API error ${res.status}: ${text}`);
-    }
-    return (await res.json());
-}
-async function pollJob(statusUrl, apiKey, baseUrl) {
-    if (!statusUrl.startsWith(baseUrl)) {
-        throw new Error("Unexpected status URL from server");
-    }
-    const maxAttempts = 60;
-    for (let i = 0; i < maxAttempts; i++) {
-        await new Promise((r) => setTimeout(r, 2000));
-        const res = await fetch(statusUrl, {
-            headers: { Authorization: `Bearer ${apiKey}` },
-        });
-        if (!res.ok) {
-            const text = await res.text();
-            throw new Error(`Poll error ${res.status}: ${text}`);
-        }
-        const data = (await res.json());
-        if (data.status === "completed")
-            return data;
-        if (data.status === "failed")
-            throw new Error(data.error ?? "Export failed");
-    }
-    throw new Error("Export timed out after 2 minutes");
-}
-async function downloadFile(url, outputPath) {
-    const res = await fetch(url);
-    if (!res.ok)
-        throw new Error(`Download failed: ${res.status}`);
-    const buffer = Buffer.from(await res.arrayBuffer());
-    await writeFile(outputPath, buffer);
-    return buffer.byteLength;
-}
-function formatBytes(bytes) {
-    if (bytes < 1024)
-        return `${bytes} B`;
-    if (bytes < 1024 * 1024)
-        return `${(bytes / 1024).toFixed(1)} KB`;
-    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
-}
-export async function convertCommand(input, options = {}) {
-    const config = await loadConfig();
-    const apiKey = config.apiKey;
-    const baseUrl = options.baseUrl ?? config.baseUrl ?? "https://html2pptx.app";
-    const jsonMode = options.json ?? false;
-    if (!apiKey) {
-        if (jsonMode) {
-            console.log(JSON.stringify({ success: false, error: "No API key found. Run html2pptx login first." }));
-            process.exit(1);
-        }
-        p.log.error("No API key found. Run " + pc.cyan("html2pptx login") + " first.");
-        process.exit(1);
-    }
-    let htmlPath;
-    let outputFile;
-    let size;
-    let cssPath;
-    // If args provided -> direct mode, else -> interactive mode
-    if (input) {
-        htmlPath = resolve(input);
-        outputFile =
-            options.output ?? basename(htmlPath).replace(/\.html?$/, "") + ".pptx";
-        size = options.size ?? "16:9";
-        cssPath = options.css;
-    }
-    else {
-        const answers = await interactivePrompt();
-        htmlPath = resolve(answers.input);
-        outputFile = answers.output;
-        size = answers.size;
-        cssPath = answers.css;
-    }
-    const startTime = Date.now();
-    const spinner = jsonMode ? null : p.spinner();
-    spinner?.start("Reading HTML file...");
-    let html;
-    try {
-        html = await readFile(htmlPath, "utf-8");
-    }
-    catch {
-        if (jsonMode) {
-            console.log(JSON.stringify({ success: false, error: `Could not read file: ${htmlPath}` }));
-        }
-        else {
-            spinner?.stop("Failed");
-            p.log.error(`Could not read file: ${pc.dim(htmlPath)}`);
-        }
-        process.exit(1);
-    }
-    let css;
-    if (cssPath) {
-        try {
-            css = await readFile(resolve(cssPath), "utf-8");
-        }
-        catch {
-            if (jsonMode) {
-                console.log(JSON.stringify({ success: false, error: `Could not read CSS file: ${cssPath}` }));
-            }
-            else {
-                spinner?.stop("Failed");
-                p.log.error(`Could not read CSS file: ${pc.dim(cssPath)}`);
-            }
-            process.exit(1);
-        }
-    }
-    spinner?.message("Sending to html2pptx API...");
-    let job;
-    try {
-        job = await runExport(html, css, size, outputFile, baseUrl, apiKey);
-    }
-    catch (e) {
-        const errMsg = e.message;
-        if (jsonMode) {
-            console.log(JSON.stringify({ success: false, error: errMsg }));
-        }
-        else {
-            spinner?.stop("Failed");
-            p.log.error(errMsg);
-        }
-        process.exit(1);
-    }
-    const finishConversion = async (downloadUrl) => {
-        spinner?.message("Downloading PPTX...");
-        const fileSize = await downloadFile(downloadUrl, resolve(outputFile));
-        const duration = Date.now() - startTime;
-        if (jsonMode) {
-            const result = {
-                success: true,
-                file: outputFile,
-                size: formatBytes(fileSize),
-                duration: formatDuration(duration),
-            };
-            console.log(JSON.stringify(result));
-        }
-        else {
-            spinner?.stop(pc.green("Done!"));
-            p.log.success(`Saved to ${pc.cyan(outputFile)} ${pc.dim(`(${formatBytes(fileSize)}, ${formatDuration(duration)})`)}`);
-            // Next steps guidance
-            p.log.info(pc.dim("Next: ") +
-                `Open the file or run ${pc.cyan("html2pptx status")} to check your usage.`);
-        }
-        if (options.open) {
-            openFile(resolve(outputFile));
-        }
-    };
-    // If job completed immediately
-    if (job.status === "completed" && job.downloadUrl) {
-        try {
-            await finishConversion(job.downloadUrl);
-            return;
-        }
-        catch (e) {
-            const errMsg = e.message;
-            if (jsonMode) {
-                console.log(JSON.stringify({ success: false, error: errMsg }));
-            }
-            else {
-                spinner?.stop("Failed");
-                p.log.error(errMsg);
-            }
-            process.exit(1);
-        }
-    }
-    // Poll for completion
-    spinner?.message("Converting... this may take a moment");
-    try {
-        const result = await pollJob(job.statusUrl, apiKey, baseUrl);
-        if (result.downloadUrl) {
-            await finishConversion(result.downloadUrl);
-        }
-        else {
-            if (jsonMode) {
-                console.log(JSON.stringify({ success: false, error: "No download URL returned" }));
-            }
-            else {
-                spinner?.stop("Failed");
-                p.log.error("No download URL returned");
-            }
-            process.exit(1);
-        }
-    }
-    catch (e) {
-        const errMsg = e.message;
-        if (jsonMode) {
-            console.log(JSON.stringify({ success: false, error: errMsg }));
-        }
-        else {
-            spinner?.stop("Failed");
-            p.log.error(errMsg);
-        }
-        process.exit(1);
-    }
-}

package/cli/dist/dist/commands/edit.d.ts

@@ -1,34 +0,0 @@
-import { type IncomingMessage, type ServerResponse } from "node:http";
-export interface EditOptions {
-    port?: string;
-    baseUrl?: string;
-    noOpen?: boolean;
-    open?: boolean;
-    json?: boolean;
-}
-interface BridgeContext {
-    root: string;
-    editorOrigin: string;
-    localStateDir: string;
-    sessionToken: string;
-}
-declare function generateSessionToken(): string;
-declare function parsePort(value: string | undefined): number;
-declare function normalizeBaseUrl(raw: string): URL;
-declare function readRegisteredEditorBaseUrl(root: string): Promise<string | null>;
-declare function resolveEditorBaseUrl(root: string, explicitBaseUrl: string | undefined): Promise<URL>;
-declare function buildEditorUrl(baseUrl: URL, rel: string, bridgeUrl: string, sessionToken: string): URL;
-declare function createBridgeServer(ctx: BridgeContext): import("http").Server<typeof IncomingMessage, typeof ServerResponse>;
-declare function listen(server: ReturnType<typeof createBridgeServer>, requestedPort: number): Promise<number>;
-export declare function editCommand(input: string | undefined, options?: EditOptions): Promise<void>;
-export declare const editCommandInternalsForTest: {
-    buildEditorUrl: typeof buildEditorUrl;
-    createBridgeServer: typeof createBridgeServer;
-    generateSessionToken: typeof generateSessionToken;
-    listen: typeof listen;
-    normalizeBaseUrl: typeof normalizeBaseUrl;
-    parsePort: typeof parsePort;
-    readRegisteredEditorBaseUrl: typeof readRegisteredEditorBaseUrl;
-    resolveEditorBaseUrl: typeof resolveEditorBaseUrl;
-};
-export {};