fixes issues so that we pass integration tests (#30)

Author: HungKNguyen

CLAUDE.md

@@ -68,7 +68,7 @@ result = self._http_client.post("/build", files=files, json_data=instructions)
 ```
 
 ### Key Learnings from split_pdf Implementation
-- **Page Ranges**: Use `{"start": 0, "end": 5}` (0-based, end exclusive) and `{"start": 10}` (to end)
+- **Page Ranges**: Use `{"start": 0, "end": 4}` (0-based, end inclusive) and `{"start": 10}` (to end)
 - **Multiple Operations**: Some tools require multiple API calls (one per page range/operation)
 - **Error Handling**: API returns 400 with detailed errors when parameters are invalid
 - **Testing Strategy**: Focus on integration tests with live API rather than unit test mocking

PR_CONTENT.md

@@ -7,14 +7,14 @@ This PR adds 8 new direct API methods that were missing from the Python client,
 
 ### 1. Create Redactions (3 methods for different strategies)
 - `create_redactions_preset()` - Use built-in patterns for common sensitive data
-  - Presets: social-security-number, credit-card-number, email, phone-number, date, currency
+  - Presets: social-security-number, credit-card-number, email-address, international-phone-number, north-american-phone-number, date, time, us-zip-code
 - `create_redactions_regex()` - Custom regex patterns for flexible redaction
 - `create_redactions_text()` - Exact text matches with case sensitivity options
 
 ### 2. PDF Optimization
 - `optimize_pdf()` - Reduce file size with multiple optimization options:
   - Grayscale conversion (text, graphics, images)
-  - Image quality reduction (1-100)
+  - Image optimization quality (1-4, where 4 is most optimized)
   - Linearization for web viewing
   - Option to disable images entirely
 
@@ -82,7 +82,7 @@ client.apply_redactions("redacted.pdf", output_path="final.pdf")
 client.optimize_pdf(
     "large_document.pdf",
     grayscale_images=True,
-    reduce_image_quality=50,
+    image_optimization_quality=4,
     linearize=True,
     output_path="optimized.pdf"
 )
@@ -123,4 +123,4 @@ No migration needed - existing code continues to work as before.
 After merging:
 1. Update README with examples of new methods
 2. Consider adding more tools: HTML to PDF, digital signatures, etc.
-3. Create a cookbook/examples directory with common use cases
+3. Create a cookbook/examples directory with common use cases

SUPPORTED_OPERATIONS.md

@@ -171,16 +171,16 @@ Splits a PDF into multiple documents by page ranges.
 parts = client.split_pdf(
     "document.pdf", 
     page_ranges=[
-        {"start": 0, "end": 5},      # Pages 1-5
-        {"start": 5, "end": 10},     # Pages 6-10
+        {"start": 0, "end": 4},      # Pages 1-5
+        {"start": 5, "end": 9},      # Pages 6-10
         {"start": 10}                # Pages 11 to end
     ]
 )
 
 # Save to specific files
 client.split_pdf(
     "document.pdf",
-    page_ranges=[{"start": 0, "end": 2}, {"start": 2}],
+    page_ranges=[{"start": 0, "end": 1}, {"start": 2}],
     output_paths=["part1.pdf", "part2.pdf"]
 )
 
@@ -264,7 +264,7 @@ Sets custom labels/numbering for specific page ranges in a PDF.
 - `labels`: List of label configurations. Each dict must contain:
   - `pages`: Page range dict with `start` (required) and optionally `end`
   - `label`: String label to apply to those pages
-  - Page ranges use 0-based indexing where `end` is exclusive.
+  - Page ranges use 0-based indexing where `end` is inclusive.
 - `output_path`: Optional path to save the output file
 
 **Returns:**
@@ -276,8 +276,8 @@ Sets custom labels/numbering for specific page ranges in a PDF.
 client.set_page_label(
     "document.pdf",
     labels=[
-        {"pages": {"start": 0, "end": 3}, "label": "Introduction"},
-        {"pages": {"start": 3, "end": 10}, "label": "Chapter 1"},
+        {"pages": {"start": 0, "end": 2}, "label": "Introduction"},
+        {"pages": {"start": 3, "end": 9}, "label": "Chapter 1"},
         {"pages": {"start": 10}, "label": "Appendix"}
     ],
     output_path="labeled_document.pdf"
@@ -286,7 +286,7 @@ client.set_page_label(
 # Set label for single page
 client.set_page_label(
     "document.pdf",
-    labels=[{"pages": {"start": 0, "end": 1}, "label": "Cover Page"}]
+    labels=[{"pages": {"start": 0, "end": 0}, "label": "Cover Page"}]
 )
 ```
 
@@ -318,7 +318,7 @@ client.build(input_file="report.docx") \
 client.build(input_file="document.pdf") \
     .add_step("rotate-pages", {"degrees": 90}) \
     .set_page_labels([
-        {"pages": {"start": 0, "end": 3}, "label": "Introduction"},
+        {"pages": {"start": 0, "end": 2}, "label": "Introduction"},
         {"pages": {"start": 3}, "label": "Content"}
     ]) \
     .execute(output_path="labeled_document.pdf")
@@ -383,4 +383,4 @@ Common exceptions:
 - `APIError` - General API errors with status code
 - `ValidationError` - Invalid parameters
 - `FileNotFoundError` - File not found
-- `ValueError` - Invalid input values
+- `ValueError` - Invalid input values