pyUSPTO 0.4.1__tar.gz → 0.4.3__tar.gz

{pyuspto-0.4.1 → pyuspto-0.4.3}/.github/workflows/publish-docs.yaml

@@ -31,7 +31,7 @@ jobs:
           cd docs
           make html
       - name: Archive documentation
-        uses: actions/upload-artifact@v6
+        uses: actions/upload-artifact@v7
         with:
           name: documentation
           path: docs/build/html/

{pyuspto-0.4.1 → pyuspto-0.4.3}/.github/workflows/publish-to-test-pypi.yml

@@ -32,7 +32,7 @@ jobs:
     - name: Build a binary wheel and a source tarball
       run: python3 -m build
     - name: Store the distribution packages
-      uses: actions/upload-artifact@v6
+      uses: actions/upload-artifact@v7
       with:
         name: python-package-distributions
         path: dist/
@@ -53,7 +53,7 @@ jobs:
 
     steps:
     - name: Download all the dists
-      uses: actions/download-artifact@v7
+      uses: actions/download-artifact@v8
       with:
         name: python-package-distributions
         path: dist/
@@ -76,7 +76,7 @@ jobs:
 
     steps:
     - name: Download all the dists
-      uses: actions/download-artifact@v7
+      uses: actions/download-artifact@v8
       with:
         name: python-package-distributions
         path: dist/

{pyuspto-0.4.1 → pyuspto-0.4.3}/.github/workflows/python-tests.yml

@@ -25,8 +25,7 @@ jobs:
         run: |
           python -m pip install --upgrade pip
           pip install -r requirements.txt
-          pip install -r requirements-dev.txt
-          pip install -e .
+          pip install -e ".[test]"
 
       - name: Run tests
         run: |
@@ -46,12 +45,12 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v6
         with:
-          python-version: "3.10"
+          python-version: "3.14"
 
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
-          pip install ruff mypy
+          pip install -e ".[lint]"
 
       - name: Lint with ruff
         run: |

{pyuspto-0.4.1 → pyuspto-0.4.3}/CONTRIBUTING.md

@@ -22,6 +22,8 @@ cd pyUSPTO
 
 ### Set Up Development Environment
 
