linq-python 0.51.2__tar.gz → 0.52.1__tar.gz

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

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

{linq_python-0.51.2 → linq_python-0.52.1}/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.52.1](https://github.com/linq-team/linq-python/compare/v0.52.0...v0.52.1) (2026-09-10)
+
+
+### Bug Fixes
+
+* adjust sticker scale parameter bounds and defaults ([f614689](https://github.com/linq-team/linq-python/commit/f6146896d396f6150830ba88f83171e2d0c535f7))
+
+## [0.52.0](https://github.com/linq-team/linq-python/compare/v0.51.2...v0.52.0) (2026-09-10)
+
+
+### Features
+
+* add emoji sticker support alongside url and attachment_id ([824aba6](https://github.com/linq-team/linq-python/commit/824aba6a0b71e7eae3ef71f3650a78eb5238c0e8))
+
 ## [0.51.2](https://github.com/linq-team/linq-python/compare/v0.51.1...v0.51.2) (2026-09-10)
 
 

{linq_python-0.51.2 → linq_python-0.52.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: linq-python
-Version: 0.51.2
+Version: 0.52.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.51.2 → linq_python-0.52.1}/pyproject.toml

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

{linq_python-0.51.2 → linq_python-0.52.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.51.2"  # x-release-please-version
+__version__ = "0.52.1"  # x-release-please-version

{linq_python-0.51.2 → linq_python-0.52.1}/src/linq/resources/messages/messages.py

@@ -482,6 +482,7 @@ class MessagesResource(SyncAPIResource):
         type: ReactionType,
         attachment_id: str | Omit = omit,
         custom_emoji: str | Omit = omit,
+        emoji: str | Omit = omit,
         part_index: int | Omit = omit,
         placement: message_add_reaction_params.Placement | Omit = omit,
         url: str | Omit = omit,
@@ -505,8 +506,14 @@ class MessagesResource(SyncAPIResource):
         - laugh 😂
         - emphasize ‼️
         - question ❓
-        - custom - any emoji (use `custom_emoji` field to specify)
-        - sticker - an image peeled onto the message (use `url` or `attachment_id`)
+        - custom - any emoji as a tapback (use `custom_emoji` field to specify)
+        - sticker - an emoji or image peeled onto the message (use `emoji`, `url` or
+          `attachment_id`)
+
+        **`custom` and `sticker` are different products.** A `custom` reaction is a
+        tapback: the emoji sits in a small bubble on the corner of the message. A
+        `sticker` is peeled onto the bubble itself, and can be dragged, resized and
+        rotated. Both accept an emoji; they do not look alike.
 
         **Stickers** are iMessage-only and cannot be removed — iMessage has no unpeel
         operation, so `operation: "remove"` with `type: "sticker"` is rejected.
@@ -524,11 +531,24 @@ class MessagesResource(SyncAPIResource):
           attachment_id: Reference to a sticker image pre-uploaded via `POST /v3/attachments`. Only valid
               when type is "sticker".
 
-              Either `url` or `attachment_id` must be provided when type is "sticker", but not
-              both.
+              Exactly one of `emoji`, `url` or `attachment_id` is required when type is
+              "sticker".
 
           custom_emoji: Custom emoji string. Required when type is "custom".
 
+              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,
+              use type "sticker" with `emoji`.
+
+          emoji: A single emoji to peel onto the message as a sticker. Only valid when type is
+              "sticker", and it is rendered on the device so it matches the glyph a person
+              would peel by hand.
+
+              Exactly one of `emoji`, `url` or `attachment_id` is required when type is
+              "sticker".
+
+              Not to be confused with `custom_emoji`, which produces a tapback.
+
           part_index: Optional index of the message part to react to. If not provided, reacts to the
               entire message (part 0).
 
@@ -545,8 +565,8 @@ class MessagesResource(SyncAPIResource):
               no download step, so the image must already be stored. To send a sticker from
               elsewhere, upload it with `POST /v3/attachments` first and pass `attachment_id`.
 
-              Either `url` or `attachment_id` must be provided when type is "sticker", but not
-              both.
+              Exactly one of `emoji`, `url` or `attachment_id` is required when type is
+              "sticker".
 
           extra_headers: Send extra headers
 
@@ -566,6 +586,7 @@ class MessagesResource(SyncAPIResource):
                     "type": type,
                     "attachment_id": attachment_id,
                     "custom_emoji": custom_emoji,
+                    "emoji": emoji,
                     "part_index": part_index,
                     "placement": placement,
                     "url": url,
@@ -1249,6 +1270,7 @@ class AsyncMessagesResource(AsyncAPIResource):
         type: ReactionType,
         attachment_id: str | Omit = omit,
         custom_emoji: str | Omit = omit,
+        emoji: str | Omit = omit,
         part_index: int | Omit = omit,
         placement: message_add_reaction_params.Placement | Omit = omit,
         url: str | Omit = omit,
@@ -1272,8 +1294,14 @@ class AsyncMessagesResource(AsyncAPIResource):
         - laugh 😂
         - emphasize ‼️
         - question ❓
-        - custom - any emoji (use `custom_emoji` field to specify)
-        - sticker - an image peeled onto the message (use `url` or `attachment_id`)
+        - custom - any emoji as a tapback (use `custom_emoji` field to specify)
+        - sticker - an emoji or image peeled onto the message (use `emoji`, `url` or
+          `attachment_id`)
+
+        **`custom` and `sticker` are different products.** A `custom` reaction is a
+        tapback: the emoji sits in a small bubble on the corner of the message. A
+        `sticker` is peeled onto the bubble itself, and can be dragged, resized and
+        rotated. Both accept an emoji; they do not look alike.
 
         **Stickers** are iMessage-only and cannot be removed — iMessage has no unpeel
         operation, so `operation: "remove"` with `type: "sticker"` is rejected.
@@ -1291,11 +1319,24 @@ class AsyncMessagesResource(AsyncAPIResource):
           attachment_id: Reference to a sticker image pre-uploaded via `POST /v3/attachments`. Only valid
               when type is "sticker".
 
-              Either `url` or `attachment_id` must be provided when type is "sticker", but not
-              both.
+              Exactly one of `emoji`, `url` or `attachment_id` is required when type is
+              "sticker".
 
           custom_emoji: Custom emoji string. Required when type is "custom".
 
+              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,
+              use type "sticker" with `emoji`.
+
+          emoji: A single emoji to peel onto the message as a sticker. Only valid when type is
+              "sticker", and it is rendered on the device so it matches the glyph a person
+              would peel by hand.
+
+              Exactly one of `emoji`, `url` or `attachment_id` is required when type is
+              "sticker".
+
+              Not to be confused with `custom_emoji`, which produces a tapback.
+
           part_index: Optional index of the message part to react to. If not provided, reacts to the
               entire message (part 0).
 
@@ -1312,8 +1353,8 @@ class AsyncMessagesResource(AsyncAPIResource):
               no download step, so the image must already be stored. To send a sticker from
               elsewhere, upload it with `POST /v3/attachments` first and pass `attachment_id`.
 
-              Either `url` or `attachment_id` must be provided when type is "sticker", but not
-              both.
+              Exactly one of `emoji`, `url` or `attachment_id` is required when type is
+              "sticker".
 
           extra_headers: Send extra headers
 
@@ -1333,6 +1374,7 @@ class AsyncMessagesResource(AsyncAPIResource):
                     "type": type,
                     "attachment_id": attachment_id,
                     "custom_emoji": custom_emoji,
+                    "emoji": emoji,
                     "part_index": part_index,
                     "placement": placement,
                     "url": url,

{linq_python-0.51.2 → linq_python-0.52.1}/src/linq/types/message_add_reaction_params.py

@@ -27,12 +27,29 @@ class MessageAddReactionParams(TypedDict, total=False):
     Reference to a sticker image pre-uploaded via `POST /v3/attachments`. Only valid
     when type is "sticker".
 
-    Either `url` or `attachment_id` must be provided when type is "sticker", but not
-    both.
+    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. Required when type is "custom".
+
+    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,
+    use type "sticker" with `emoji`.
+    """
+
+    emoji: str
+    """A single emoji to peel onto the message as a sticker.
+
+    Only valid when type is "sticker", and it is rendered on the device so it
+    matches the glyph a person would peel by hand.
+
+    Exactly one of `emoji`, `url` or `attachment_id` is required when type is
+    "sticker".
+
+    Not to be confused with `custom_emoji`, which produces a tapback.
+    """
 
     part_index: int
     """
@@ -58,8 +75,8 @@ class MessageAddReactionParams(TypedDict, total=False):
     no download step, so the image must already be stored. To send a sticker from
     elsewhere, upload it with `POST /v3/attachments` first and pass `attachment_id`.
 
-    Either `url` or `attachment_id` must be provided when type is "sticker", but not
-    both.
+    Exactly one of `emoji`, `url` or `attachment_id` is required when type is
+    "sticker".
     """
 
 
@@ -78,14 +95,14 @@ class Placement(TypedDict, total=False):
     """Clockwise rotation in degrees."""
 
     scale: float
-    """Size relative to the default, where 1 matches the size a sticker gets natively.
+    """How large the sticker is drawn.
+
+    Omit it for the default size — equivalent to `1` for an image, or `0.5` for an
+    emoji.
 
-    Values outside 0.5–1.5 are clamped rather than rejected. The upper bound keeps a
-    sticker within the size range iMessage itself displays: its own limit is larger,
-    but that allowance assumes the transparent padding Apple's stickers carry, which
-    a full-bleed image does not have.
+    Values outside 0.05–2.5 are clamped rather than rejected.
 
-    Scale is linear, so 1.5 is a little over twice the area.
+    Scale is linear, so 2.5 is a little over six times the area.
     """
 
     x: float

{linq_python-0.51.2 → linq_python-0.52.1}/src/linq/types/message_update_sticker_placement_params.py

@@ -37,14 +37,14 @@ class Placement(TypedDict, total=False):
     """Clockwise rotation in degrees."""
 
     scale: float
-    """Size relative to the default, where 1 matches the size a sticker gets natively.
+    """How large the sticker is drawn.
 
-    Values outside 0.5–1.5 are clamped rather than rejected. The upper bound keeps a
-    sticker within the size range iMessage itself displays: its own limit is larger,
-    but that allowance assumes the transparent padding Apple's stickers carry, which
-    a full-bleed image does not have.
+    Omit it for the default size — equivalent to `1` for an image, or `0.5` for an
+    emoji.
 
-    Scale is linear, so 1.5 is a little over twice the area.
+    Values outside 0.05–2.5 are clamped rather than rejected.
+
+    Scale is linear, so 2.5 is a little over six times the area.
     """
 
     x: float

{linq_python-0.51.2 → linq_python-0.52.1}/tests/api_resources/test_messages.py

@@ -269,6 +269,7 @@ class TestMessages:
             type="love",
             attachment_id="550e8400-e29b-41d4-a716-446655440000",
             custom_emoji="custom_emoji",
+            emoji="🎉",
             part_index=1,
             placement={
                 "rotation": 15,
@@ -773,6 +774,7 @@ class TestAsyncMessages:
             type="love",
             attachment_id="550e8400-e29b-41d4-a716-446655440000",
             custom_emoji="custom_emoji",
+            emoji="🎉",
             part_index=1,
             placement={
                 "rotation": 15,

{linq_python-0.51.2 → linq_python-0.52.1}/uv.lock

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

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

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