doRestart coordinates a process restart, draining all active concurrent tasks before stopping and restarting the process.

embedFacturXXml embeds the Factur-X invoice XML into each PDF under the canonical [gotenberg.FacturXDocumentFileName] name, regardless of the uploaded

embedRoute returns an [api.Route] which can add embedded files to PDFs. TODO: attachments instead?

encryptRoute returns an [api.Route] which can add password protection to PDFs.

ensureHealthy checks the underlying process health and triggers a synchronous restart if the process is unhealthy. Skips the check if a restart is alr

ensureStarted performs a lazy launch of the process on its first use. Concurrent callers serialize on firstStartMu; once the launch succeeds, subseque

exec runs the command and returns its exit code and error.

execErrorType maps an execution failure to a bounded semconv error.type value.

facturXDescription builds the fx rdf:Description carrying the runtime values.

facturXExtensionSchema builds the rdf:Description that declares the PDF/A extension schema for the fx namespace, including the namespace declarations.

facturXRoute returns an [api.Route] which turns existing PDFs into Factur-X documents: it ensures PDF/A-3, embeds the CII invoice XML, and injects the

flattenRoute returns an [api.Route] which can flatten PDFs.

handleConnect handles HTTPS (and any other CONNECT) tunnels. Chromium issues CONNECT host:port; the proxy validates the host, dials the pinned IP, and

handleConnect implements an HTTPS tunnel. It validates the destination host through [gotenberg.DecideOutbound] (synthesizing an https URL), dials the

handleForward handles plain HTTP requests sent to the proxy as absolute URIs (GET http://host/path). The proxy revalidates the URL, then forwards the

handleHttp forwards a plain HTTP request whose URL line is absolute (RFC 7230 5.3.2) through the outbound HTTP client, which validates the destination

httpErrorHandler is the centralized HTTP error handler. It parses the error, returns a response as "text/plain; charset=UTF-8".

httpLikeScheme reports whether scheme is one of http, https, ws, or wss. Only these schemes go through the IP-based address check; data, blob, file, a

injectSchemaIntoExistingBag appends the fx schema entry into an existing pdfaExtension:schemas bag.

latencyMiddleware sets the start time in the [echo.Context] under "startTime". Its value will be used later to calculate request latency. startTime

listenForEventExceptionThrown listens for exceptions in the console and appends those exceptions to the given error pointer. See https://github.com/go

listenForEventLoadingFailed listens for an event indicating that the main page or one or more resources failed to load. See: https://github.com/gotenb

listenForEventRequestPaused listens for requests to check if they are allowed or not. It also set the extra HTTP headers, if any. See https://github.

listenForEventResponseReceived listens for an invalid HTTP status code returned by the main page or by one or more resources. See: https://github.com/

listenForNetworkActivity accumulates per-conversion network activity into aggregate from the always-on Network domain events. It is a no-op when aggre

maybeIdleShutdown stops the process if it has been idle for longer than the configured timeout. It is safe to call concurrently with Run and restart.

maybeRestartAfterTask checks if the maximum request limit has been reached and, if so, triggers an asynchronous restart. If a restart is initiated, it

mergeRoute returns an [api.Route] which can merge PDFs.

newRawTCPServer starts a TCP server on 127.0.0.1:0 that calls handle for every accepted connection. It returns the listener address and a cleanup func

outputFilenameMiddleware sets the output filename in the [echo.Context] under "outputFilename". outputFilename := c.Get("outputFilename").(string)

pipeOutput creates logs entries according to the process stdout and stderr. It does nothing if the logging level is not debug.

readBookmarksRoute returns an [api.Route] which returns the bookmarks of PDFs.

readMetadataRoute returns an [api.Route] which returns the metadata of PDFs.

rootPathMiddleware sets the root path in the [echo.Context] under "rootPath". Its value may be used to skip a middleware execution based on a request

rotateRoute returns an [api.Route] which can rotate pages of PDFs.

runBatch runs all functions simultaneously and waits until all of them are completed or an error is encountered.

screenshotHtmlRoute returns an [api.Route] which can take a screenshot from an HTML file.

screenshotMarkdownRoute returns an [api.Route] which can take a screenshot from Markdown files.

screenshotUrlRoute returns an [api.Route] which can take a screenshot from a URL.

spanAttrs returns the client-span attributes for a LibreOffice invocation: the server address and the LibreOffice version, plus any extra attributes.

splitRoute returns an [api.Route] which can extract pages from a PDF.

stampRoute returns an [api.Route] which can add stamps to PDFs. nolint:dupl

startIdleTicker starts a background goroutine that periodically checks whether the process has been idle long enough to shut down.

telemetryMiddleware manages telemetry. It sets the correlation ID in the [echo.Context] under "correlationId". correlationIdHeader := c.Get("correla

waitForEventDomContentEventFired registers a listener for the DomContentEventFired event and returns a waiter that blocks until the event fires or ctx

waitForEventLoadEventFired registers a listener for the LoadEventFired event and returns a waiter that blocks until the event fires or ctx is done. Se

waitForEventLoadingFinished registers a listener for the LoadingFinished event and returns a waiter that blocks until the event fires or ctx is done.

waitForEventNetworkAlmostIdle registers a listener for the networkIdle2 lifecycle event and returns a waiter that blocks until the event fires or ctx

waitForEventNetworkIdle registers a listener for the networkIdle lifecycle event and returns a waiter that blocks until the event fires or ctx is done

watermarkRoute returns an [api.Route] which can add watermarks to PDFs. nolint:dupl

writeBookmarksRoute returns an [api.Route] which can write bookmarks into PDFs.

writeMetadataRoute returns an [api.Route] which can write metadata into PDFs.

AsyncCount returns the number of asynchronous requests.

BenchmarkHTTPServerRequest allows comparison between different version of the HTTP server. To use an alternative start this test with OTEL_SEMCONV_STA

Checks adds a health check that verifies if Chromium is healthy.

Checks adds a health check that verifies if LibreOffice is healthy.

Chromium returns an [Api] for interacting with Chromium for converting HTML documents to PDF.

ConversionsSinceRestart returns the number of tasks handled since the last process (re)start. reqCounter is reset to zero on every restart and idle sh

Convert is not available in this implementation.

Convert is not available in this implementation.

Convert is not available in this implementation.

Convert is not available in this implementation.

Convert transforms the given PDF to a specific PDF format using the first available engine that supports PDF conversion.

Convert converts the given PDF to a specific PDF format. Currently, only the PDF/A-1b, PDF/A-2b, PDF/A-3b and PDF/UA formats are available. If another