@trupdf/converter

<DocViewer
  source={file}
  converterUrl={process.env.NEXT_PUBLIC_TRUPDF_CONVERTER_URL!}
  converterApiKey={process.env.NEXT_PUBLIC_TRUPDF_CONVERTER_KEY!} // sent as X-TruPDF-API-Key
/>

interface ConversionStrategy {
  readonly id: string;
  canHandle(mimeType: string, filename: string): boolean;
  convert(filename: string, mimeType: string, data: Buffer, options?: ConversionOptions): Promise<Buffer>;
  cacheVariant?(mimeType: string, filename: string): string;
}

import {
  ConversionService,
  PassthroughStrategy,
  OfficeStrategy,
  HTMLStrategy,
  TextStrategy,
  ImageStrategy,
  RasterImageStrategy,
  TruCadStrategy,
} from '@trupdf/converter';

import {
  LocalStorageAdapter,
  S3StorageAdapter, // AWS S3 + MinIO (path-style)
  AzureBlobStorageAdapter,
  WebhookStorageAdapter, // custom HTTP sink with HMAC signing
  createStorageAdapter, // env-driven factory
} from '@trupdf/converter';

interface StorageAdapter {
  put(key: string, bytes: Uint8Array, meta?: Metadata): Promise<{ url: string }>;
  get(key: string): Promise<Uint8Array | null>;
  exists(key: string): Promise<boolean>;
  remove(key: string): Promise<void>;
}

import {
  RedisConversionCache,
  MemoryConversionCache,
  ConversionQueue,
  createConversionWorker,
} from '@trupdf/converter';

import { buildApp, buildRouter } from '@trupdf/converter';
 
const app = buildApp({ logger, cors, license });
app.use(buildRouter({ queue, storage, license }));
app.listen(3002);

interface ConversionRequest {
  filename: string;
  mimeType: string;
  data: Buffer;
  password?: string; // opens encrypted sources
}
 
interface ConversionResult {
  inputHash: string; // SHA-256 of the input — the cache key
  pdf: Buffer;
  strategy: string;
  fromCache: boolean;
  durationMs: number;
}
 
class ConversionError extends Error {
  code: // stable wire codes — switch on these, don't parse messages
    | 'UNSUPPORTED_FORMAT'
    | 'GOTENBERG_UNREACHABLE' // conversion engine unreachable
    | 'GOTENBERG_REJECTED'    // conversion engine rejected the input
    | 'PASSWORD_REQUIRED'
    | 'INVALID_INPUT'
    | 'TIMEOUT'
    | 'CAD_CONVERTER_UNAVAILABLE'
    | 'CAD_CONVERTER_FAILED'
    | 'INTERNAL';
}