fullbleed 0.1.1 → 0.1.3

package/README.md

@@ -4,17 +4,24 @@ Generate PDFs from static HTML and CSS in Node.js. The package includes the
 Fullbleed Rust engine compiled to WebAssembly and four font faces, so installing
 it does not require Python, Rust, a browser, or system fonts. MIT licensed.
 
-This is an optional integration around the unchanged **Fullbleed 2.5.5** engine.
-The Node package has its own version, **0.1.1**.
+This is an optional integration around the unchanged **Fullbleed 2.5.6** engine.
+The Node package has its own version, **0.1.3**. Render promises now wait for their
+worker to exit, including after errors, timeouts, and cancellation, so sequential
+calls do not overlap worker lifetimes.
 
 ## Install and render
 
-Use Node.js 22 or newer. Install the versioned package from its GitHub release:
+Use Node.js 22 or newer. Install the [npm package](https://www.npmjs.com/package/fullbleed):
 
 ```bash
-npm install https://github.com/fullbleed-engine/fullbleed-node/releases/download/v0.1.1/fullbleed-0.1.1.tgz
+npm install fullbleed
 ```
 
+For a version-pinned installation, use `npm install --save-exact fullbleed@0.1.3`.
+The npm tarball is byte-identical to the verified
+[GitHub release](https://github.com/fullbleed-engine/fullbleed-node/releases/tag/v0.1.3).
+See the [installation verification records](https://github.com/fullbleed-engine/fullbleed-node/tree/main/verification).
+
 Save this as `invoice.mjs` and run `node invoice.mjs`:
 
 ```javascript
@@ -57,6 +64,14 @@ npm run example
 Open `output/invoice/invoice.pdf` and `page-1.png`. The [three-page report
 sources](examples/report.html) demonstrate pagination, tables, and vector artwork.
 
+## Use it in Next.js
+
+For a web application, start with the [Next.js PDF download example](examples/nextjs).
+It includes a designed invoice, an App Router handler, production build settings
+for the worker and bundled assets, and a standalone-server verification script.
+The route bounds rendering and returns private PDF attachments from fictional
+data; connect your own authenticated record lookup when adapting it.
+
 ## Fonts and assets
 
 Supply file bytes explicitly. Additional fonts are registered alongside the
@@ -107,7 +122,12 @@ native engine.
 | `allowMissingGlyphs` | Default `false`: reject engine-reported missing glyphs. |
 
 Rendering runs in a dedicated worker. Concurrent calls use separate workers and
-document state. Bound concurrency in a server according to its available memory;
+document state. The returned promise waits for that worker to exit on success,
+render failure, timeout, or cancellation. Awaiting jobs in sequence therefore
+does not overlap their worker lifetimes. A timeout or abort starts termination;
+settlement includes the time needed to stop the worker.
+
+Bound concurrency in a server according to its available memory;
 each worker's WebAssembly memory has a 512 MiB ceiling. HTML and CSS together are
 limited to 4,000,000 UTF-8 bytes; supplied fonts and assets together to 64 MiB.
 Preview images can use substantially more memory than PDF-only rendering.
@@ -143,8 +163,9 @@ arbitrary browser pages.
 
 ## Build and verify from source
 
-Contributors need Node.js 22+ and Rust 1.97.0 with the WASI target. Package users
-do not need a compiler. Dependencies are pinned in both lockfiles.
+Contributors need Node.js 22+ and Rust 1.97.0 with the WASI target. The independent
+PDF text check also uses Python with the test-only `pypdf==6.19.0` reader. Package
+users do not need a compiler or Python. Dependencies are pinned in both lockfiles.
 
 ```bash
 rustup target add wasm32-wasip1
@@ -154,6 +175,8 @@ npm test
 npm run check:types
 npm run verify:native
 npm run verify:pack
+python -m pip install pypdf==6.19.0
+npm run verify:text
 ```
 
 The build records engine metadata, licenses, and artifact hashes in `dist/`.

package/dist/THIRD_PARTY_NOTICES.txt

@@ -1,4 +1,4 @@
-fullbleed 2.5.5 / LICENSE
+fullbleed 2.5.6 / LICENSE
 
 MIT License
 
@@ -23,7 +23,7 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 
 
-fullbleed 2.5.5 / THIRD_PARTY_LICENSES.md
+fullbleed 2.5.6 / THIRD_PARTY_LICENSES.md
 
 <!-- SPDX-License-Identifier: MIT -->
 # Third-Party Licenses

package/dist/build.json

@@ -1,7 +1,7 @@
 {
-  "packageVersion": "0.1.1",
-  "engineVersion": "2.5.5",
-  "engineSource": "https://crates.io/crates/fullbleed/2.5.5",
+  "packageVersion": "0.1.3",
+  "engineVersion": "2.5.6",
+  "engineSource": "https://crates.io/crates/fullbleed/2.5.6",
   "target": "wasm32-wasip1",
   "memoryMaximumBytes": 536870912,
   "fonts": [
@@ -13,7 +13,7 @@
   "dependencies": [
     {
       "name": "fullbleed",
-      "version": "2.5.5",
+      "version": "2.5.6",
       "source": "registry+https://github.com/rust-lang/crates.io-index",
       "license": "MIT"
     },
@@ -44,12 +44,12 @@
   ],
   "files": {
     "dist/engine.wasm": {
-      "bytes": 5047938,
-      "sha256": "60f06871dcd0109f919581f21ba5dac716c2c160094f380d5dba58ec96f0d5ee"
+      "bytes": 5053312,
+      "sha256": "20bc142538c5acf826b162531ed57541d410b033e3666a827934b89ef2fc84cb"
     },
     "dist/THIRD_PARTY_NOTICES.txt": {
       "bytes": 57660,
-      "sha256": "f369b7da5c0d54fb0be0917475e5964cfa276cfe3c7c830f7853213592d41ab8"
+      "sha256": "4a945a683c5f4be6a4c74b59f45aa1f5e6627022a80addddb6eaf68ed3916d9f"
     },
     "assets/fonts/BebasNeue-OFL.txt": {
       "bytes": 4337,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fullbleed",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Generate PDFs from HTML and CSS in Node.js with the Fullbleed Rust engine, bundled fonts, and optional PNG previews.",
   "type": "module",
   "main": "./src/index.cjs",
@@ -34,7 +34,8 @@
     "check:types": "tsc -p tsconfig.json",
     "verify:native": "node tools/verify-native.mjs",
     "example": "node examples/invoice.mjs",
-    "verify:pack": "node tools/verify-pack.mjs"
+    "verify:pack": "node tools/verify-pack.mjs",
+    "verify:text": "python tools/verify-installed-text.py"
   },
   "dependencies": {
     "@bjorn3/browser_wasi_shim": "0.4.2"
@@ -62,7 +63,7 @@
     "access": "public"
   },
   "fullbleed": {
-    "engineVersion": "2.5.5"
+    "engineVersion": "2.5.6"
   },
   "devDependencies": {
     "@types/node": "22.20.5",

package/src/index.cjs

@@ -87,13 +87,20 @@ async function renderPdf(options) {
   if (remaining <= 0) throw new FullbleedError('TIMEOUT', `PDF rendering exceeded ${job.timeoutMs} ms.`);
   return new Promise((resolve, reject) => {
     let worker, timer, settled = false;
-    const finish = (error, result) => {
+    const finish = async (error, result) => {
       if (settled) return;
       settled = true;
       clearTimeout(timer);
       job.signal?.removeEventListener('abort', abort);
-      const termination = worker?.terminate();
-      if (termination) termination.catch(() => {});
+      // A process 'worker' listener can abort synchronously inside the Worker
+      // constructor. Let that constructor assign its handle before cleanup.
+      await Promise.resolve();
+      try {
+        await worker?.terminate();
+      } catch (cause) {
+        reject(new FullbleedError('WORKER_FAILED', 'Could not stop the rendering worker.', { cause }));
+        return;
+      }
       if (error) reject(error); else resolve(result);
     };
     const abort = () => finish(aborted());