@aibrains/pdf-renderer 0.9.0 → 0.10.0

package/dist/index.d.ts

@@ -29,4 +29,6 @@ import './descriptors/receipt';
 export { ReceiptPdf } from './documents/ReceiptPdf';
 export type { ReceiptTemplateConfig, ReceiptDocumentData } from './documents/ReceiptPdf';
 export { receiptDescriptor } from './descriptors/receipt';
+export { mergePdfBuffers } from './merge-pdfs';
+export type { MergePdfBuffersOptions } from './merge-pdfs';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,eAAO,MAAM,4BAA4B,UAAU,CAAC;AAGpD,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAM9B,OAAO,uBAAuB,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,YAAY,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACzF,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAM1D,OAAO,uBAAuB,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,YAAY,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACzF,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,eAAO,MAAM,4BAA4B,UAAU,CAAC;AAGpD,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAM9B,OAAO,uBAAuB,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,YAAY,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACzF,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAM1D,OAAO,uBAAuB,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,YAAY,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACzF,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAM1D,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -32,7 +32,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.receiptDescriptor = exports.ReceiptPdf = exports.invoiceDescriptor = exports.InvoicePdf = exports.PDF_RENDERER_PACKAGE_VERSION = void 0;
+exports.mergePdfBuffers = exports.receiptDescriptor = exports.ReceiptPdf = exports.invoiceDescriptor = exports.InvoicePdf = exports.PDF_RENDERER_PACKAGE_VERSION = void 0;
 exports.PDF_RENDERER_PACKAGE_VERSION = '0.6.0';
 // Core + primitives + components + descriptor registry from Sprint C.0.
 __exportStar(require("./core"), exports);
@@ -57,4 +57,10 @@ var ReceiptPdf_1 = require("./documents/ReceiptPdf");
 Object.defineProperty(exports, "ReceiptPdf", { enumerable: true, get: function () { return ReceiptPdf_1.ReceiptPdf; } });
 var receipt_1 = require("./descriptors/receipt");
 Object.defineProperty(exports, "receiptDescriptor", { enumerable: true, get: function () { return receipt_1.receiptDescriptor; } });
