[ianardee]

Description

Types of changes

• Docs change / refactoring / dependency upgrade
• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to change)
• Requires a change to the official Guide documentation.

[Copilot]

🟡 Changes recommended

The client now treats result URLs as IDs, constructing invalid endpoints that break successful asynchronous parsing and existing direct-URL callers.

1 open issue

• Preserve result URL handling for completed async jobs · New

What changed in this PR

Adds explicit URL-based job and result retrieval methods to the V2 client, alongside the existing ID-based methods.

Changes:

• Adds get_job_by_url and get_result_by_url client methods.
• Refactors HTTP retrieval helpers and adds HTTPS URL validation.
• Updates RBS signatures to match the new methods.

File	Description
spec/​v2/​client_v2_spec.rb	Adds a blank line; no test behavior changes.
sig/​mindee/​v2/​http/​mindee_api_v2.rbs	Updates retrieval helper and validation signatures.
sig/​mindee/​v2/​client.rbs	Declares the new URL-based client methods.
lib/​mindee/​v2/​http/​mindee_api_v2.rb	Separates ID and URL retrieval and validates HTTPS URLs.
lib/​mindee/​v2/​client.rb	Exposes URL-based methods and changes existing retrieval delegation.

_{Review effort: Balanced}

[Copilot]

🟡 Changes recommended

Existing HTTPS URL calls to get_result now hit malformed endpoints, while stale polling stubs cause cancellation and timeout tests to enter the real HTTP path.

1 open issue

• Update polling specs to stub get_job_by_url · New

1 resolved since last review

• Preserve result URL handling for completed async jobs

_{Review effort: Balanced}

[Copilot]

🟡 Changes recommended

The change breaks existing callers by treating supported HTTPS result URLs as inference IDs in get_result, producing requests to incorrect endpoints.

3 open issues

• Document the implemented Ruby job lookup method · New
• Test workflow requests using API-returned URLs · New
• Add coverage for HTTPS URL validation · New

1 resolved since last review

• Update polling specs to stub get_job_by_url

_{Review effort: Balanced}