linq-python 0.22.1__tar.gz → 0.23.1__tar.gz

linq_python-0.23.1/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.23.1"
+}

{linq_python-0.22.1 → linq_python-0.23.1}/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.23.1](https://github.com/linq-team/linq-python/compare/v0.23.0...v0.23.1) (2026-08-13)
+
+
+### Bug Fixes
+
+* clarify address format requirements for messaging checks ([1928e59](https://github.com/linq-team/linq-python/commit/1928e5928143f30249bac4429c35f93c331d5668))
+
+## [0.23.0](https://github.com/linq-team/linq-python/compare/v0.22.1...v0.23.0) (2026-08-13)
+
+
+### Features
+
+* add detailed 503 errors and response fields for capability checks ([18bd5e8](https://github.com/linq-team/linq-python/commit/18bd5e8fae0348a88f8a9b4f04894bfc3956f718))
+
 ## [0.22.1](https://github.com/linq-team/linq-python/compare/v0.22.0...v0.22.1) (2026-08-12)
 
 

{linq_python-0.22.1 → linq_python-0.23.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: linq-python
-Version: 0.22.1
+Version: 0.23.1
 Summary: The official Python library for the linq-api-v3 API
 Project-URL: Homepage, https://github.com/linq-team/linq-python
 Project-URL: Repository, https://github.com/linq-team/linq-python

{linq_python-0.22.1 → linq_python-0.23.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "linq-python"
-version = "0.22.1"
+version = "0.23.1"
 description = "The official Python library for the linq-api-v3 API"
 dynamic = ["readme"]
 license = "Apache-2.0"

{linq_python-0.22.1 → linq_python-0.23.1}/src/linq/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "linq"
-__version__ = "0.22.1"  # x-release-please-version
+__version__ = "0.23.1"  # x-release-please-version

{linq_python-0.22.1 → linq_python-0.23.1}/src/linq/resources/capability.py

@@ -62,7 +62,9 @@ class CapabilityResource(SyncAPIResource):
         iMessage.
 
         Args:
-          address: The recipient phone number or email address to check
+          address: The recipient address to check. `check_imessage` accepts an E.164 phone number
+              or an email address; `check_rcs` accepts an E.164 phone number only and rejects
+              an email with a `400`, since RCS has no email addressing.
 
           from_: Optional sender phone number. If omitted, an available phone from your pool is
               used automatically.
@@ -105,8 +107,20 @@ class CapabilityResource(SyncAPIResource):
         """
         Check whether a recipient address (phone number) supports RCS messaging.
 
+        `address` must be an E.164 phone number. RCS has no email addressing, so an
+        email is rejected with a `400` rather than attempted.
+
+        A `200` means the check ran and the answer is about the **recipient**. A `503`
+        means the check could not produce an answer because of a fault on the **sender**
+        line — `4004` (RCS not turned on for the line), `4009` (line has no RCS
+        account), or `4010` (the check could not run). Treat all three as "unknown",
+        never as "the recipient does not support RCS", and do not cache them as a
+        negative result.
+
         Args:
-          address: The recipient phone number or email address to check
+          address: The recipient address to check. `check_imessage` accepts an E.164 phone number
+              or an email address; `check_rcs` accepts an E.164 phone number only and rejects
+              an email with a `400`, since RCS has no email addressing.
 
           from_: Optional sender phone number. If omitted, an available phone from your pool is
               used automatically.
@@ -176,7 +190,9 @@ class AsyncCapabilityResource(AsyncAPIResource):
         iMessage.
 
         Args:
-          address: The recipient phone number or email address to check
+          address: The recipient address to check. `check_imessage` accepts an E.164 phone number
+              or an email address; `check_rcs` accepts an E.164 phone number only and rejects
+              an email with a `400`, since RCS has no email addressing.
 
           from_: Optional sender phone number. If omitted, an available phone from your pool is
               used automatically.
@@ -219,8 +235,20 @@ class AsyncCapabilityResource(AsyncAPIResource):
         """
         Check whether a recipient address (phone number) supports RCS messaging.
 
+        `address` must be an E.164 phone number. RCS has no email addressing, so an
+        email is rejected with a `400` rather than attempted.
+
+        A `200` means the check ran and the answer is about the **recipient**. A `503`
+        means the check could not produce an answer because of a fault on the **sender**
+        line — `4004` (RCS not turned on for the line), `4009` (line has no RCS
+        account), or `4010` (the check could not run). Treat all three as "unknown",
+        never as "the recipient does not support RCS", and do not cache them as a
+        negative result.
+
         Args:
-          address: The recipient phone number or email address to check
+          address: The recipient address to check. `check_imessage` accepts an E.164 phone number
+              or an email address; `check_rcs` accepts an E.164 phone number only and rejects
+              an email with a `400`, since RCS has no email addressing.
 
           from_: Optional sender phone number. If omitted, an available phone from your pool is
               used automatically.

{linq_python-0.22.1 → linq_python-0.23.1}/src/linq/types/capability_check_RCS_params.py

@@ -11,7 +11,12 @@ __all__ = ["CapabilityCheckRCSParams"]
 
 class CapabilityCheckRCSParams(TypedDict, total=False):
     address: Required[str]
-    """The recipient phone number or email address to check"""
+    """The recipient address to check.
+
+    `check_imessage` accepts an E.164 phone number or an email address; `check_rcs`
+    accepts an E.164 phone number only and rejects an email with a `400`, since RCS
+    has no email addressing.
+    """
 
     from_: Annotated[str, PropertyInfo(alias="from")]
     """Optional sender phone number.

{linq_python-0.22.1 → linq_python-0.23.1}/src/linq/types/capability_check_i_message_params.py

@@ -11,7 +11,12 @@ __all__ = ["CapabilityCheckIMessageParams"]
 
 class CapabilityCheckIMessageParams(TypedDict, total=False):
     address: Required[str]
-    """The recipient phone number or email address to check"""
+    """The recipient address to check.
+
+    `check_imessage` accepts an E.164 phone number or an email address; `check_rcs`
+    accepts an E.164 phone number only and rejects an email with a `400`, since RCS
+    has no email addressing.
+    """
 
     from_: Annotated[str, PropertyInfo(alias="from")]
     """Optional sender phone number.

linq_python-0.23.1/src/linq/types/handle_check_response.py

@@ -0,0 +1,32 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from typing_extensions import Literal
+
+from .._models import BaseModel
+
+__all__ = ["HandleCheckResponse"]
+
+
+class HandleCheckResponse(BaseModel):
+    address: str
+    """The recipient address that was checked"""
+
+    available: bool
+    """Whether the recipient supports the checked messaging service"""
+
+    reason: Optional[Literal["not_supported"]] = None
+    """Why `available` is `false`. Only present on a negative result.
+
+    `not_supported` is the only value returned with a `200`, and it means the check
+    completed and the recipient is genuinely not reachable over this service. On
+    `check_rcs`, sender-side faults do not return `200` — they return `503` with a
+    specific error code. `check_imessage` does not use this mapping.
+    """
+
+    selected_service: Optional[str] = None
+    """
+    The service that would actually carry a message to this address right now, which
+    is not always the service you checked — a recipient without RCS resolves to
+    `SMS`. Absent when the check could not determine one.
+    """

{linq_python-0.22.1 → linq_python-0.23.1}/uv.lock

@@ -530,7 +530,7 @@ wheels = [
 
 [[package]]
 name = "linq-python"
-version = "0.22.0"
+version = "0.23.0"
 source = { editable = "." }
 dependencies = [
     { name = "anyio" },

linq_python-0.22.1/.release-please-manifest.json

@@ -1,3 +0,0 @@
-{
-  ".": "0.22.1"
-}

linq_python-0.22.1/src/linq/types/handle_check_response.py

@@ -1,13 +0,0 @@
-# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-from .._models import BaseModel
-
-__all__ = ["HandleCheckResponse"]
-
-
-class HandleCheckResponse(BaseModel):
-    address: str
-    """The recipient address that was checked"""
-
-    available: bool
-    """Whether the recipient supports the checked messaging service"""