@aibrains/pdf-renderer 0.9.0 → 0.10.1

package/dist/core/fonts.d.ts

@@ -8,7 +8,10 @@
  * Both are sourced from @fontsource/* at build time and copied to ./fonts/ at the
  * package root (see scripts/copy-fonts.js). At runtime, paths resolve identically
  * from `src/core/fonts.ts` and `dist/core/fonts.js` because both live two
- * directories below the package root (../../fonts/).
+ * directories below the package root (../../fonts/). A consumer that bundles
+ * this module into a single file (esbuild for AWS Lambda) loses that layout:
+ * `__dirname` is then the bundle's own directory. Such a consumer ships the
+ * `fonts/` directory beside its bundle and names it in `PDF_FONT_DIR`.
  *
  * Devanagari rendering uses Yoga + Fontkit + Harfbuzz inside @react-pdf/renderer v4
  * to handle complex script shaping (conjuncts, vowel marks). This is the canary for
@@ -23,6 +26,9 @@
  * pick them up via the relative path. URL-based registration for CDN deployments
  * is a Sprint C.2 concern.
  */
+/** Environment variable naming the font directory when the package-relative default cannot apply. */
+export declare const FONT_DIR_ENV = "PDF_FONT_DIR";
+export declare function resolveFontDir(env?: NodeJS.ProcessEnv): string;
 /** Latin font family registered by `registerFonts()`. */
 export declare const FONT_FAMILY_LATIN: "Noto Sans";
 /** Devanagari (Nepali) font family registered by `registerFonts()`. */

