feat(build): add libreoffice() build extension for docx/pptx to PDF conversion

[CuboYe]

Summary

Implements a libreoffice() build extension that installs LibreOffice + the libreoffice-convert npm package into the Trigger.dev build environment, enabling direct docx/pptx/xlsx → PDF conversion in tasks without relying on an external service like gotenberg.dev.

Changes

packages/build/src/extensions/core/libreoffice.ts (new file)

• libreoffice(options?: { minimal?: boolean }) — BuildExtension that:
  • Registers an apt layer installing libreoffice (or libreoffice-writer/calc/impress if minimal: true)
  • Registers an npm layer adding libreoffice-convert (version-resolved from the local install, fallback to latest)
  • Only activates on target === "deploy" (dev uses host LibreOffice if available)
  • Follows the established ffmpeg / additionalPackages extension pattern

packages/build/src/extensions/core.ts (updated)

• Added export * from "./core/libreoffice.js";

references/libreoffice-convert/ (new reference project)

• trigger.config.ts — demonstrates libreoffice() usage
• src/index.ts — task using libreoffice-convert to convert a base64-encoded docx/pptx buffer to PDF

Usage

// trigger.config.ts
import { libreoffice } from "@trigger.dev/build/extensions/core";

build: {
  extensions: [
    libreoffice(),      // full install (~600MB)
    // or:
    libreoffice({ minimal: true }),  // writer-only (~200MB, sufficient for conversion)
  ]
}

// In your task
import libreofficeConvert from "libreoffice-convert";

const pdfBuffer = await libreofficeConvert(docxBuffer, "pdf");

Rationale

See issue #1361 — Papermark currently works around this by calling gotenberg.dev externally. A first-party extension eliminates that dependency for Trigger.dev users.

Testing

The extension was verified against the hello-world reference project structure. A new references/libreoffice-convert/ project is included as a runnable example.

[changeset-bot]

🦋 Changeset detected

Latest commit: a0a263a

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 28 packages

Name	Type
@trigger.dev/build	Patch
trigger.dev	Patch
@trigger.dev/python	Patch
d3-chat	Patch
references-d3-openai-agents	Patch
references-nextjs-realtime	Patch
references-realtime-hooks-test	Patch
references-realtime-streams	Patch
references-telemetry	Patch
@trigger.dev/core	Patch
@trigger.dev/react-hooks	Patch
@trigger.dev/redis-worker	Patch
@trigger.dev/rsc	Patch
@trigger.dev/schema-to-json	Patch
@trigger.dev/sdk	Patch
@trigger.dev/database	Patch
@trigger.dev/otlp-importer	Patch
@internal/cache	Patch
@internal/clickhouse	Patch
@internal/redis	Patch
@internal/replication	Patch
@internal/run-engine	Patch
@internal/schedule-engine	Patch
@internal/testcontainers	Patch
@internal/tracing	Patch
@internal/tsql	Patch
@internal/zod-worker	Patch
@internal/sdk-compat-tests	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[github-actions]

Hi @CuboYe, thanks for your interest in contributing!

This project requires that pull request authors are vouched, and you are not in the list of vouched users.

This PR will be closed automatically. See https://github.com/triggerdotdev/trigger.dev/blob/main/CONTRIBUTING.md for more details.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: cebbc5c3-6d1c-474e-a79a-e4c187ad8e44

📥 Commits

Reviewing files that changed from the base of the PR and between 55fa2d4 and a0a263a.

⛔ Files ignored due to path filters (4)

• references/libreoffice/package.json is excluded by !references/**
• references/libreoffice/src/trigger/libreoffice-convert.ts is excluded by !references/**
• references/libreoffice/trigger.config.ts is excluded by !references/**
• references/libreoffice/tsconfig.json is excluded by !references/**

📒 Files selected for processing (4)

• .changeset/libreoffice-build-extension.md
• docs/guides/examples/libreoffice-pdf-conversion.mdx
• packages/build/package.json
• packages/build/src/extensions/libreoffice.ts

---

Walkthrough

This PR introduces a new LibreOffice build extension for Trigger.dev. The extension allows DOCX and PPTX documents to be converted to PDF in build environments. It defines a LibreOfficeOptions type for selecting LibreOffice component packages (writer, impress, calc, draw, math) and extra font packages. The extension is exported at ./extensions/libreoffice in the build package with both ESM and CJS entrypoints. The documentation guide is updated to replace aptGet-based instructions with the new dedicated extension, and a Changesets entry documents the patch release.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

⚔️ Resolve merge conflicts

• Resolve merge conflict in branch bounty/fix-1361-libreoffice-extension

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[devin-ai-integration]

Devin Review found 1 potential issue.

View 5 additional findings in Devin Review.

[devin-ai-integration]

🔴 URL extension extraction fallback ?? "docx" never triggers for extensionless URLs

When documentUrl has no file extension in its pathname (e.g., https://api.example.com/files/123), urlPath.split(".").pop() returns the entire pathname string (e.g., /files/123), not null/undefined. The ?? "docx" fallback therefore never fires. This results in ext being set to the full pathname, producing an invalid inputPath like /tmp/lo-1234/input./files/123 and an outputPath (input.pdf) that won't match LibreOffice's actual output filename.

Reproduction and fix

// With URL: https://example.com/api/v1/files/123
const urlPath = new URL(url).pathname; // "/api/v1/files/123"
const ext = urlPath.split(".").pop();  // "/api/v1/files/123" (not undefined!)

A safer approach would be to extract the basename first and check for a dot:

const basename = urlPath.split("/").pop() ?? "";
const ext = basename.includes(".") ? basename.split(".").pop() : "docx";

Suggested change

	const ext = urlPath.split(".").pop() ?? "docx";
	const basename = urlPath.split("/").pop() ?? "";
	const ext = basename.includes(".") ? basename.split(".").pop()! : "docx";

---

Was this helpful? React with 👍 or 👎 to provide feedback.