+// Sprint H.1 — pdf-lib-based helper for concatenating rendered PDF buffers
+// into a single merged output. Consumed by the finance bulk-invoice-pdf-export
+// and bulk-receipt-pdf-export workers when the operator picks
+// `outputFormat: 'merged_pdf'`.
+var merge_pdfs_1 = require("./merge-pdfs");
+Object.defineProperty(exports, "mergePdfBuffers", { enumerable: true, get: function () { return merge_pdfs_1.mergePdfBuffers; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;;;;;;;;;;;;;;;;AAEU,QAAA,4BAA4B,GAAG,OAAO,CAAC;AAEpD,wEAAwE;AACxE,yCAAuB;AACvB,+CAA6B;AAC7B,+CAA6B;AAC7B,gDAA8B;AAE9B,2EAA2E;AAC3E,0EAA0E;AAC1E,qEAAqE;AACrE,mDAAmD;AACnD,iCAA+B;AAC/B,qDAAoD;AAA3C,wGAAA,UAAU,OAAA;AAEnB,iDAA0D;AAAjD,4GAAA,iBAAiB,OAAA;AAE1B,0EAA0E;AAC1E,0EAA0E;AAC1E,yEAAyE;AACzE,yEAAyE;AACzE,iCAA+B;AAC/B,qDAAoD;AAA3C,wGAAA,UAAU,OAAA;AAEnB,iDAA0D;AAAjD,4GAAA,iBAAiB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;;;;;;;;;;;;;;;;AAEU,QAAA,4BAA4B,GAAG,OAAO,CAAC;AAEpD,wEAAwE;AACxE,yCAAuB;AACvB,+CAA6B;AAC7B,+CAA6B;AAC7B,gDAA8B;AAE9B,2EAA2E;AAC3E,0EAA0E;AAC1E,qEAAqE;AACrE,mDAAmD;AACnD,iCAA+B;AAC/B,qDAAoD;AAA3C,wGAAA,UAAU,OAAA;AAEnB,iDAA0D;AAAjD,4GAAA,iBAAiB,OAAA;AAE1B,0EAA0E;AAC1E,0EAA0E;AAC1E,yEAAyE;AACzE,yEAAyE;AACzE,iCAA+B;AAC/B,qDAAoD;AAA3C,wGAAA,UAAU,OAAA;AAEnB,iDAA0D;AAAjD,4GAAA,iBAAiB,OAAA;AAE1B,2EAA2E;AAC3E,+EAA+E;AAC/E,8DAA8D;AAC9D,gCAAgC;AAChC,2CAA+C;AAAtC,6GAAA,eAAe,OAAA"}

package/dist/merge-pdfs.d.ts

@@ -0,0 +1,49 @@
+/**
+ * mergePdfBuffers — Sprint H.1
+ *
+ * Concatenate multiple PDF buffers into a single merged PDF, preserving the
+ * page order of the input list. The output PDF's pages appear in the same
+ * order as the input buffers; each source PDF's pages appear in the same
+ * order they were in the source.
+ *
+ * First step of the merged-PDF output variant for the bulk finance export
+ * (Sprint H). The bulk-invoice-pdf-export and bulk-receipt-pdf-export
+ * workers call this helper after rendering the individual PDFs when the
+ * operator picks `outputFormat: 'merged_pdf'` (see Sprint H.3 for the
+ * worker wiring).
+ *
+ * Determinism:
+ *   pdf-lib's `save()` does NOT auto-refresh ModDate — the only source of
+ *   run-to-run drift is what we set on the document ourselves (CreationDate,
+ *   ModificationDate, Producer, Creator). This function fixes all four to
+ *   known values so identical input yields identical output — required for
+ *   the audit-trail invariant in the worker (a re-run of the same job MUST
+ *   produce byte-identical artifacts so a downstream signature/hash gate is
+ *   stable). `useObjectStreams: false` on save is a secondary belt-and-
+ *   -braces for the same guarantee (see save() call for the rationale).
+ *
+ * Memory profile:
+ *   Peak RSS ≈ Σ(input bytes) + Σ(merged bytes). pdf-lib holds every
+ *   parsed source document + the merged output in memory at once. At the
+ *   Sprint H cap of 1000 documents and typical ~20 kB per invoice PDF,
+ *   that's ~20 MB peak — well within the finance ECS task's 2 GB budget.
+ *   For the 100-invoice pilot case, peak is ~2 MB.
+ */
+export interface MergePdfBuffersOptions {
+    /**
+     * The PDF `/Title` metadata field written into the merged output.
+     * Optional; when omitted, no title is set. Useful for operator-facing
+     * artifacts that show up in the browser's tab title.
+     */
+    title?: string;
+}
+/**
+ * Merge PDF byte buffers into a single output buffer.
+ *
+ * @param buffers - Non-empty list of PDF byte buffers to concatenate.
+ * @param options - Optional metadata overrides.
+ * @returns The merged PDF as a Node Buffer.
+ * @throws When `buffers` is empty.
+ */
+export declare function mergePdfBuffers(buffers: Buffer[], options?: MergePdfBuffersOptions): Promise<Buffer>;
+//# sourceMappingURL=merge-pdfs.d.ts.map

package/dist/merge-pdfs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-pdfs.d.ts","sourceRoot":"","sources":["../src/merge-pdfs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAIH,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,MAAM,CAAC,CAwCjB"}

package/dist/merge-pdfs.js

@@ -0,0 +1,81 @@
+"use strict";
+/**
+ * mergePdfBuffers — Sprint H.1
+ *
+ * Concatenate multiple PDF buffers into a single merged PDF, preserving the
+ * page order of the input list. The output PDF's pages appear in the same
+ * order as the input buffers; each source PDF's pages appear in the same
+ * order they were in the source.
+ *
+ * First step of the merged-PDF output variant for the bulk finance export
+ * (Sprint H). The bulk-invoice-pdf-export and bulk-receipt-pdf-export
+ * workers call this helper after rendering the individual PDFs when the
+ * operator picks `outputFormat: 'merged_pdf'` (see Sprint H.3 for the
+ * worker wiring).
+ *
+ * Determinism:
+ *   pdf-lib's `save()` does NOT auto-refresh ModDate — the only source of
+ *   run-to-run drift is what we set on the document ourselves (CreationDate,
+ *   ModificationDate, Producer, Creator). This function fixes all four to
+ *   known values so identical input yields identical output — required for
+ *   the audit-trail invariant in the worker (a re-run of the same job MUST
+ *   produce byte-identical artifacts so a downstream signature/hash gate is
+ *   stable). `useObjectStreams: false` on save is a secondary belt-and-
+ *   -braces for the same guarantee (see save() call for the rationale).
+ *
+ * Memory profile:
+ *   Peak RSS ≈ Σ(input bytes) + Σ(merged bytes). pdf-lib holds every
+ *   parsed source document + the merged output in memory at once. At the
+ *   Sprint H cap of 1000 documents and typical ~20 kB per invoice PDF,
+ *   that's ~20 MB peak — well within the finance ECS task's 2 GB budget.
+ *   For the 100-invoice pilot case, peak is ~2 MB.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mergePdfBuffers = mergePdfBuffers;
+const pdf_lib_1 = require("pdf-lib");
+const EPOCH = new Date(0);
+/**
+ * Merge PDF byte buffers into a single output buffer.
+ *
+ * @param buffers - Non-empty list of PDF byte buffers to concatenate.
+ * @param options - Optional metadata overrides.
+ * @returns The merged PDF as a Node Buffer.
+ * @throws When `buffers` is empty.
+ */
+async function mergePdfBuffers(buffers, options = {}) {
+    if (buffers.length === 0) {
+        throw new Error('mergePdfBuffers: refusing to merge an empty buffer list');
+    }
+    const merged = await pdf_lib_1.PDFDocument.create();
+    for (const buf of buffers) {
+        // Trusted-input fast path: sources come from our own worker in the same
+        // process, so we can skip pdf-lib's default object-graph validation.
+        // ParseSpeeds.Fastest tells pdf-lib to defer optional integrity checks.
+        const src = await pdf_lib_1.PDFDocument.load(buf, {
+            parseSpeed: pdf_lib_1.ParseSpeeds.Fastest,
+        });
+        const pages = await merged.copyPages(src, src.getPageIndices());
+        for (const page of pages) {
+            merged.addPage(page);
+        }
+    }
+    // Byte-determinism: pdf-lib's save() does NOT auto-refresh ModDate — the
+    // only source of run-to-run drift is the values we set here. Fixing them
+    // to a known epoch is what makes identical input produce identical output.
+    merged.setCreationDate(EPOCH);
+    merged.setModificationDate(EPOCH);
+    merged.setProducer('@aibrains/pdf-renderer mergePdfBuffers');
+    merged.setCreator('@aibrains/pdf-renderer');
+    if (options.title !== undefined) {
+        merged.setTitle(options.title);
+    }
+    const bytes = await merged.save({
+        // useObjectStreams: false emits the classic xref table format instead of
+        // xref streams. Slightly larger output, but byte-stable across pdf-lib
+        // minor upgrades that might change stream-compression heuristics — worth
+        // the size trade for the audit-hash guarantee.
+        useObjectStreams: false,
+    });
+    return Buffer.from(bytes);
+}
+//# sourceMappingURL=merge-pdfs.js.map

package/dist/merge-pdfs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-pdfs.js","sourceRoot":"","sources":["../src/merge-pdfs.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;;AAuBH,0CA2CC;AAhED,qCAAmD;AAWnD,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;AAE1B;;;;;;;GAOG;AACI,KAAK,UAAU,eAAe,CACnC,OAAiB,EACjB,UAAkC,EAAE;IAEpC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,qBAAW,CAAC,MAAM,EAAE,CAAC;IAE1C,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,wEAAwE;QACxE,qEAAqE;QACrE,wEAAwE;QACxE,MAAM,GAAG,GAAG,MAAM,qBAAW,CAAC,IAAI,CAAC,GAAG,EAAE;YACtC,UAAU,EAAE,qBAAW,CAAC,OAAO;SAChC,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,cAAc,EAAE,CAAC,CAAC;QAChE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,yEAAyE;IACzE,yEAAyE;IACzE,2EAA2E;IAC3E,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IAC9B,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAClC,MAAM,CAAC,WAAW,CAAC,wCAAwC,CAAC,CAAC;IAC7D,MAAM,CAAC,UAAU,CAAC,wBAAwB,CAAC,CAAC;IAC5C,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;QAC9B,yEAAyE;QACzE,uEAAuE;QACvE,yEAAyE;QACzE,+CAA+C;QAC/C,gBAAgB,EAAE,KAAK;KACxB,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aibrains/pdf-renderer",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "EdForge PDF rendering library. JSX-based document templates built on @react-pdf/renderer, with localization (EN + NE), Bikram Sambat date support, and a TemplateDescriptor registry for cross-domain doc types (invoice, receipt, report card, admit card, etc.).",
   "license": "BUSL-1.1",
   "author": "Edforge Technologies LLC",
@@ -49,7 +49,8 @@
   },
   "dependencies": {
     "@aibrains/shared-types": "^0.65.0",
-    "@react-pdf/renderer": "^3.4.5"
+    "@react-pdf/renderer": "^3.4.5",
+    "pdf-lib": "^1.17.1"
   },
   "peerDependencies": {
     "react": ">=18.0.0 <20.0.0"