Feature: Split PDFs by Chapters/Bookmarks

[Rudra-241]

Description

Feature to split PDFs by bookmarks, this feature only works for PDF files that contain outlines. Command to test it using curl:

curl --location 'http://{API_URL}/api/v1/general/split-pdf-by-chapters' \
--form 'fileInput=@"path/to/file.pdf"' \
--form 'includeMetadata="true"' \
--form 'bookmarkLevel="0"' \
--form 'allowDuplicates="true"' \
--output path/to/response.zip

Fields

• bookmarkLevel: specifies the maximum level of bookmarks required. 0 means top level bookmarks.
• includeMetadata: specifies whether to include the original file's metadata in all the split files.
• allowDuplicates: Controls the behavior when multiple bookmarks correspond to the same page. If true, duplicates are generated; if false, bookmarks corresponding to the same page are merged into a single entry.

Partially addresses #(1592)
The requester wants this feature to apply to all PDFs, including those that do not have outlines.

Checklist:

• I have read the Contribution Guidelines
• I have performed a self-review of my own code
• I have commented my code, particularly in hard-to-understand areas
• My changes generate no new warnings

[Frooodle]

Looks good to me!