linq-python 0.66.0__tar.gz → 0.67.0__tar.gz

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

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

{linq_python-0.66.0 → linq_python-0.67.0}/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.67.0](https://github.com/linq-team/linq-python/compare/v0.66.0...v0.67.0) (2026-11-06)
+
+
+### Features
+
+* support image tapbacks and improve reaction documentation ([1c79845](https://github.com/linq-team/linq-python/commit/1c79845c8b872761fbfd8b62cd7c9084224c0075))
+
 ## [0.66.0](https://github.com/linq-team/linq-python/compare/v0.65.0...v0.66.0) (2026-11-06)
 
 

{linq_python-0.66.0 → linq_python-0.67.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: linq-python
-Version: 0.66.0
+Version: 0.67.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.66.0 → linq_python-0.67.0}/pyproject.toml

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

{linq_python-0.66.0 → linq_python-0.67.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.66.0"  # x-release-please-version
+__version__ = "0.67.0"  # x-release-please-version

{linq_python-0.66.0 → linq_python-0.67.0}/src/linq/resources/messages/messages.py

@@ -513,7 +513,8 @@ class MessagesResource(SyncAPIResource):
         - laugh 😂
         - emphasize ‼️
         - question ❓
-        - custom - any emoji as a tapback (use `custom_emoji` field to specify)
+        - custom - any emoji or image as a tapback (use `custom_emoji` for an emoji, or
+          `url` / `attachment_id` for an image)
         - sticker - an emoji or image peeled onto the message (use `emoji`, `url` or
           `attachment_id`)
 
@@ -522,6 +523,9 @@ class MessagesResource(SyncAPIResource):
         `sticker` is peeled onto the bubble itself, and can be dragged, resized and
         rotated. Both accept an emoji; they do not look alike.
 
+        **Image tapbacks** are iMessage-only. Remove one with `operation: "remove"` and
+        `type: "custom"`; no image is needed.
+
         **Stickers** are iMessage-only and cannot be removed, so `operation: "remove"`
         with `type: "sticker"` is rejected. Position, size and rotation are optional via
         `placement`, and can be changed afterwards with
@@ -535,17 +539,21 @@ class MessagesResource(SyncAPIResource):
           operation: Whether to add or remove the reaction
 
           type: Type of reaction. Standard iMessage tapbacks are love, like, dislike, laugh,
-              emphasize, question. Custom emoji reactions have type "custom" with the actual
-              emoji in the custom_emoji field. Sticker reactions have type "sticker" with
-              sticker attachment details in the sticker field.
+              emphasize, question. Custom tapbacks have type "custom": an emoji tapback
+              carries the emoji in the custom_emoji field, and an image tapback carries the
+              image in the sticker field. Sticker reactions have type "sticker" with sticker
+              attachment details in the sticker field.
 
-          attachment_id: Reference to a sticker image pre-uploaded via `POST /v3/attachments`. Only valid
-              when type is "sticker".
+          attachment_id: Reference to an image pre-uploaded via `POST /v3/attachments`. Valid when type
+              is "sticker", or when adding a type "custom" reaction to make it an image
+              tapback.
 
               Exactly one of `emoji`, `url` or `attachment_id` is required when type is
               "sticker".
 
-          custom_emoji: Custom emoji string. Required when type is "custom".
+          custom_emoji: Custom emoji string. When adding a type "custom" reaction, provide exactly one
+              of `custom_emoji`, `url` or `attachment_id`. To remove an emoji reaction, pass
+              the same `custom_emoji`.
 
               This is a **tapback** — the emoji sits in the tapback bubble on the corner of
               the message. To peel an emoji onto the message as a draggable sticker instead,
@@ -568,11 +576,12 @@ class MessagesResource(SyncAPIResource):
               Every field is independent and optional — omit the object entirely, or any field
               within it, to keep the default (centred, default size, unrotated).
 
-          url: Linq attachment URL of the sticker image — the `download_url` returned by
-              `POST /v3/attachments`. Only valid when type is "sticker".
+          url: Linq attachment URL of the image — the `download_url` returned by
+              `POST /v3/attachments`. Valid when type is "sticker", or when adding a type
+              "custom" reaction to make it an image tapback.
 
-              The image must already be stored with us. To send a sticker from elsewhere,
-              upload it with `POST /v3/attachments` first and pass `attachment_id`.
+              The image must already be stored with us. To use an image from elsewhere, upload
+              it with `POST /v3/attachments` first and pass `attachment_id`.
 
               Exactly one of `emoji`, `url` or `attachment_id` is required when type is
               "sticker".
@@ -1311,7 +1320,8 @@ class AsyncMessagesResource(AsyncAPIResource):
         - laugh 😂
         - emphasize ‼️
         - question ❓
-        - custom - any emoji as a tapback (use `custom_emoji` field to specify)
+        - custom - any emoji or image as a tapback (use `custom_emoji` for an emoji, or
+          `url` / `attachment_id` for an image)
         - sticker - an emoji or image peeled onto the message (use `emoji`, `url` or
           `attachment_id`)
 
@@ -1320,6 +1330,9 @@ class AsyncMessagesResource(AsyncAPIResource):
         `sticker` is peeled onto the bubble itself, and can be dragged, resized and
         rotated. Both accept an emoji; they do not look alike.
 
+        **Image tapbacks** are iMessage-only. Remove one with `operation: "remove"` and
+        `type: "custom"`; no image is needed.
+
         **Stickers** are iMessage-only and cannot be removed, so `operation: "remove"`
         with `type: "sticker"` is rejected. Position, size and rotation are optional via
         `placement`, and can be changed afterwards with
@@ -1333,17 +1346,21 @@ class AsyncMessagesResource(AsyncAPIResource):
           operation: Whether to add or remove the reaction
 
           type: Type of reaction. Standard iMessage tapbacks are love, like, dislike, laugh,
-              emphasize, question. Custom emoji reactions have type "custom" with the actual
-              emoji in the custom_emoji field. Sticker reactions have type "sticker" with
-              sticker attachment details in the sticker field.
+              emphasize, question. Custom tapbacks have type "custom": an emoji tapback
+              carries the emoji in the custom_emoji field, and an image tapback carries the
+              image in the sticker field. Sticker reactions have type "sticker" with sticker
+              attachment details in the sticker field.
 
-          attachment_id: Reference to a sticker image pre-uploaded via `POST /v3/attachments`. Only valid
-              when type is "sticker".
+          attachment_id: Reference to an image pre-uploaded via `POST /v3/attachments`. Valid when type
+              is "sticker", or when adding a type "custom" reaction to make it an image
+              tapback.
 
               Exactly one of `emoji`, `url` or `attachment_id` is required when type is
               "sticker".
 
-          custom_emoji: Custom emoji string. Required when type is "custom".
+          custom_emoji: Custom emoji string. When adding a type "custom" reaction, provide exactly one
+              of `custom_emoji`, `url` or `attachment_id`. To remove an emoji reaction, pass
+              the same `custom_emoji`.
 
               This is a **tapback** — the emoji sits in the tapback bubble on the corner of
               the message. To peel an emoji onto the message as a draggable sticker instead,
@@ -1366,11 +1383,12 @@ class AsyncMessagesResource(AsyncAPIResource):
               Every field is independent and optional — omit the object entirely, or any field
               within it, to keep the default (centred, default size, unrotated).
 
-          url: Linq attachment URL of the sticker image — the `download_url` returned by
-              `POST /v3/attachments`. Only valid when type is "sticker".
+          url: Linq attachment URL of the image — the `download_url` returned by
+              `POST /v3/attachments`. Valid when type is "sticker", or when adding a type
+              "custom" reaction to make it an image tapback.
 
-              The image must already be stored with us. To send a sticker from elsewhere,
-              upload it with `POST /v3/attachments` first and pass `attachment_id`.
+              The image must already be stored with us. To use an image from elsewhere, upload
+              it with `POST /v3/attachments` first and pass `attachment_id`.
 
               Exactly one of `emoji`, `url` or `attachment_id` is required when type is
               "sticker".

{linq_python-0.66.0 → linq_python-0.67.0}/src/linq/types/message_add_reaction_params.py

@@ -17,22 +17,28 @@ class MessageAddReactionParams(TypedDict, total=False):
     """Type of reaction.
 
     Standard iMessage tapbacks are love, like, dislike, laugh, emphasize, question.
-    Custom emoji reactions have type "custom" with the actual emoji in the
-    custom_emoji field. Sticker reactions have type "sticker" with sticker
-    attachment details in the sticker field.
+    Custom tapbacks have type "custom": an emoji tapback carries the emoji in the
+    custom_emoji field, and an image tapback carries the image in the sticker field.
+    Sticker reactions have type "sticker" with sticker attachment details in the
+    sticker field.
     """
 
     attachment_id: str
     """
-    Reference to a sticker image pre-uploaded via `POST /v3/attachments`. Only valid
-    when type is "sticker".
+    Reference to an image pre-uploaded via `POST /v3/attachments`. Valid when type
+    is "sticker", or when adding a type "custom" reaction to make it an image
+    tapback.
 
     Exactly one of `emoji`, `url` or `attachment_id` is required when type is
     "sticker".
     """
 
     custom_emoji: str
-    """Custom emoji string. Required when type is "custom".
+    """Custom emoji string.
+
+    When adding a type "custom" reaction, provide exactly one of `custom_emoji`,
+    `url` or `attachment_id`. To remove an emoji reaction, pass the same
+    `custom_emoji`.
 
     This is a **tapback** — the emoji sits in the tapback bubble on the corner of
     the message. To peel an emoji onto the message as a draggable sticker instead,
@@ -67,11 +73,12 @@ class MessageAddReactionParams(TypedDict, total=False):
 
     url: str
     """
-    Linq attachment URL of the sticker image — the `download_url` returned by
-    `POST /v3/attachments`. Only valid when type is "sticker".
+    Linq attachment URL of the image — the `download_url` returned by
+    `POST /v3/attachments`. Valid when type is "sticker", or when adding a type
+    "custom" reaction to make it an image tapback.
 
-    The image must already be stored with us. To send a sticker from elsewhere,
-    upload it with `POST /v3/attachments` first and pass `attachment_id`.
+    The image must already be stored with us. To use an image from elsewhere, upload
+    it with `POST /v3/attachments` first and pass `attachment_id`.
 
     Exactly one of `emoji`, `url` or `attachment_id` is required when type is
     "sticker".

{linq_python-0.66.0 → linq_python-0.67.0}/src/linq/types/reaction_event_base.py

@@ -14,9 +14,9 @@ __all__ = ["ReactionEventBase", "Sticker"]
 
 
 class Sticker(BaseModel):
-    """Sticker attachment details when reaction_type is "sticker".
-
-    Null for non-sticker reactions.
+    """
+    The image when reaction_type is "sticker", or when reaction_type is "custom" and
+    the tapback is an image. Null otherwise.
     """
 
     file_name: Optional[str] = None
@@ -46,16 +46,20 @@ class ReactionEventBase(BaseModel):
     """Type of reaction.
 
     Standard iMessage tapbacks are love, like, dislike, laugh, emphasize, question.
-    Custom emoji reactions have type "custom" with the actual emoji in the
-    custom_emoji field. Sticker reactions have type "sticker" with sticker
-    attachment details in the sticker field.
+    Custom tapbacks have type "custom": an emoji tapback carries the emoji in the
+    custom_emoji field, and an image tapback carries the image in the sticker field.
+    Sticker reactions have type "sticker" with sticker attachment details in the
+    sticker field.
     """
 
     chat_id: Optional[str] = None
     """Chat identifier (UUID)"""
 
     custom_emoji: Optional[str] = None
-    """The actual emoji when reaction_type is "custom". Null for standard tapbacks."""
+    """The actual emoji when reaction_type is "custom" and the tapback is an emoji.
+
+    Null otherwise.
+    """
 
     from_: Optional[str] = FieldInfo(alias="from", default=None)
     """DEPRECATED: Use from_handle instead.
@@ -94,7 +98,7 @@ class ReactionEventBase(BaseModel):
     """
 
     sticker: Optional[Sticker] = None
-    """Sticker attachment details when reaction_type is "sticker".
-
-    Null for non-sticker reactions.
+    """
+    The image when reaction_type is "sticker", or when reaction_type is "custom" and
+    the tapback is an image. Null otherwise.
     """

{linq_python-0.66.0 → linq_python-0.67.0}/src/linq/types/shared/reaction.py

@@ -10,9 +10,9 @@ __all__ = ["Reaction", "Sticker"]
 
 
 class Sticker(BaseModel):
-    """Sticker attachment details when reaction_type is "sticker".
-
-    Null for non-sticker reactions.
+    """
+    The image when type is "sticker", or when type is "custom" and the tapback is an image.
+    Null otherwise.
     """
 
     file_name: Optional[str] = None
@@ -41,9 +41,10 @@ class Reaction(BaseModel):
     """Type of reaction.
 
     Standard iMessage tapbacks are love, like, dislike, laugh, emphasize, question.
-    Custom emoji reactions have type "custom" with the actual emoji in the
-    custom_emoji field. Sticker reactions have type "sticker" with sticker
-    attachment details in the sticker field.
+    Custom tapbacks have type "custom": an emoji tapback carries the emoji in the
+    custom_emoji field, and an image tapback carries the image in the sticker field.
+    Sticker reactions have type "sticker" with sticker attachment details in the
+    sticker field.
     """
 
     id: Optional[str] = None
@@ -59,10 +60,10 @@ class Reaction(BaseModel):
     """
 
     custom_emoji: Optional[str] = None
-    """Custom emoji if type is "custom", null otherwise"""
+    """Custom emoji if type is "custom" and the tapback is an emoji, null otherwise"""
 
     sticker: Optional[Sticker] = None
-    """Sticker attachment details when reaction_type is "sticker".
-
-    Null for non-sticker reactions.
+    """
+    The image when type is "sticker", or when type is "custom" and the tapback is an
+    image. Null otherwise.
     """

{linq_python-0.66.0 → linq_python-0.67.0}/uv.lock

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

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

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