WebAssembly Rust 파이프라인을 통한 브라우저 인메모리 PDF 바이너리 생성 및 파싱

1. 클라이언트 사이드 문서 생성의 기술적 필연성과 보안적 가치

엔터프라이즈 환경에서 전자 계약서, 금융 거래 내역서, 악보 및 기술 명세서를 PDF(Portable Document Format)로 발행하는 작업은 오랫동안 백엔드 서버의 전유물이었습니다. 그러나 서버에서 무거운 헤드리스 크롬(Puppeteer)이나 wkhtmltopdf를 구동하여 문서를 생성하는 방식은 동시 접속자 급증 시 심각한 CPU 및 메모리 병목을 유발하며, 사용자의 금융 계좌 번호, 계약 상세 내역 등 민감 정보가 네트워크를 통해 서버 렌더러로 전송되어야 하는 치명적인 데이터 누출 취약점을 안고 있습니다.

서버 사이드 PDF 생성 엔진은 악의적인 사용자가 주입한 SSRF(Server-Side Request Forgery) 공격이나 XSS 공격을 통해 내부 인트라넷 자산이 침해되는 거점 역할을 하기도 합니다. 이에 따라 Every-Forge는 **Rust와 WebAssembly(WASM)**를 결합하여 외부 서버나 브라우저 DOM 렌더링에 일체 의존하지 않는 100% 인메모리 PDF 바이너리 생성 엔진을 구축하였습니다. 사용자의 디바이스에서 C/Rust 수준의 네이티브 속도로 바이트 스트림을 직접 조립하므로, 서버 인프라 비용이 0으로 수렴하면서도 완벽한 기밀성과 즉각적인 다운로드 환경을 제공합니다.

2. 브라우저 PDF 처리 방식별 아키텍처 비교

브라우저 환경에서 PDF 문서를 파싱하거나 생성하기 위해 시도되어 온 접근법들의 장단점을 정리하면 다음과 같습니다.

3. PDF 1.4 바이너리 스펙과 상호참조 테이블(xref) 수학적 구조

PDF는 단순한 텍스트 파일이 아니라, 객체 지향적 계층 구조를 갖는 바이너리 그래프 데이터베이스입니다. 유효한 PDF 1.4 문서는 반드시 다음 4대 물리적 블록으로 구성되어야 합니다:

1. 헤더(Header): %PDF-1.4 및 바이너리 데이터임을 명시하는 128 이상의 하이 바이트 주석 %\xE2\xE3\xCF\xD3.
2. 간접 객체 본문(Body): 폰트, 카탈로그, 페이지 트리, 콘텐츠 스트림 등을 담는 번호 매겨진 객체들 (obj ... endobj).
3. 상호참조 테이블(Cross-Reference Table, xref): 각 객체의 시작 바이트 오프셋 목록.
4. 트레일러(Trailer): 루트 카탈로그 객체 참조와 xref의 물리적 시작 바이트 오프셋.

3.1. 바이트 오프셋 및 xref 수학 모델

$N$개의 간접 객체를 가진 문서에서 $i$번째 객체의 파일 시작점 기준 바이트 위치를 $\text{Offset}_i$라 할 때, xref 테이블의 $i$번째 엔트리는 정확히 20바이트 고정 포맷으로 기록됩니다:

$\text{Entry}_i = \text{pad10}(\text{Offset}_i) \mathbin{\Vert} \text{" "} \mathbin{\Vert} \text{pad5}(\text{GenNum}_i) \mathbin{\Vert} \text{" "} \mathbin{\Vert} \text{Flag} \mathbin{\Vert} \text{"CRLF"}$

트레일러(Trailer) 딕셔너리와 startxref 포인터는 파서가 파일 끝(%%EOF)으로부터 역방향 탐색(Reverse Seek)을 통해 $O(1)$ 시간 복잡도로 루트 노드를 찾을 수 있도록 보장합니다:

$\text{startxref} = \text{ByteLength}(\text{Header}) + \sum_{k=1}^{N} \text{ByteLength}(\text{Obj}_k)$

4. Rust wasm-bindgen과 제로-카피(Zero-Copy) 메모리 전송

JavaScript와 WebAssembly 간에 대용량 바이너리를 전송할 때 발생하는 복사 비용을 제거하기 위해, Every-Forge는 WASM 선형 메모리(Linear Memory)를 직접 브라우저의 ArrayBuffer 및 Blob과 연결합니다.

Rust 메모리 할당기(wee_alloc 또는 dlmalloc)가 페이지 벡터 버퍼를 힙에 생성한 후, 버퍼의 원시 포인터 *const u8와 바이트 길이 usize만을 JS 런타임으로 반환합니다. JS 측은 new Uint8Array(wasmMemory.buffer, ptr, len)을 통해 복사 없이 즉시 바이너리를 참조하며, 필요 시 다운로드 가능한 URL.createObjectURL을 형성합니다.