package/dist/core/fonts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fonts.d.ts","sourceRoot":"","sources":["../../src/core/fonts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAQH,yDAAyD;AACzD,eAAO,MAAM,iBAAiB,EAAG,WAAoB,CAAC;AACtD,uEAAuE;AACvE,eAAO,MAAM,sBAAsB,EAAG,sBAA+B,CAAC;AAStE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GACvC,OAAO,iBAAiB,GAAG,OAAO,sBAAsB,CAI1D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,CAAC;AAI1C;;;;;;;GAOG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAoCpC;AAED,wFAAwF;AACxF,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}
+{"version":3,"file":"fonts.d.ts","sourceRoot":"","sources":["../../src/core/fonts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAOH,qGAAqG;AACrG,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAE3C,wBAAgB,cAAc,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAG3E;AAED,yDAAyD;AACzD,eAAO,MAAM,iBAAiB,EAAG,WAAoB,CAAC;AACtD,uEAAuE;AACvE,eAAO,MAAM,sBAAsB,EAAG,sBAA+B,CAAC;AAStE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GACvC,OAAO,iBAAiB,GAAG,OAAO,sBAAsB,CAI1D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,CAAC;AAI1C;;;;;;;GAOG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAqCpC;AAED,wFAAwF;AACxF,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}

package/dist/core/fonts.js

@@ -9,7 +9,10 @@
  * Both are sourced from @fontsource/* at build time and copied to ./fonts/ at the
  * package root (see scripts/copy-fonts.js). At runtime, paths resolve identically
  * from `src/core/fonts.ts` and `dist/core/fonts.js` because both live two
- * directories below the package root (../../fonts/).
+ * directories below the package root (../../fonts/). A consumer that bundles
+ * this module into a single file (esbuild for AWS Lambda) loses that layout:
+ * `__dirname` is then the bundle's own directory. Such a consumer ships the
+ * `fonts/` directory beside its bundle and names it in `PDF_FONT_DIR`.
  *
  * Devanagari rendering uses Yoga + Fontkit + Harfbuzz inside @react-pdf/renderer v4
  * to handle complex script shaping (conjuncts, vowel marks). This is the canary for
@@ -58,14 +61,21 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FONT_FAMILY_DEVANAGARI = exports.FONT_FAMILY_LATIN = void 0;
+exports.FONT_FAMILY_DEVANAGARI = exports.FONT_FAMILY_LATIN = exports.FONT_DIR_ENV = void 0;
+exports.resolveFontDir = resolveFontDir;
 exports.pickFontFamily = pickFontFamily;
 exports.registerFonts = registerFonts;
 exports._resetFontsForTest = _resetFontsForTest;
 const path = __importStar(require("node:path"));
 const renderer_1 = require("@react-pdf/renderer");
 const PACKAGE_ROOT = path.resolve(__dirname, '..', '..');
-const FONT_DIR = path.join(PACKAGE_ROOT, 'fonts');
+/** Environment variable naming the font directory when the package-relative default cannot apply. */
+exports.FONT_DIR_ENV = 'PDF_FONT_DIR';
+function resolveFontDir(env = process.env) {
+    var _a;
+    const override = (_a = env[exports.FONT_DIR_ENV]) === null || _a === void 0 ? void 0 : _a.trim();
+    return override ? path.resolve(override) : path.join(PACKAGE_ROOT, 'fonts');
+}
 /** Latin font family registered by `registerFonts()`. */
 exports.FONT_FAMILY_LATIN = 'Noto Sans';
 /** Devanagari (Nepali) font family registered by `registerFonts()`. */
@@ -120,6 +130,7 @@ let registered = false;
 function registerFonts() {
     if (registered)
         return;
+    const FONT_DIR = resolveFontDir();
     // @react-pdf/renderer uses NUMERIC fontWeight internally (400 for normal,
     // 700 for bold). Passing the string 'normal'/'bold' to Font.register stores
     // them as strings but the resolver looks up numerics, so the registration

package/dist/core/fonts.js.map

@@ -1 +1 @@
-{"version":3,"file":"fonts.js","sourceRoot":"","sources":["../../src/core/fonts.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8CH,wCAMC;AAgCD,sCAoCC;AAGD,gDAEC;AA3HD,gDAAkC;AAClC,kDAA2C;AAE3C,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;AAElD,yDAAyD;AAC5C,QAAA,iBAAiB,GAAG,WAAoB,CAAC;AACtD,uEAAuE;AAC1D,QAAA,sBAAsB,GAAG,sBAA+B,CAAC;AAEtE,+EAA+E;AAC/E,uEAAuE;AACvE,0EAA0E;AAC1E,6EAA6E;AAC7E,wDAAwD;AACxD,MAAM,gBAAgB,GAAG,OAAO,CAAC;AAEjC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,SAAgB,cAAc,CAC5B,IAAwC;IAExC,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,yBAAiB,CAAC;IACjF,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IACzB,OAAO,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,8BAAsB,CAAC,CAAC,CAAC,yBAAiB,CAAC;AACjF,CAAC;AAsBD,IAAI,UAAU,GAAG,KAAK,CAAC;AAEvB;;;;;;;GAOG;AACH,SAAgB,aAAa;IAC3B,IAAI,UAAU;QAAE,OAAO;IAEvB,0EAA0E;IAC1E,4EAA4E;IAC5E,0EAA0E;IAC1E,8EAA8E;IAC9E,eAAI,CAAC,QAAQ,CAAC;QACZ,MAAM,EAAE,yBAAiB;QACzB,KAAK,EAAE;YACL;gBACE,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,uBAAuB,CAAC;gBACjD,UAAU,EAAE,GAAG;aAChB;YACD;gBACE,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,oBAAoB,CAAC;gBAC9C,UAAU,EAAE,GAAG;aAChB;SACF;KACF,CAAC,CAAC;IAEH,eAAI,CAAC,QAAQ,CAAC;QACZ,MAAM,EAAE,8BAAsB;QAC9B,KAAK,EAAE;YACL;gBACE,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,iCAAiC,CAAC;gBAC3D,UAAU,EAAE,GAAG;aAChB;YACD;gBACE,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,8BAA8B,CAAC;gBACxD,UAAU,EAAE,GAAG;aAChB;SACF;KACF,CAAC,CAAC;IAEH,UAAU,GAAG,IAAI,CAAC;AACpB,CAAC;AAED,wFAAwF;AACxF,SAAgB,kBAAkB;IAChC,UAAU,GAAG,KAAK,CAAC;AACrB,CAAC"}
+{"version":3,"file":"fonts.js","sourceRoot":"","sources":["../../src/core/fonts.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAUH,wCAGC;AAwCD,wCAMC;AAgCD,sCAqCC;AAGD,gDAEC;AAnID,gDAAkC;AAClC,kDAA2C;AAE3C,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAEzD,qGAAqG;AACxF,QAAA,YAAY,GAAG,cAAc,CAAC;AAE3C,SAAgB,cAAc,CAAC,MAAyB,OAAO,CAAC,GAAG;;IACjE,MAAM,QAAQ,GAAG,MAAA,GAAG,CAAC,oBAAY,CAAC,0CAAE,IAAI,EAAE,CAAC;IAC3C,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;AAC9E,CAAC;AAED,yDAAyD;AAC5C,QAAA,iBAAiB,GAAG,WAAoB,CAAC;AACtD,uEAAuE;AAC1D,QAAA,sBAAsB,GAAG,sBAA+B,CAAC;AAEtE,+EAA+E;AAC/E,uEAAuE;AACvE,0EAA0E;AAC1E,6EAA6E;AAC7E,wDAAwD;AACxD,MAAM,gBAAgB,GAAG,OAAO,CAAC;AAEjC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,SAAgB,cAAc,CAC5B,IAAwC;IAExC,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,yBAAiB,CAAC;IACjF,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IACzB,OAAO,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,8BAAsB,CAAC,CAAC,CAAC,yBAAiB,CAAC;AACjF,CAAC;AAsBD,IAAI,UAAU,GAAG,KAAK,CAAC;AAEvB;;;;;;;GAOG;AACH,SAAgB,aAAa;IAC3B,IAAI,UAAU;QAAE,OAAO;IACvB,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAC;IAElC,0EAA0E;IAC1E,4EAA4E;IAC5E,0EAA0E;IAC1E,8EAA8E;IAC9E,eAAI,CAAC,QAAQ,CAAC;QACZ,MAAM,EAAE,yBAAiB;QACzB,KAAK,EAAE;YACL;gBACE,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,uBAAuB,CAAC;gBACjD,UAAU,EAAE,GAAG;aAChB;YACD;gBACE,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,oBAAoB,CAAC;gBAC9C,UAAU,EAAE,GAAG;aAChB;SACF;KACF,CAAC,CAAC;IAEH,eAAI,CAAC,QAAQ,CAAC;QACZ,MAAM,EAAE,8BAAsB;QAC9B,KAAK,EAAE;YACL;gBACE,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,iCAAiC,CAAC;gBAC3D,UAAU,EAAE,GAAG;aAChB;YACD;gBACE,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,8BAA8B,CAAC;gBACxD,UAAU,EAAE,GAAG;aAChB;SACF;KACF,CAAC,CAAC;IAEH,UAAU,GAAG,IAAI,CAAC;AACpB,CAAC;AAED,wFAAwF;AACxF,SAAgB,kBAAkB;IAChC,UAAU,GAAG,KAAK,CAAC;AACrB,CAAC"}

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,9 +1,9 @@
 {
   "name": "@aibrains/pdf-renderer",
-  "version": "0.9.0",
+  "version": "0.10.1",
   "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",
+  "license": "MIT",
+  "author": "Shoaib Rain",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
@@ -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"