入出力形式単純化： WOFF系フォントの入力およびBase64形式の入出力をオミット (#11)

* style: code formatting

* chore: bypass wrong type declaration of UPNG

* test: readFile系の関数をwrapperで置き換え（Buffer - Uint8Array 非互換の回避のため）

* build: TypeScript バージョン最新化

* build: rollup バージョン最新化

* build: TypeScript 3.4 のサポートをオミット

* chore: upgrade devDependencies (prettier, rimraf, http-server)

* chore: remove unused node-fetch from devDependencies

* build: update target es2020 -> es2022

* build: fontkit を v2.0.4-mod.2025.3 に更新

* fix!: PDFDocument の各種メソッドでBase64形式の入力受付をオミット

* fix!: PDFDocument の saveAsBase64 メソッドをオミット

* chore: 不要になったBase64系のテストデータを削除

* docs: update changelog

* build: fontkit を v2.0.4-mod.2025.4 に更新

---------

Co-authored-by: FAL <contact@fal-works.com>

Author: falworks-dy

.github/workflows/npm-publish-github-packages.yml

@@ -30,7 +30,6 @@ jobs:
             cjs/
             es/
             umd/
-            ts3.4/
 
   publish-gpr:
     needs: build

MODIFICATIONS.md

@@ -1,5 +1,20 @@
 # Modifications
 
+## [Unreleased]
+
+### Feature Removals
+
+- Remove WOFF/WOFF2/DFont support from `PDFDocument#embedFont` by updating `@denkiyagi/fontkit` to `2.0.4-mod.2025.4`;
+  only `*.ttf` and `*.otf` font formats are now supported.
+- Remove Base64 string/dataURI inputs across `PDFDocument` loading, embedding, and attachments;
+  binary data must now be provided as `Uint8Array` or `ArrayBuffer`.
+- Remove Base64 output by removing the `PDFDocument#saveAsBase64` method;
+  use `PDFDocument#save` which resolves a `Uint8Array` instead.
+
+### Internal Changes
+
+- Update several devDependencies including `typescript` to their latest versions.
+
 ## [1.17.1-mod.2025.7]
 
 - Add `PDFDocument#embedTTFFont` (subset-only) and `CustomFontSubsetEmbedder.forTTFFont` so pre-created fontkit `TTFFont` instances can be embedded.

apps/node/index.ts

@@ -72,7 +72,6 @@ const assets = {
   fonts: {
     ttf: {
       ubuntu_r: readFont('ubuntu/Ubuntu-R.ttf'),
-      ubuntu_r_base64: String(readFont('ubuntu/Ubuntu-R.ttf.base64')),
       bio_rhyme_r: readFont('bio_rhyme/BioRhymeExpanded-Regular.ttf'),
       press_start_2p_r: readFont('press_start_2p/PressStart2P-Regular.ttf'),
       indie_flower_r: readFont('indie_flower/IndieFlower.ttf'),
@@ -91,17 +90,11 @@ const assets = {
   images: {
     jpg: {
       cat_riding_unicorn: readImage('cat_riding_unicorn.jpg'),
-      cat_riding_unicorn_base64: String(
-        readImage('cat_riding_unicorn.jpg.base64'),
-      ),
       minions_laughing: readImage('minions_laughing.jpg'),
       cmyk_colorspace: readImage('cmyk_colorspace.jpg'),
     },
     png: {
       greyscale_bird: readImage('greyscale_bird.png'),
-      greyscale_bird_base64_uri: String(
-        readImage('greyscale_bird.png.base64.uri'),
-      ),
       minions_banana_alpha: readImage('minions_banana_alpha.png'),
       minions_banana_no_alpha: readImage('minions_banana_no_alpha.png'),
       small_mario: readImage('small_mario.png'),
@@ -112,11 +105,7 @@ const assets = {
   },
   pdfs: {
     normal: readPdf('normal.pdf'),
-    normal_base64: String(readPdf('normal.pdf.base64')),
     with_update_sections: readPdf('with_update_sections.pdf'),
-    with_update_sections_base64_uri: String(
-      readPdf('with_update_sections.pdf.base64.uri'),
-    ),
     linearized_with_object_streams: readPdf(
       'linearized_with_object_streams.pdf',
     ),

apps/node/tests/test1.ts

@@ -233,7 +233,7 @@ export default async (assets: Assets) => {
 
   const { fonts } = assets;
 
-  const ubuntuFont = await pdfDoc.embedFont(fonts.ttf.ubuntu_r_base64, {
+  const ubuntuFont = await pdfDoc.embedFont(fonts.ttf.ubuntu_r, {
     subset: true,
   });
   page2.drawText(ipsumLines.join('\n'), {
@@ -318,13 +318,9 @@ export default async (assets: Assets) => {
 
   const { jpg, png } = assets.images;
 
-  const catRidingUnicornImage = await pdfDoc.embedJpg(
-    jpg.cat_riding_unicorn_base64,
-  );
+  const catRidingUnicornImage = await pdfDoc.embedJpg(jpg.cat_riding_unicorn);
   const minionsLaughingImage = await pdfDoc.embedJpg(jpg.minions_laughing);
-  const greyscaleBirdImage = await pdfDoc.embedPng(
-    png.greyscale_bird_base64_uri,
-  );
+  const greyscaleBirdImage = await pdfDoc.embedPng(png.greyscale_bird);
   const minionsBananaAlphaImage = await pdfDoc.embedPng(
     png.minions_banana_alpha,
   );

apps/node/tests/test3.ts

@@ -11,12 +11,12 @@ import {
 export default async (assets: Assets) => {
   const { pdfs, images } = assets;
 
-  const pdfDoc = await PDFDocument.load(pdfs.with_update_sections_base64_uri, {
+  const pdfDoc = await PDFDocument.load(pdfs.with_update_sections, {
     parseSpeed: ParseSpeeds.Fastest,
     updateMetadata: false,
   });
 
-  await pdfDoc.attach(pdfs.normal_base64, 'tax_form.pdf', {
+  await pdfDoc.attach(pdfs.normal, 'tax_form.pdf', {
     mimeType: 'application/pdf',
     description: 'D-2210 tax form for 2012 🏦',
     creationDate: new Date('2004/04/04'),
@@ -120,9 +120,5 @@ export default async (assets: Assets) => {
   console.log('Creation Date:', pdfDoc.getCreationDate());
   console.log('Modification Date:', pdfDoc.getModificationDate());
 
-  const base64Pdf = await pdfDoc.saveAsBase64();
-
-  const pdfBytes = Buffer.from(base64Pdf, 'base64');
-
-  return pdfBytes;
+  return pdfDoc.save();
 };

apps/node/tests/test4.ts

@@ -12,7 +12,7 @@ import {
 export default async (assets: Assets) => {
   const { pdfs, images } = assets;
 
-  const pdfDoc = await PDFDocument.load(pdfs.normal_base64, {
+  const pdfDoc = await PDFDocument.load(pdfs.normal, {
     parseSpeed: ParseSpeeds.Fastest,
   });
 

apps/node/tests/test6.ts

@@ -16,16 +16,12 @@ export default async (assets: Assets) => {
     modificationDate: new Date('1992/05/07'),
   });
 
-  await pdfDoc.attach(
-    images.jpg.cat_riding_unicorn_base64,
-    'cat_riding_unicorn.jpg',
-    {
-      mimeType: 'image/jpeg',
-      description: 'Cool cat riding a unicorn! 🦄🐈🕶️',
-      creationDate: new Date('2019/12/01'),
-      modificationDate: new Date('2020/04/19'),
-    },
-  );
+  await pdfDoc.attach(images.jpg.cat_riding_unicorn, 'cat_riding_unicorn.jpg', {
+    mimeType: 'image/jpeg',
+    description: 'Cool cat riding a unicorn! 🦄🐈🕶️',
+    creationDate: new Date('2019/12/01'),
+    modificationDate: new Date('2020/04/19'),
+  });
 
   const nunitoLigaFont = await pdfDoc.embedFont(fonts.ttf.nunito, {
     subset: true,

apps/node/tsconfig.json

@@ -1,7 +1,7 @@
 {
   "compilerOptions": {
     /* Basic Options */
-    "target": "es2020",
+    "target": "es2022",
     "module": "commonjs",
     "composite": false,
     "incremental": true,

apps/web/test1.html

@@ -36,9 +36,6 @@
     const fetchBinaryAsset = (asset) =>
       fetch(`/assets/${asset}`).then((res) => res.arrayBuffer());
 
-    const fetchStringAsset = (asset) =>
-      fetch(`/assets/${asset}`).then((res) => res.text());
-
     const renderInIframe = (pdfBytes) => {
       const blob = new Blob([pdfBytes], { type: 'application/pdf' });
       const blobUrl = URL.createObjectURL(blob);
@@ -285,7 +282,7 @@
       page2.setFontColor(rgb(101 / 255, 123 / 255, 131 / 255));
 
       const [
-        ubuntuBase64,
+        ubuntuBytes,
         fantasqueBytes,
         indieFlowerBytes,
         greatVibesBytes,
@@ -294,7 +291,7 @@
         pressStart2PBytes,
         hussar3DBytes,
       ] = await Promise.all([
-        fetchStringAsset('fonts/ubuntu/Ubuntu-R.ttf.base64'),
+        fetchBinaryAsset('fonts/ubuntu/Ubuntu-R.ttf'),
         fetchBinaryAsset(
           'fonts/fantasque/OTF/FantasqueSansMono-BoldItalic.otf',
         ),
@@ -306,7 +303,7 @@
         fetchBinaryAsset('fonts/hussar_3d/Hussar3DFour.otf'),
       ]);
 
-      const ubuntuFont = await pdfDoc.embedFont(ubuntuBase64, { subset: true });
+      const ubuntuFont = await pdfDoc.embedFont(ubuntuBytes, { subset: true });
       page2.drawText(ipsumLines.join('\n'), {
         y: size - 20,
         size: 20,
@@ -386,26 +383,26 @@
       const page3 = pdfDoc.addPage([size, page3Height]);
 
       const [
-        catRidingUnicornBase64,
+        catRidingUnicornBytes,
         minionsLaughingBytes,
-        greyscaleBirdBase64,
+        greyscaleBirdBytes,
         minionsBananaAlphaBytes,
         minionsBananaNoAlphaBytes,
         smallMarioBytes,
       ] = await Promise.all([
-        fetchStringAsset('images/cat_riding_unicorn.jpg.base64'),
+        fetchBinaryAsset('images/cat_riding_unicorn.jpg'),
         fetchBinaryAsset('images/minions_laughing.jpg'),
-        fetchStringAsset('images/greyscale_bird.png.base64.uri'),
+        fetchBinaryAsset('images/greyscale_bird.png'),
         fetchBinaryAsset('images/minions_banana_alpha.png'),
         fetchBinaryAsset('images/minions_banana_no_alpha.png'),
         fetchBinaryAsset('images/small_mario.png'),
       ]);
 
       const catRidingUnicornImage = await pdfDoc.embedJpg(
-        catRidingUnicornBase64,
+        catRidingUnicornBytes,
       );
       const minionsLaughingImage = await pdfDoc.embedJpg(minionsLaughingBytes);
-      const greyscaleBirdImage = await pdfDoc.embedPng(greyscaleBirdBase64);
+      const greyscaleBirdImage = await pdfDoc.embedPng(greyscaleBirdBytes);
       const minionsBananaAlphaImage = await pdfDoc.embedPng(
         minionsBananaAlphaBytes,
       );

apps/web/test19.html

@@ -38,11 +38,10 @@
     const fetchBinaryAsset = (asset) =>
       fetch(`/assets/${asset}`).then((res) => res.arrayBuffer());
 
-    const fetchStringAsset = (asset) =>
-      fetch(`/assets/${asset}`).then((res) => res.text());
-
-    const renderInIframe = (pdfDataUri) => {
-      document.getElementById('iframe').src = pdfDataUri;
+    const renderInIframe = (pdfBytes) => {
+      const blob = new Blob([pdfBytes], { type: 'application/pdf' });
+      const blobUrl = URL.createObjectURL(blob);
+      document.getElementById('iframe').src = blobUrl;
     };
 
     async function test() {
@@ -75,12 +74,11 @@
       console.log('PDF encryption with useObjectStreams: false');
       console.log('password:', password);
 
-      const base64PdfDataUri = await pdfDoc.saveAsBase64({
-        dataUri: true,
+      const pdfBytes = await pdfDoc.save({
         useObjectStreams: false,
       });
 
-      renderInIframe(base64PdfDataUri);
+      renderInIframe(pdfBytes);
     }
   </script>
 </html>