pdf-poppler-binaries-linux-fonts 0.1.0-beta

package/LICENSE

@@ -0,0 +1,27 @@
+ISC License
+
+Copyright (c) 2024 Beat Bachi
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+---
+
+This package includes third-party software with the following licenses:
+
+POPPLER
+License: GPL-2.0 or GPL-3.0
+https://poppler.freedesktop.org/
+
+LIBERATION SANS FONTS
+License: SIL Open Font License 1.1
+https://github.com/liberationfonts/liberation-fonts

package/README.md

@@ -0,0 +1,72 @@
+# pdf-poppler-binaries-linux-fonts
+
+Linux binaries for [pdf-poppler-core](https://www.npmjs.com/package/pdf-poppler-core) with bundled fonts. Designed for environments without system fonts like AWS Lambda, Docker containers, and serverless platforms.
+
+## When to Use This Package
+
+**Use this package if you need to fill PDF forms** (with libraries like `pdf-lib`) and convert them to images in serverless environments. Without bundled fonts, form field values will not render in the output images.
+
+Standard Linux binary packages (`pdf-poppler-binaries-linux`, `pdf-poppler-binaries-aws-2`) do not include fonts, which causes filled form text to be invisible when converting to PNG/JPEG.
+
+## Features
+
+- Poppler 24.08 utilities (pdftocairo, pdfinfo, pdftotext, etc.)
+- Bundled Liberation Sans fonts (Helvetica-compatible)
+- Fontconfig configuration with automatic font substitution
+- All required shared libraries included
+- Xvfb support for headless rendering
+- **PDF form field text renders correctly**
+
+## Installation
+
+```bash
+npm install pdf-poppler-binaries-linux-fonts
+```
+
+## Usage
+
+This package is automatically detected by `pdf-poppler-core` on Linux:
+
+```javascript
+const { PdfPoppler } = require('pdf-poppler-core');
+
+// Auto-detects and uses this package on Linux
+const poppler = new PdfPoppler();
+await poppler.convert('input.pdf', { format: 'png' });
+```
+
+For AWS Lambda:
+
+```javascript
+const poppler = PdfPoppler.forLambda();
+await poppler.convert('input.pdf', { format: 'png' });
+```
+
+## Font Substitution
+
+The package includes Liberation Sans fonts and configures fontconfig to automatically substitute:
+
+- Helvetica → Liberation Sans
+- Helvetica Neue → Liberation Sans
+- Arial → Liberation Sans
+- sans-serif → Liberation Sans
+
+This ensures PDF form fields and text render correctly even without system fonts.
+
+## Package Contents
+
+- `lib/linux/poppler-24.08-xvfb/bin/` - Poppler binaries and Xvfb
+- `lib/linux/poppler-24.08-xvfb/lib/` - Shared libraries
+- `lib/fonts/` - Liberation Sans TTF fonts
+- `lib/fontconfig/fonts.conf` - Fontconfig configuration
+
+## Requirements
+
+- Linux x86_64 (built on Amazon Linux 2023)
+- Node.js 18+
+
+## License
+
+ISC
+
+Poppler is licensed under GPL. Liberation Sans fonts are licensed under SIL Open Font License.

package/index.js

@@ -0,0 +1,45 @@
+const path = require('path');
+
+/**
+ * Returns the base path where Linux poppler binaries are located
+ * @returns {string} The base path to the Linux binaries directory
+ */
+function getBinaryPath() {
+    return path.join(__dirname, 'lib', 'linux');
+}
+
+/**
+ * Returns the path to the bundled fontconfig directory
+ * @returns {string} The path to fontconfig configuration
+ */
+function getFontconfigPath() {
+    return path.join(__dirname, 'lib', 'fontconfig');
+}
+
+/**
+ * Returns the path to the bundled fonts directory
+ * @returns {string} The path to fonts directory
+ */
+function getFontsPath() {
+    return path.join(__dirname, 'lib', 'fonts');
+}
+
+/**
+ * Returns environment variables needed for fontconfig to work with bundled fonts
+ * @returns {object} Environment variables to merge with process.env
+ */
+function getFontconfigEnv() {
+    const fontconfigPath = getFontconfigPath();
+    return {
+        FONTCONFIG_PATH: fontconfigPath,
+        FONTCONFIG_FILE: path.join(fontconfigPath, 'fonts.conf'),
+        FC_CACHEDIR: '/tmp/fontconfig-cache'
+    };
+}
+
+module.exports = {
+    getBinaryPath,
+    getFontconfigPath,
+    getFontsPath,
+    getFontconfigEnv
+};

package/lib/fontconfig/fonts.conf

@@ -0,0 +1,44 @@
+<?xml version="1.0"?>
+<!DOCTYPE fontconfig SYSTEM "urn:fontconfig:fonts.dtd">
+<fontconfig>
+    <!-- Bundled fonts directory -->
+    <dir>/var/task/node_modules/pdf-poppler-binaries-linux-fonts/lib/fonts</dir>
+    <dir>/opt/nodejs/node_modules/pdf-poppler-binaries-linux-fonts/lib/fonts</dir>
+
+    <!-- Fallback to common locations -->
+    <dir prefix="cwd">lib/fonts</dir>
+    <dir>/usr/share/fonts</dir>
+    <dir>/usr/local/share/fonts</dir>
+
+    <!-- Cache directory -->
+    <cachedir>/tmp/fontconfig-cache</cachedir>
+
+    <!-- Default rendering settings -->
+    <match target="font">
+        <edit name="antialias" mode="assign"><bool>true</bool></edit>
+        <edit name="hinting" mode="assign"><bool>true</bool></edit>
+        <edit name="hintstyle" mode="assign"><const>hintslight</const></edit>
+    </match>
+
+    <!-- Map Helvetica to Liberation Sans -->
+    <alias>
+        <family>Helvetica</family>
+        <prefer><family>Liberation Sans</family></prefer>
+    </alias>
+    <alias>
+        <family>Helvetica Neue</family>
+        <prefer><family>Liberation Sans</family></prefer>
+    </alias>
+    <alias>
+        <family>Arial</family>
+        <prefer><family>Liberation Sans</family></prefer>
+    </alias>
+    <alias>
+        <family>sans-serif</family>
+        <prefer><family>Liberation Sans</family></prefer>
+    </alias>
+    <alias>
+        <family>sans</family>
+        <prefer><family>Liberation Sans</family></prefer>
+    </alias>
+</fontconfig>

package/lib/linux/poppler-24.08-xvfb/VERSION

@@ -0,0 +1 @@
+24.08.0-fonts

package/lib/linux/poppler-24.08-xvfb/bin/xvfb-run

@@ -0,0 +1,12 @@
+#!/bin/sh
+# Get the directory where this script is located
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+DISPLAY=:99
+export DISPLAY
+"$SCRIPT_DIR/Xvfb" $DISPLAY -screen 0 1024x768x24 &
+XVFB_PID=$!
+sleep 0.1
+"$@"
+EXIT_CODE=$?
+kill $XVFB_PID 2>/dev/null
+exit $EXIT_CODE

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "pdf-poppler-binaries-linux-fonts",
+  "version": "0.1.0-beta",
+  "description": "Linux binaries for pdf-poppler with bundled fonts. Includes Poppler utilities, fontconfig, and Liberation Sans fonts for environments without system fonts (Lambda, containers).",
+  "main": "index.js",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Boot750/pdf-poppler-core.git",
+    "directory": "packages/pdf-poppler-binaries-linux-fonts"
+  },
+  "homepage": "https://github.com/Boot750/pdf-poppler-core#readme",
+  "bugs": {
+    "url": "https://github.com/Boot750/pdf-poppler-core/issues"
+  },
+  "keywords": [
+    "pdf",
+    "poppler",
+    "linux",
+    "binaries",
+    "fonts",
+    "fontconfig",
+    "pdf2image",
+    "lambda",
+    "aws",
+    "serverless"
+  ],
+  "author": "Beat Bachi",
+  "license": "ISC",
+  "files": [
+    "index.js",
+    "lib",
+    "README.md",
+    "LICENSE"
+  ]
+}