+> **Note:** Python 3.11+ is required for the development environment. Some dev dependencies (e.g. `myst-parser`) do not support Python 3.10. The package itself supports Python 3.10+.
+
 ```bash
 # Create and activate a virtual environment
 python -m venv venv

{pyuspto-0.4.1 → pyuspto-0.4.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyUSPTO
-Version: 0.4.1
+Version: 0.4.3
 Summary: A Modern Python client for accessing the United States Patent and Trademark Office (USPTO) Open Data Portal (ODP) APIs.
 Author-email: Andrew Piechocki <apiechocki@dunlapcodding.com>
 License-Expression: MIT
@@ -43,19 +43,26 @@ License-File: LICENSE
 Requires-Dist: requests>=2.32.5
 Requires-Dist: typing-extensions>=4.15.0; python_version < "3.11"
 Requires-Dist: tzdata>=2025.3
+Provides-Extra: test
+Requires-Dist: pytest>=9.0.2; extra == "test"
+Requires-Dist: pytest-cov>=7.0.0; extra == "test"
+Requires-Dist: pytest-mock>=3.15.1; extra == "test"
+Requires-Dist: typing_extensions>=4.15.0; extra == "test"
+Provides-Extra: docs
+Requires-Dist: sphinx>=9.1.0; extra == "docs"
+Requires-Dist: sphinx-rtd-theme>=3.1.0; extra == "docs"
+Requires-Dist: sphinx_immaterial>=0.13.9; extra == "docs"
+Requires-Dist: sphinx-autodoc-typehints>=3.9.5; extra == "docs"
+Requires-Dist: sphinx-copybutton>=0.5.2; extra == "docs"
+Requires-Dist: myst-parser>=5.0.0; extra == "docs"
+Provides-Extra: lint
+Requires-Dist: mypy>=1.19.0; extra == "lint"
+Requires-Dist: types-requests>=2.32.4; extra == "lint"
+Requires-Dist: ruff>=0.15.0; extra == "lint"
 Provides-Extra: dev
-Requires-Dist: pytest>=9.0.2; extra == "dev"
-Requires-Dist: pytest-cov>=7.0.0; extra == "dev"
-Requires-Dist: pytest-mock>=3.15.1; extra == "dev"
-Requires-Dist: sphinx==8.1.3; extra == "dev"
-Requires-Dist: sphinx-rtd-theme>=3.0.0; extra == "dev"
-Requires-Dist: sphinx_immaterial>=0.13.8; extra == "dev"
-Requires-Dist: sphinx-autodoc-typehints==3.0.1; extra == "dev"
-Requires-Dist: sphinx-copybutton>=0.5.2; extra == "dev"
-Requires-Dist: myst-parser>=4.0.1; extra == "dev"
-Requires-Dist: mypy>=1.19.0; extra == "dev"
-Requires-Dist: types-requests>=2.32.4; extra == "dev"
-Requires-Dist: ruff>=0.15.0; extra == "dev"
+Requires-Dist: pyUSPTO[test]; extra == "dev"
+Requires-Dist: pyUSPTO[docs]; extra == "dev"
+Requires-Dist: pyUSPTO[lint]; extra == "dev"
 Dynamic: license-file
 
 # pyUSPTO

{pyuspto-0.4.1 → pyuspto-0.4.3}/examples/ifw_example.py

@@ -1,7 +1,26 @@
 """Example usage of pyUSPTO for IFW data.
 
-This example demonstrates how to use the PatentDataClient to interact with the USPTO Patent Data API.
-It shows how to retrieve IFW based on various identifying values.
+This example demonstrates how to use the PatentDataClient to retrieve Image File
+Wrapper (IFW) data from the USPTO Patent Data API. It covers:
+
+- get_IFW_metadata(): retrieve a PatentFileWrapper (with populated document_bag)
+  using any of the five supported identifiers:
+    - application_number
+    - patent_number
+    - publication_number
+    - PCT_app_number
+    - PCT_pub_number
+
+- get_IFW(): retrieve metadata AND bulk-download all prosecution history documents
+  (PDF preferred, DOCX fallback; XML and formatless docs are skipped). Returns an
+  IFWResult with:
+    - wrapper: the PatentFileWrapper
+    - output_path: path to the ZIP archive (as_zip=True, default) or output directory
+    - downloaded_documents: dict mapping document_identifier -> filename, allowing
+      each Document in document_bag to be linked to its downloaded file
+
+- download_archive() / download_publication(): download the pgpub or grant XML
+  archive from PrintedMetaData.
 """
 
 import json
@@ -61,6 +80,25 @@ if pct_pub_no_ifw and pct_pub_no_ifw.application_meta_data:
     print(f" - IFW Found based on PCT Pub No: {PCT_pub_number}")
 
 
+print("\nGet IFW + download all prosecution docs as a ZIP archive -->")
+ifw_result = client.get_IFW(application_number=application_number, destination="./download-example", overwrite=True)
+if ifw_result:
+    print(f"Title: {ifw_result.wrapper.application_meta_data.invention_title if ifw_result.wrapper.application_meta_data else 'N/A'}")
+    print(f"Output: {ifw_result.output_path}")
+    doc_bag = ifw_result.wrapper.document_bag or []
+    print(f"Documents downloaded: {len(ifw_result.downloaded_documents)} of {len(doc_bag)}")
+    for doc in doc_bag:
+        if doc.document_identifier:
+            filename = ifw_result.downloaded_documents.get(doc.document_identifier)
+            status = f"-> {filename}" if filename else "(skipped)"
+            print(f"  {doc.document_code} [{doc.document_identifier}] {status}")
+
+print("\nGet IFW + download all prosecution docs as a directory (no ZIP) -->")
+ifw_dir_result = client.get_IFW(application_number=application_number, destination="./download-example", overwrite=True, as_zip=False)
+if ifw_dir_result:
+    print(f"Output directory: {ifw_dir_result.output_path}")
+
+
 print("\nNow let's download the Patent Publication Text -->")
 if app_no_ifw and app_no_ifw.pgpub_document_meta_data:
     pgpub_archive = app_no_ifw.pgpub_document_meta_data

{pyuspto-0.4.1 → pyuspto-0.4.3}/examples/patent_data_example.py

@@ -302,6 +302,28 @@ except Exception as e:
     print(f"Error with POST search: {e}")
 
 
+# Search by CPC classification code
+# CPC codes containing spaces or slashes are automatically quoted for the Lucene query.
+# cpc_classification_bag on ApplicationMetaData is a list[str] of all CPC codes assigned
+# to the application, so each result may have multiple codes.
+try:
+    print("\nSearching by CPC classification code 'H10D  64/667'...")
+    cpc_response = client.search_applications(
+        classification_q="H10D  64/667", limit=3
+    )
+    print(f"Found {cpc_response.count} applications with CPC code H10D 64/667.")
+    for patent_wrapper in cpc_response.patent_file_wrapper_data_bag:
+        app_meta = patent_wrapper.application_meta_data
+        if app_meta:
+            print(
+                f"  - App No: {patent_wrapper.application_number_text}, Title: {app_meta.invention_title}"
+            )
+            if app_meta.cpc_classification_bag:
+                print(f"    CPC codes: {', '.join(app_meta.cpc_classification_bag)}")
+except Exception as e:
+    print(f"Error searching by CPC classification: {e}")
+
+
 # Example of getting status codes
 try:
     print("\nGetting first 5 status codes...")

{pyuspto-0.4.1 → pyuspto-0.4.3}/pyproject.toml

@@ -51,24 +51,17 @@ dependencies = [
 dynamic = ["version"]
 
 [project.optional-dependencies]
-dev = [
-    # Testing
-    "pytest>=9.0.2",
-    "pytest-cov>=7.0.0",
-    "pytest-mock>=3.15.1",
-    # Documentation
-    "sphinx==8.1.3",
-    "sphinx-rtd-theme>=3.0.0",
-    "sphinx_immaterial>=0.13.8",
-    "sphinx-autodoc-typehints==3.0.1",
+test = ["pytest>=9.0.2", "pytest-cov>=7.0.0", "pytest-mock>=3.15.1", "typing_extensions>=4.15.0"]
+docs = [
+    "sphinx>=9.1.0",
+    "sphinx-rtd-theme>=3.1.0",
+    "sphinx_immaterial>=0.13.9",
+    "sphinx-autodoc-typehints>=3.9.5",
     "sphinx-copybutton>=0.5.2",
-    "myst-parser>=4.0.1",
-    # Type checking
-    "mypy>=1.19.0",
-    "types-requests>=2.32.4",
-    # Code quality and formatting
-    "ruff>=0.15.0",
+    "myst-parser>=5.0.0",
 ]
+lint = ["mypy>=1.19.0", "types-requests>=2.32.4", "ruff>=0.15.0"]
+dev = ["pyUSPTO[test]", "pyUSPTO[docs]", "pyUSPTO[lint]"]
 
 [project.urls]
 GitHub = "https://github.com/DunlapCoddingPC/pyUSPTO"

{pyuspto-0.4.1 → pyuspto-0.4.3}/requirements-dev.txt

@@ -12,7 +12,7 @@ appdirs==1.4.4
     # via sphinx-immaterial
 babel==2.18.0
     # via sphinx
-certifi==2026.1.4
+certifi==2026.2.25
     # via requests
 charset-normalizer==3.4.4
     # via requests
@@ -22,14 +22,14 @@ colorama==0.4.6
     #   sphinx
 coverage==7.13.4
     # via pytest-cov
-docutils==0.21.2
+docutils==0.22.4
     # via
     #   myst-parser
     #   sphinx
     #   sphinx-rtd-theme
 idna==3.11
     # via requests
-imagesize==1.4.1
+imagesize==2.0.0
     # via sphinx
 iniconfig==2.3.0
     # via pytest
@@ -39,7 +39,7 @@ jinja2==3.1.6
     #   sphinx
 librt==0.8.1
     # via mypy
-markdown-it-py==3.0.0
+markdown-it-py==4.0.0
     # via
     #   mdit-py-plugins
     #   myst-parser
@@ -52,11 +52,11 @@ mdit-py-plugins==0.5.0
 mdurl==0.1.2
     # via markdown-it-py
 mypy==1.19.1
-    # via pyUSPTO (pyproject.toml)
+    # via pyuspto
 mypy-extensions==1.1.0
     # via mypy
-myst-parser==4.0.1
-    # via pyUSPTO (pyproject.toml)
+myst-parser==5.0.0
+    # via pyuspto
 packaging==26.0
     # via
     #   pytest
@@ -81,41 +81,48 @@ pygments==2.19.2
     #   sphinx
 pytest==9.0.2
     # via
-    #   pyUSPTO (pyproject.toml)
     #   pytest-cov
     #   pytest-mock
+    #   pyuspto
 pytest-cov==7.0.0
-    # via pyUSPTO (pyproject.toml)
+    # via pyuspto
 pytest-mock==3.15.1
-    # via pyUSPTO (pyproject.toml)
+    # via pyuspto
+pyuspto @ file:///C:/Users/andrewp/Documents/GitHub/pyUSPTO
+    # via
+    #   pyUSPTO (pyproject.toml)
+    #   pyuspto
 pyyaml==6.0.3
     # via myst-parser
 requests==2.32.5
     # via
     #   pyUSPTO (pyproject.toml)
+    #   pyuspto
     #   sphinx
     #   sphinx-immaterial
-ruff==0.15.2
-    # via pyUSPTO (pyproject.toml)
+roman-numerals==4.1.0
+    # via sphinx
+ruff==0.15.4
+    # via pyuspto
 snowballstemmer==3.0.1
     # via sphinx
-sphinx==8.1.3
+sphinx==9.1.0
     # via
     #   myst-parser
-    #   pyUSPTO (pyproject.toml)
+    #   pyuspto
     #   sphinx-autodoc-typehints
     #   sphinx-copybutton
     #   sphinx-immaterial
     #   sphinx-rtd-theme
     #   sphinxcontrib-jquery
-sphinx-autodoc-typehints==3.0.1
-    # via pyUSPTO (pyproject.toml)
+sphinx-autodoc-typehints==3.9.6
+    # via pyuspto
 sphinx-copybutton==0.5.2
-    # via pyUSPTO (pyproject.toml)
+    # via pyuspto
 sphinx-immaterial==0.13.9
-    # via pyUSPTO (pyproject.toml)
+    # via pyuspto
 sphinx-rtd-theme==3.1.0
-    # via pyUSPTO (pyproject.toml)
+    # via pyuspto
 sphinxcontrib-applehelp==2.0.0
     # via sphinx
 sphinxcontrib-devhelp==2.0.0
@@ -131,19 +138,22 @@ sphinxcontrib-qthelp==2.0.0
 sphinxcontrib-serializinghtml==2.0.0
     # via sphinx
 types-requests==2.32.4.20260107
-    # via pyUSPTO (pyproject.toml)
+    # via pyuspto
 typing-extensions==4.15.0
     # via
     #   mypy
     #   pydantic
     #   pydantic-core
     #   pydantic-extra-types
+    #   pyuspto
     #   sphinx-immaterial
     #   typing-inspection
 typing-inspection==0.4.2
     # via pydantic
 tzdata==2025.3
-    # via pyUSPTO (pyproject.toml)
+    # via
+    #   pyUSPTO (pyproject.toml)
+    #   pyuspto
 urllib3==2.6.3
     # via
     #   requests

{pyuspto-0.4.1 → pyuspto-0.4.3}/requirements.txt

@@ -4,7 +4,7 @@
 #
 #    pip-compile --output-file=requirements.txt --strip-extras pyproject.toml
 #
-certifi==2026.1.4
+certifi==2026.2.25
     # via requests
 charset-normalizer==3.4.4
     # via requests

{pyuspto-0.4.1 → pyuspto-0.4.3}/src/pyUSPTO/clients/patent_data.py

@@ -4,7 +4,11 @@ This module provides a client for interacting with the USPTO Patent Data API.
 It allows you to search for and retrieve patent application data.
 """
 
+import dataclasses
+import os
+import tempfile
 import warnings
+import zipfile
 from collections.abc import Iterator
 from typing import Any
 
@@ -20,6 +24,7 @@ from pyUSPTO.models.patent_data import (
     DocumentMimeType,
     EventData,
     ForeignPriority,
+    IFWResult,
     PatentDataResponse,
     PatentFileWrapper,
     PatentTermAdjustmentData,
@@ -121,6 +126,9 @@ class PatentDataClient(BaseUSPTOClient[PatentDataResponse]):
         # Example: "PCT/US2024/012345" -> "PCTUS2412345"
         if raw.startswith("PCT"):
             parts = raw.split("/")
+            if len(parts) == 1:
+                # Already sanitized (e.g. "PCTUS0812705"), return as-is
+                return raw
             if len(parts) != 3:
                 raise ValueError(
                     f"Invalid PCT application format: {input_number}. "
@@ -275,21 +283,35 @@ class PatentDataClient(BaseUSPTOClient[PatentDataResponse]):
                         f"applicationMetaData.patentNumber:{patent_number_q}"
                     )
                 if inventor_name_q:
+                    v = (
+                        f'"{inventor_name_q}"'
+                        if " " in inventor_name_q
+                        else inventor_name_q
+                    )
                     q_parts.append(
-                        f"applicationMetaData.inventorBag.inventorNameText:{inventor_name_q}"
+                        f"applicationMetaData.inventorBag.inventorNameText:{v}"
                     )
                 if applicant_name_q:
-                    q_parts.append(
-                        f"applicationMetaData.firstApplicantName:{applicant_name_q}"
+                    v = (
+                        f'"{applicant_name_q}"'
+                        if " " in applicant_name_q
+                        else applicant_name_q
                     )
+                    q_parts.append(f"applicationMetaData.firstApplicantName:{v}")
                 if assignee_name_q:
-                    q_parts.append(
-                        f"assignmentBag.assigneeBag.assigneeNameText:{assignee_name_q}"
+                    v = (
+                        f'"{assignee_name_q}"'
+                        if " " in assignee_name_q
+                        else assignee_name_q
                     )
+                    q_parts.append(f"assignmentBag.assigneeBag.assigneeNameText:{v}")
                 if classification_q:
-                    q_parts.append(
-                        f"applicationMetaData.cpcClassificationBag:{classification_q}"
+                    v = (
+                        f'"{classification_q}"'
+                        if any(c in classification_q for c in [" ", "/"])
+                        else classification_q
                     )
+                    q_parts.append(f"applicationMetaData.cpcClassificationBag:{v}")
                 if earliestPublicationNumber_q:
                     q_parts.append(
                         f"applicationMetaData.earliestPublicationNumber:{earliestPublicationNumber_q}"
@@ -405,21 +427,35 @@ class PatentDataClient(BaseUSPTOClient[PatentDataResponse]):
                         f"applicationMetaData.patentNumber:{patent_number_q}"
                     )
                 if inventor_name_q:
+                    v = (
+                        f'"{inventor_name_q}"'
+                        if " " in inventor_name_q
+                        else inventor_name_q
+                    )
                     q_parts.append(
-                        f"applicationMetaData.inventorBag.inventorNameText:{inventor_name_q}"
+                        f"applicationMetaData.inventorBag.inventorNameText:{v}"
                     )
                 if applicant_name_q:
-                    q_parts.append(
-                        f"applicationMetaData.firstApplicantName:{applicant_name_q}"
+                    v = (
+                        f'"{applicant_name_q}"'
+                        if " " in applicant_name_q
+                        else applicant_name_q
                     )
+                    q_parts.append(f"applicationMetaData.firstApplicantName:{v}")
                 if assignee_name_q:
-                    q_parts.append(
-                        f"assignmentBag.assigneeBag.assigneeNameText:{assignee_name_q}"
+                    v = (
+                        f'"{assignee_name_q}"'
+                        if " " in assignee_name_q
+                        else assignee_name_q
                     )
+                    q_parts.append(f"assignmentBag.assigneeBag.assigneeNameText:{v}")
                 if classification_q:
-                    q_parts.append(
-                        f"applicationMetaData.cpcClassificationBag:{classification_q}"
+                    v = (
+                        f'"{classification_q}"'
+                        if any(c in classification_q for c in [" ", "/"])
+                        else classification_q
                     )
+                    q_parts.append(f"applicationMetaData.cpcClassificationBag:{v}")
 
                 if filing_date_from_q and filing_date_to_q:
                     q_parts.append(
@@ -1036,27 +1072,169 @@ class PatentDataClient(BaseUSPTOClient[PatentDataResponse]):
                 comprehensive data if found using one of the identifiers,
                 otherwise None.
         """
+        wrapper = None
         if application_number:
-            return self.get_application_by_number(application_number=application_number)
-        if patent_number:
+            wrapper = self.get_application_by_number(
+                application_number=application_number
+            )
+        elif patent_number:
             pdr = self.search_applications(patent_number_q=patent_number, limit=1)
             if pdr.patent_file_wrapper_data_bag:
-                return pdr.patent_file_wrapper_data_bag[0]
-        if publication_number:
+                wrapper = pdr.patent_file_wrapper_data_bag[0]
+        elif publication_number:
             pdr = self.search_applications(
                 earliestPublicationNumber_q=publication_number, limit=1
             )
             if pdr.patent_file_wrapper_data_bag:
-                return pdr.patent_file_wrapper_data_bag[0]
-        if PCT_app_number:
-            return self.get_application_by_number(application_number=PCT_app_number)
-        if PCT_pub_number:
+                wrapper = pdr.patent_file_wrapper_data_bag[0]
+        elif PCT_app_number:
+            wrapper = self.get_application_by_number(application_number=PCT_app_number)
+        elif PCT_pub_number:
             pdr = self.search_applications(
                 pctPublicationNumber_q=PCT_pub_number, limit=1
             )
             if pdr.patent_file_wrapper_data_bag:
-                return pdr.patent_file_wrapper_data_bag[0]
-        return None
+                wrapper = pdr.patent_file_wrapper_data_bag[0]
+        if wrapper is None:
+            return None
+        doc_bag = self.get_application_documents(wrapper.application_number_text)
+        return dataclasses.replace(wrapper, document_bag=doc_bag)
+
+    def get_IFW(
+        self,
+        *,
+        application_number: str | None = None,
+        publication_number: str | None = None,
+        patent_number: str | None = None,
+        PCT_app_number: str | None = None,
+        PCT_pub_number: str | None = None,
+        destination: str | None = None,
+        overwrite: bool = False,
+        as_zip: bool = True,
+    ) -> IFWResult | None:
+        """Retrieve IFW metadata and download all prosecution documents.
+
+        Combines `get_IFW_metadata` with a bulk download of all available prosecution
+        history documents (PDF preferred, DOCX fallback). Documents with no downloadable
+        format (e.g., NPL references) are silently skipped. A warning is issued only
+        if a document has a download URL but the download itself fails.
+
+        Args:
+            application_number: USPTO application number (e.g., "16123456").
+            publication_number: USPTO pre-grant publication number.
+            patent_number: USPTO patent number.
+            PCT_app_number: PCT application number.
+            PCT_pub_number: PCT publication number.
+            destination: Directory for output. Defaults to current directory.
+            overwrite: Whether to overwrite an existing output. Default False.
+            as_zip: If True (default), package all downloads into a ZIP archive
+                at ``{destination}/{app_no}_ifw.zip``. If False, download files
+                directly into ``{destination}/{app_no}_ifw/``.
+
+        Returns:
+            IFWResult with the PatentFileWrapper, the output path, and a mapping
+            of document_identifier to filename for each downloaded document.
+            Returns None if no application was found.
+
+        Raises:
+            FileExistsError: If the output path already exists and overwrite=False.
+        """
+        wrapper = self.get_IFW_metadata(
+            application_number=application_number,
+            publication_number=publication_number,
+            patent_number=patent_number,
+            PCT_app_number=PCT_app_number,
+            PCT_pub_number=PCT_pub_number,
+        )
+        if wrapper is None:
+            return None
+
+        dest_dir = destination or "."
+        app_no = wrapper.application_number_text or "unknown"
+        downloaded_documents: dict[str, str] = {}
+
+        if as_zip:
+            output_path = os.path.join(dest_dir, f"{app_no}_ifw.zip")
+            if os.path.exists(output_path) and not overwrite:
+                raise FileExistsError(
+                    f"ZIP archive already exists: {output_path}. Use overwrite=True to replace."
+                )
+            os.makedirs(dest_dir, exist_ok=True)
+            with tempfile.TemporaryDirectory() as tmp_dir:
+                with zipfile.ZipFile(
+                    output_path, "w", compression=zipfile.ZIP_DEFLATED
+                ) as zf:
+                    for doc in wrapper.document_bag or []:
+                        if not doc.document_identifier:
+                            continue
+                        fmt_obj = next(
+                            (
+                                f
+                                for f in doc.document_formats
+                                if f.mime_type_identifier in ("PDF", "MS_WORD")
+                                and f.download_url
+                            ),
+                            None,
+                        )
+                        if fmt_obj is None or not fmt_obj.download_url:
+                            continue
+                        try:
+                            downloaded = self._download_and_extract(
+                                url=fmt_obj.download_url,
+                                destination=tmp_dir,
+                                overwrite=True,
+                            )
+                            arcname = os.path.basename(downloaded)
+                            zf.write(downloaded, arcname=arcname)
+                            downloaded_documents[doc.document_identifier] = arcname
+                        except Exception as exc:
+                            warnings.warn(
+                                f"Failed to download document {doc.document_identifier} "
+                                f"({doc.document_code}): {exc}",
+                                stacklevel=2,
+                            )
+        else:
+            output_path = os.path.join(dest_dir, f"{app_no}_ifw")
+            if os.path.exists(output_path) and not overwrite:
+                raise FileExistsError(
+                    f"Output directory already exists: {output_path}. Use overwrite=True to replace."
+                )
+            os.makedirs(output_path, exist_ok=True)
+            for doc in wrapper.document_bag or []:
+                if not doc.document_identifier:
+                    continue
+                fmt_obj = next(
+                    (
+                        f
+                        for f in doc.document_formats
+                        if f.mime_type_identifier in ("PDF", "MS_WORD")
+                        and f.download_url
+                    ),
+                    None,
+                )
+                if fmt_obj is None or not fmt_obj.download_url:
+                    continue
+                try:
+                    downloaded = self._download_and_extract(
+                        url=fmt_obj.download_url,
+                        destination=output_path,
+                        overwrite=overwrite,
+                    )
+                    downloaded_documents[doc.document_identifier] = os.path.basename(
+                        downloaded
+                    )
+                except Exception as exc:
+                    warnings.warn(
+                        f"Failed to download document {doc.document_identifier} "
+                        f"({doc.document_code}): {exc}",
+                        stacklevel=2,
+                    )
+
+        return IFWResult(
+            wrapper=wrapper,
+            output_path=os.path.abspath(output_path),
+            downloaded_documents=downloaded_documents,
+        )
 
     def download_archive(
         self,