5. 인메모리 PDF 바이너리 빌더 구현체

다음은 순수 바이너리 스트림 조립 기법을 사용하여 외부 라이브러리 없이 PDF 1.4 문서를 표준 규격에 맞추어 인메모리로 빌드하는 핵심 TypeScript/WASM 브리지 구현체입니다.

// Every-Forge Document Lab: In-Memory Pure PDF-1.4 Binary Builder
export class InMemoryPdfBuilder {
  private buffer: number[] = [];
  private offsets: number[] = [];
  private objectCount = 0;

  constructor() {
    this.writeString("%PDF-1.4\n");
    this.buffer.push(0x25, 0xe2, 0xe3, 0xcf, 0xd3, 0x0a);
  }

  private writeString(str: string): void {
    for (let i = 0; i < str.length; i++) {
      this.buffer.push(str.charCodeAt(i));
    }
  }

  beginObject(): number {
    this.objectCount++;
    this.offsets.push(this.buffer.length);
    this.writeString(`${this.objectCount} 0 obj\n`);
    return this.objectCount;
  }

  endObject(): void {
    this.writeString("endobj\n");
  }

  buildSimpleDocument(text: string): Uint8Array {
    this.beginObject();
    this.writeString("<< /Type /Catalog /Pages 2 0 R >>\n");
    this.endObject();

    this.beginObject();
    this.writeString("<< /Type /Pages /Kids [3 0 R] /Count 1 >>\n");
    this.endObject();

    this.beginObject();
    this.writeString(
      "<< /Type /Page /Parent 2 0 R /MediaBox [0 0 595.28 841.89] /Contents 4 0 R /Resources << /Font << /F1 5 0 R >> >> >>\n"
    );
    this.endObject();

    const streamContent = `BT /F1 16 Tf 50 780 Td (${text}) Tj ET`;
    this.beginObject();
    this.writeString(`<< /Length ${streamContent.length} >>\nstream\n`);
    this.writeString(streamContent);
    this.writeString("\nendstream\n");
    this.endObject();

    this.beginObject();
    this.writeString("<< /Type /Font /Subtype /Type1 /BaseFont /Helvetica >>\n");
    this.endObject();

    const startXref = this.buffer.length;
    this.writeString(`xref\n0 ${this.objectCount + 1}\n`);
    this.writeString("0000000000 65535 f \r\n");

    for (const offset of this.offsets) {
      const paddedOffset = offset.toString().padStart(10, "0");
      this.writeString(`${paddedOffset} 00000 n \r\n`);
    }

    this.writeString(
      `trailer\n<< /Size ${this.objectCount + 1} /Root 1 0 R >>\nstartxref\n${startXref}\n%%EOF\n`
    );

    return new Uint8Array(this.buffer);
  }
}

6. FlateDecode(zlib) 무손실 압축과 CJK 유니코드 폰트 서브세팅 수학

완전한 PDF 문서를 웹에서 실무적으로 배포하기 위해서는 파일 용량 최적화와 다국어 폰트 임베딩이 필수적입니다. 본 엔진은 Rust의 miniz_oxide 크레이트를 WASM으로 컴파일하여 콘텐츠 스트림에 FlateDecode (RFC 1951 Deflate) 무손실 압축을 적용합니다.

허프만 부호화(Huffman Coding)와 LZ77 슬라이딩 윈도우 알고리즘의 결합을 통해 텍스트 및 벡터 드로잉 바이트 스트림은 평균 65%~80% 이상 압축됩니다. 또한 한글 11,172자를 모두 포함하는 10MB 이상의 무거운 원본 OTF/TTF 폰트 파일 전체를 임베딩하는 대신, 실제 문서에서 사용된 글리프(Glyph) 인덱스만을 추출하여 50KB 미만으로 축소하는 동적 글리프 서브세팅(Glyph Subsetting) 알고리즘을 적용함으로써 고화질 한글 인쇄 품질과 초경량 파일 용량을 동시에 달성합니다.

7. 결론 및 Every-Forge PDF 도구 생태계

완전한 인메모리 PDF 아키텍처는 기업의 기밀 문서 유출 방지와 서버리스 인프라 비용 절감이라는 두 가지 거대한 가치를 동시에 제공합니다.

브라우저 내에서 다양한 데이터 및 텍스트를 즉각적으로 조합하여 표준 PDF로 변환하는 실제 고성능 파이프라인은 Every-Forge 인메모리 PDF 도구 바로가기에서 직접 사용하고 체험해 보실 수 있습니다.