nexu-io__open-design/apps/daemon/tests/export-cli-routing.test.ts

import { describe, expect, it } from 'vitest';

import { EXPORT_FORMATS } from '@open-design/contracts';

import {
  buildExportCliResultEnvelope,
  buildExportCliRequestBody,
  resolveExportCliDeckMode,
} from '../src/export-cli-request.js';
import { exportRoutePath } from '../src/export-cli-routing.js';

describe('exportRoutePath', () => {
  it('routes pdf to the raster /export/pdf-image path, not the vector /export route', () => {
    // Regression: the CLI used to send --format pdf to the generic `/export`
    // route, which renders vector PDF via printToPDF() and drops CJK glyphs in
    // the packaged runtime. The UI uses the raster screenshot PDF, so the CLI
    // must match it.
    expect(exportRoutePath('pdf')).toBe('export/pdf-image');
    expect(exportRoutePath('pdf')).not.toBe('export');
  });

  it('routes pptx and image to their screenshot-renderer routes', () => {
    expect(exportRoutePath('pptx')).toBe('export/pptx');
    expect(exportRoutePath('image')).toBe('export/image');
  });

  it('routes html to the headless standalone bundler', () => {
    expect(exportRoutePath('html')).toBe('export/html');
  });

  it('every supported export format maps to a dedicated route', () => {
    for (const format of EXPORT_FORMATS) {
      const route = exportRoutePath(format);
      expect(route.startsWith('export/')).toBe(true);
      expect(route).not.toBe('export');
    }
  });
});

describe('buildExportCliResultEnvelope', () => {
  it('emits path plus the deprecated out alias for JSON output', () => {
    const result = buildExportCliResultEnvelope({
      path: '/tmp/deck.pptx',
      bytes: 123,
      format: 'pptx',
    });
    expect(result).toEqual({
      ok: true,
      path: '/tmp/deck.pptx',
      out: '/tmp/deck.pptx',
      bytes: 123,
      format: 'pptx',
    });
  });
});

describe('buildExportCliRequestBody', () => {
  it('omits deck for pdf/image when --deck is not provided so the daemon can detect decks', () => {
    expect(buildExportCliRequestBody({ fileName: 'deck.html', format: 'pdf' })).toEqual({
      fileName: 'deck.html',
    });
    expect(buildExportCliRequestBody({ fileName: 'deck.html', format: 'image', imageFormat: 'jpeg' })).toEqual({
      fileName: 'deck.html',
      imageFormat: 'jpeg',
    });
  });

  it('serializes explicit deck mode for pdf/image and always for pptx', () => {
    expect(buildExportCliRequestBody({ fileName: 'deck.html', format: 'pdf', deck: true })).toEqual({
      fileName: 'deck.html',
      deck: true,
    });
    expect(buildExportCliRequestBody({ fileName: 'deck.html', format: 'pptx' })).toEqual({
      fileName: 'deck.html',
      deck: true,
    });
  });

  it('serializes explicit page mode for non-deck .slide pages', () => {
    const pageMode = resolveExportCliDeckMode({ format: 'pdf', page: true });
    expect(pageMode).toBe(false);
    if (pageMode !== false) throw new Error('expected explicit page mode');
    const noDeckMode = resolveExportCliDeckMode({ format: 'image', noDeck: true });
    expect(noDeckMode).toBe(false);
    if (noDeckMode !== false) throw new Error('expected explicit no-deck mode');
    expect(
      buildExportCliRequestBody({ fileName: 'landing-with-carousel.html', format: 'pdf', deck: pageMode }),
    ).toEqual({
      fileName: 'landing-with-carousel.html',
      deck: false,
    });
    expect(
      buildExportCliRequestBody({
        fileName: 'landing-with-testimonials.html',
        format: 'image',
        deck: noDeckMode,
        imageFormat: 'jpeg',
      }),
    ).toEqual({
      fileName: 'landing-with-testimonials.html',
      deck: false,
      imageFormat: 'jpeg',
    });
  });

  it('rejects conflicting or impossible CLI deck/page modes', () => {
    expect(() => resolveExportCliDeckMode({ format: 'pdf', deck: true, page: true })).toThrow(
      /cannot be combined/,
    );
    expect(() => resolveExportCliDeckMode({ format: 'pptx', page: true })).toThrow(
      /not valid with --format pptx/,
    );
    expect(() => resolveExportCliDeckMode({ format: 'html', deck: true })).toThrow(
      /not valid with --format html/,
    );
  });
});