linq-python 0.30.3__tar.gz → 0.31.0__tar.gz

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

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

{linq_python-0.30.3 → linq_python-0.31.0}/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.31.0](https://github.com/linq-team/linq-python/compare/v0.30.3...v0.31.0) (2026-08-24)
+
+
+### Features
+
+* add location sharing webhook metadata and request validation ([c8a7223](https://github.com/linq-team/linq-python/commit/c8a72238ace153bb05ab53851c73e6ad84ec519c))
+
 ## [0.30.3](https://github.com/linq-team/linq-python/compare/v0.30.2...v0.30.3) (2026-08-20)
 
 

{linq_python-0.30.3 → linq_python-0.31.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: linq-python
-Version: 0.30.3
+Version: 0.31.0
 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.30.3 → linq_python-0.31.0}/pyproject.toml

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

{linq_python-0.30.3 → linq_python-0.31.0}/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.30.3"  # x-release-please-version
+__version__ = "0.31.0"  # x-release-please-version

{linq_python-0.30.3 → linq_python-0.31.0}/src/linq/resources/chats/chats.py

@@ -193,7 +193,7 @@ class ChatsResource(SyncAPIResource):
         and subscribe to webhooks when someone starts or stops sharing.
 
         **Coordinates** are returned in [GeoJSON](https://datatracker.ietf.org/doc/html/rfc7946) format:
-        `[longitude, latitude]` or `[longitude, latitude, altitude]` if altitude is available.
+        `[longitude, latitude]`.
 
         ### Reading location is poll-based
 
@@ -938,7 +938,7 @@ class AsyncChatsResource(AsyncAPIResource):
         and subscribe to webhooks when someone starts or stops sharing.
 
         **Coordinates** are returned in [GeoJSON](https://datatracker.ietf.org/doc/html/rfc7946) format:
-        `[longitude, latitude]` or `[longitude, latitude, altitude]` if altitude is available.
+        `[longitude, latitude]`.
 
         ### Reading location is poll-based
 
@@ -1711,7 +1711,7 @@ class ChatsResourceWithRawResponse:
         and subscribe to webhooks when someone starts or stops sharing.
 
         **Coordinates** are returned in [GeoJSON](https://datatracker.ietf.org/doc/html/rfc7946) format:
-        `[longitude, latitude]` or `[longitude, latitude, altitude]` if altitude is available.
+        `[longitude, latitude]`.
 
         ### Reading location is poll-based
 
@@ -1972,7 +1972,7 @@ class AsyncChatsResourceWithRawResponse:
         and subscribe to webhooks when someone starts or stops sharing.
 
         **Coordinates** are returned in [GeoJSON](https://datatracker.ietf.org/doc/html/rfc7946) format:
-        `[longitude, latitude]` or `[longitude, latitude, altitude]` if altitude is available.
+        `[longitude, latitude]`.
 
         ### Reading location is poll-based
 
@@ -2233,7 +2233,7 @@ class ChatsResourceWithStreamingResponse:
         and subscribe to webhooks when someone starts or stops sharing.
 
         **Coordinates** are returned in [GeoJSON](https://datatracker.ietf.org/doc/html/rfc7946) format:
-        `[longitude, latitude]` or `[longitude, latitude, altitude]` if altitude is available.
+        `[longitude, latitude]`.
 
         ### Reading location is poll-based
 
@@ -2494,7 +2494,7 @@ class AsyncChatsResourceWithStreamingResponse:
         and subscribe to webhooks when someone starts or stops sharing.
 
         **Coordinates** are returned in [GeoJSON](https://datatracker.ietf.org/doc/html/rfc7946) format:
-        `[longitude, latitude]` or `[longitude, latitude, altitude]` if altitude is available.
+        `[longitude, latitude]`.
 
         ### Reading location is poll-based
 

{linq_python-0.30.3 → linq_python-0.31.0}/src/linq/resources/chats/location.py

@@ -27,7 +27,7 @@ class LocationResource(SyncAPIResource):
     and subscribe to webhooks when someone starts or stops sharing.
 
     **Coordinates** are returned in [GeoJSON](https://datatracker.ietf.org/doc/html/rfc7946) format:
-    `[longitude, latitude]` or `[longitude, latitude, altitude]` if altitude is available.
+    `[longitude, latitude]`.
 
     ### Reading location is poll-based
 
@@ -103,6 +103,9 @@ class LocationResource(SyncAPIResource):
         separate feature for each participant who is sharing. Each feature's
         `properties.handle` identifies the user.
 
+        A participant appears as soon as their first position arrives, typically within
+        a second or two of sharing starting.
+
         Returns an empty `data.features` array if no one is sharing or no location data
         is available yet. If sharing started but this stays empty, see the **Location
         Sharing** overview.
@@ -152,6 +155,12 @@ class LocationResource(SyncAPIResource):
         `{ "success": true, "message": "Location request sent" }` and does not return
         coordinates.
 
+        Rejected with `409` if the recipient is already sharing — read their location
+        with `GET /v3/chats/{chatId}/location` instead of re-requesting.
+
+        Rate limited per chat, since each request prompts the recipient's device.
+        Exceeding it returns `429` with a `Retry-After` header.
+
         Location requests only work in **1:1 iMessage chats** (Apple limitation):
 
         - Group chats (any service) return `409` with code `2016`
@@ -185,7 +194,7 @@ class AsyncLocationResource(AsyncAPIResource):
     and subscribe to webhooks when someone starts or stops sharing.
 
     **Coordinates** are returned in [GeoJSON](https://datatracker.ietf.org/doc/html/rfc7946) format:
-    `[longitude, latitude]` or `[longitude, latitude, altitude]` if altitude is available.
+    `[longitude, latitude]`.
 
     ### Reading location is poll-based
 
@@ -261,6 +270,9 @@ class AsyncLocationResource(AsyncAPIResource):
         separate feature for each participant who is sharing. Each feature's
         `properties.handle` identifies the user.
 
+        A participant appears as soon as their first position arrives, typically within
+        a second or two of sharing starting.
+
         Returns an empty `data.features` array if no one is sharing or no location data
         is available yet. If sharing started but this stays empty, see the **Location
         Sharing** overview.
@@ -310,6 +322,12 @@ class AsyncLocationResource(AsyncAPIResource):
         `{ "success": true, "message": "Location request sent" }` and does not return
         coordinates.
 
+        Rejected with `409` if the recipient is already sharing — read their location
+        with `GET /v3/chats/{chatId}/location` instead of re-requesting.
+
+        Rate limited per chat, since each request prompts the recipient's device.
+        Exceeding it returns `429` with a `Retry-After` header.
+
         Location requests only work in **1:1 iMessage chats** (Apple limitation):
 
         - Group chats (any service) return `409` with code `2016`

{linq_python-0.30.3 → linq_python-0.31.0}/src/linq/types/chats/get_chat_location_response.py

@@ -11,7 +11,7 @@ __all__ = ["GetChatLocationResponse", "Data", "DataFeature", "DataFeatureGeometr
 
 class DataFeatureGeometry(BaseModel):
     coordinates: List[float]
-    """[longitude, latitude] or [longitude, latitude, altitude]"""
+    """[longitude, latitude]"""
 
     type: Literal["Point"]
 

{linq_python-0.30.3 → linq_python-0.31.0}/uv.lock

@@ -518,7 +518,7 @@ wheels = [
 
 [[package]]
 name = "linq-python"
-version = "0.30.2"
+version = "0.30.3"
 source = { editable = "." }
 dependencies = [
     { name = "anyio" },

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

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