Method buildDocument

src/parser/document-parser.ts:426–877

* Build the final ParsedDocument with lazy object loading.

(
    version: string,
    xref: Map<number, XRefEntry>,
    trailer: PdfDict,
    recoveredViaBruteForce: boolean,
  )

   * Build the final ParsedDocument with lazy object loading.
   */
  private buildDocument(
    version: string,
    xref: Map<number, XRefEntry>,
    trailer: PdfDict,
    recoveredViaBruteForce: boolean,
  ): ParsedDocument {
    // Object cache: "objNum genNum" -> PdfObject (null = known-unparseable)
    const cache = new Map<string, PdfObject | null>();

    const lenient = this.options.lenient ?? true;

    const recoveryOptions = {
      recoveryMode: lenient,
      onWarning: (message: string, position: number) => {
        this.warnings.push(`Object parse warning at offset ${position}: ${message}`);
      },
    };

    // Object stream cache: streamObjNum -> ObjectStreamParser
    const objectStreamCache = new Map<number, ObjectStreamParser>();

    // ─────────────────────────────────────────────────────────────────────────────
    // Encryption setup
    // ─────────────────────────────────────────────────────────────────────────────

    let securityHandler: StandardSecurityHandler | null = null;
    let encryptionDict: EncryptionDict | null = null;

    const isEncrypted = isEncryptedTrailer(trailer);

    if (isEncrypted) {
      try {
        // Get /Encrypt dictionary
        const encryptRef = trailer.getRef("Encrypt");

        let encryptDictObj: PdfDict | null = null;

        if (encryptRef) {
          // Need to load the encrypt dict without decryption
          const entry = xref.get(encryptRef.objectNumber);

          if (entry?.type === "uncompressed") {
            const parser = new IndirectObjectParser(this.scanner);
            const result = parser.parseObjectAt(entry.offset);

            if (result.value instanceof PdfDict) {
              encryptDictObj = result.value;
            }
          }
        } else {
          // Direct dictionary (rare but valid)
          encryptDictObj = trailer.getDict("Encrypt") ?? null;
        }

        if (encryptDictObj) {
          encryptionDict = parseEncryptionDict(encryptDictObj);

          // Get file ID from trailer