@json-to-office/jto 0.38.0 → 1.0.0

package/dist/cli.js

@@ -443,6 +443,7 @@ var init_generator = __esm({
         );
         const bypassCache = options?.bypassCache === true || extraEntries.length > 0 || declaresRegistry;
         const baseDir = typeof options?.baseDir === "string" ? options.baseDir : void 0;
+        const renderer = typeof options?.renderer === "string" ? options.renderer : void 0;
         const cacheKeyData = {
           config: config2,
           customThemes: customThemes && Object.keys(customThemes).length > 0 ? customThemes : null,
@@ -450,7 +451,10 @@ var init_generator = __esm({
           fontSubstitution: fontSubstitution ?? null,
           fontStrict: callerStrict ?? null,
           // Same definition, different source directory → different local assets.
-          baseDir: baseDir ?? null
+          baseDir: baseDir ?? null,
+          // Same document, different backend → different bytes. Without this,
+          // switching backends would serve the other one's cached buffer.
+          renderer: renderer ?? null
         };
         const cacheKey = this.cacheService.generateCacheKey(cacheKeyData);
         const hasDynamicContent = this.cacheService.hasDynamicContent(config2);
@@ -492,6 +496,7 @@ var init_generator = __esm({
             customThemes,
             fonts: fontOpts,
             baseDir,
+            renderer,
             warnings: coreWarnings
           });
           buffer = await generator.generateBuffer(config2);
@@ -500,6 +505,7 @@ var init_generator = __esm({
             customThemes,
             fonts: fontOpts,
             baseDir,
+            renderer,
             warnings: coreWarnings
           });
         }
@@ -1052,6 +1058,10 @@ var init_loose = __esm({
               bypassCache: Type.Optional(Type.Boolean()),
               returnUrl: Type.Optional(Type.Boolean()),
               fonts: Type.Optional(FontOptionsSchema),
+              // Backend to render with. Left as a bounded string rather than an
+              // enum: the registry owns the list, answers an unknown id with the
+              // ids that exist, and the route turns that into a 400.
+              renderer: Type.Optional(Type.String({ maxLength: 64 })),
               // Name of the discovered document this definition came from; the
               // server maps it to that document's directory so relative asset
               // paths resolve against it (#142). Names, never paths — a client
@@ -1938,6 +1948,19 @@ import {
   PluginDiscoveryService
 } from "@json-to-office/jto-cli";
 import { dirname } from "path";
+function throwIfClientError(error) {
+  const code = error?.code;
+  if (code === "UNSUPPORTED_RENDERER_FEATURE" || code === "UNCOMPILED_COMPONENT" || // An id nobody registered is the caller naming a backend that does not
+  // exist. The message already lists the ones that do.
+  code === "UNKNOWN_RENDERER") {
+    throw new HTTPException4(400, { message: error.message });
+  }
+  if (!(error instanceof Error)) return;
+  const message = error.message.toLowerCase();
+  if (message.includes("invalid") || message.includes("validation") || message.includes("missing required") || message.includes("unknown component")) {
+    throw new HTTPException4(400, { message: error.message });
+  }
+}
 function createFormatRouter(adapter) {
   const router = new Hono2();
   const assertRequestSources = (value, path5) => {
@@ -2054,12 +2077,7 @@ function createFormatRouter(adapter) {
           error,
           requestId
         });
-        if (error instanceof Error) {
-          const msg = error.message.toLowerCase();
-          if (msg.includes("invalid") || msg.includes("validation") || msg.includes("missing required") || msg.includes("unknown component")) {
-            throw new HTTPException4(400, { message: error.message });
-          }
-        }
+        throwIfClientError(error);
         if (error instanceof HTTPException4) throw error;
         throw new HTTPException4(500, {
           message: `Internal server error during ${adapter.label} generation`
@@ -2299,7 +2317,15 @@ function createFormatRouter(adapter) {
           customThemes,
           options: {
             bypassCache: true,
-            ...baseDir !== void 0 && { baseDir }
+            ...baseDir !== void 0 && { baseDir },
+            // The preview has to come from the backend the caller picked.
+            // Regenerating with the default made the picker lie: the PDF on
+            // screen and the bytes on download came from different renderers,
+            // and a capability refusal was invisible until you downloaded
+            // (#255).
+            ...options?.renderer !== void 0 && {
+              renderer: options.renderer
+            }
           }
         });
         const pdfBuffer = await libreOfficeService.convertToPdf(
@@ -2318,6 +2344,7 @@ function createFormatRouter(adapter) {
           requestId
         });
         if (error instanceof HTTPException4) throw error;
+        throwIfClientError(error);
         if (error instanceof LibreOfficeBinaryNotFoundError) {
           throw new HTTPException4(503, {
             message: "LibreOffice is not available. Install LibreOffice or set LIBREOFFICE_PATH."
@@ -2384,23 +2411,30 @@ function createFormatRouter(adapter) {
           requestId
         });
         if (error instanceof HTTPException4) throw error;
-        if (error instanceof Error) {
-          const msg = error.message.toLowerCase();
-          if (msg.includes("invalid") || msg.includes("validation") || msg.includes("missing required") || msg.includes("unknown component")) {
-            throw new HTTPException4(400, { message: error.message });
-          }
-        }
+        throwIfClientError(error);
         throw new HTTPException4(500, {
           message: "Failed to get standard components definition"
         });
       }
     }
   );
+  router.get("/renderers", async (c) => {
+    try {
+      const ids = await adapter.rendererIds();
+      return c.json({
+        success: true,
+        data: { ids, default: ids[0] ?? null },
+        meta: { timestamp: (/* @__PURE__ */ new Date()).toISOString() }
+      });
+    } catch (error) {
+      logger.error("Failed to list renderers", { error });
+      throw new HTTPException4(500, { message: "Failed to list renderers" });
+    }
+  });
   router.get("/cache-stats", async (c) => {
     try {
       const cacheService = getContainer().get("cacheService");
       const stats = cacheService.getStats();
-      const components = await adapter.getComponentCacheStats?.() ?? null;
       const rasterizer = await (async () => {
         try {
           const cli = await import("@json-to-office/jto-cli");
@@ -2423,7 +2457,6 @@ function createFormatRouter(adapter) {
             itemCount: stats.itemCount,
             enabled: stats.enabled
           },
-          ...components ? { components } : {},
           ...rasterizer ? { rasterizer } : {}
         },
         meta: { timestamp: (/* @__PURE__ */ new Date()).toISOString() }
@@ -2435,35 +2468,13 @@ function createFormatRouter(adapter) {
       });
     }
   });
-  router.get("/cache-analytics", async (c) => {
-    try {
-      const analytics = await adapter.getComponentCacheAnalytics?.();
-      if (!analytics) {
-        return c.json({
-          success: true,
-          data: null,
-          meta: { timestamp: (/* @__PURE__ */ new Date()).toISOString() }
-        });
-      }
-      return c.json({
-        success: true,
-        data: analytics,
-        meta: { timestamp: (/* @__PURE__ */ new Date()).toISOString() }
-      });
-    } catch (error) {
-      logger.error("Failed to get cache analytics", { error });
-      throw new HTTPException4(500, {
-        message: "Failed to get cache analytics"
-      });
-    }
-  });
   router.delete("/cache", async (c) => {
     try {
       const cacheService = getContainer().get("cacheService");
       cacheService.clear();
       const cli = await import("@json-to-office/jto-cli");
       cli.invalidateAllCaches();
-      await adapter.clearComponentCache?.();
+      await adapter.resetCacheStats?.();
       await cli.clearRasterizerCache?.();
       return c.json({
         success: true,
@@ -4171,7 +4182,7 @@ function createDevCommand(adapter) {
 }
 
 // src/cli.ts
-var PACKAGE_VERSION = true ? "0.38.0" : "dev-mode";
+var PACKAGE_VERSION = true ? "1.0.0" : "dev-mode";
 var program = new Command2();
 program.name("jto").description("JSON to Office CLI - Generate .docx and .pptx from JSON").version(PACKAGE_VERSION);
 registerCoreCommands(program, {