linq-python 0.13.0__tar.gz → 0.14.0__tar.gz

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

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

linq_python-0.14.0/CHANGELOG.md

@@ -0,0 +1,13 @@
+# Changelog
+
+## [0.14.0](https://github.com/linq-team/linq-python/compare/v0.13.0...v0.14.0) (2026-06-10)
+
+
+### Features
+
+* regenerate SDKs from updated API spec ([#29](https://github.com/linq-team/linq-python/issues/29)) ([dd7f2d7](https://github.com/linq-team/linq-python/commit/dd7f2d7e19e85fa9f61f6367f7e2a1cc942765bf))
+
+
+### Bug Fixes
+
+* **ci:** parse release PR number in shell, not fromJSON in env ([#26](https://github.com/linq-team/linq-python/issues/26)) ([a364403](https://github.com/linq-team/linq-python/commit/a364403289e482298f8b0d78e8e45de8fb87b79d))

{linq_python-0.13.0 → linq_python-0.14.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: linq-python
-Version: 0.13.0
+Version: 0.14.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.13.0 → linq_python-0.14.0}/pyproject.toml

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

{linq_python-0.13.0 → linq_python-0.14.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.13.0"  # x-release-please-version
+__version__ = "0.14.0"  # x-release-please-version

{linq_python-0.13.0 → linq_python-0.14.0}/src/linq/resources/capability.py

@@ -82,7 +82,7 @@ class CapabilityResource(SyncAPIResource):
                     "address": address,
                     "from_": from_,
                 },
-                capability_check_i_message_params.CapabilityCheckiMessageParams,
+                capability_check_i_message_params.CapabilityCheckIMessageParams,
             ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
@@ -196,7 +196,7 @@ class AsyncCapabilityResource(AsyncAPIResource):
                     "address": address,
                     "from_": from_,
                 },
-                capability_check_i_message_params.CapabilityCheckiMessageParams,
+                capability_check_i_message_params.CapabilityCheckIMessageParams,
             ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout

{linq_python-0.13.0 → linq_python-0.14.0}/src/linq/types/__init__.py

@@ -65,7 +65,7 @@ from .message_received_webhook_event import MessageReceivedWebhookEvent as Messa
 from .reaction_removed_webhook_event import ReactionRemovedWebhookEvent as ReactionRemovedWebhookEvent
 from .message_delivered_webhook_event import MessageDeliveredWebhookEvent as MessageDeliveredWebhookEvent
 from .participant_added_webhook_event import ParticipantAddedWebhookEvent as ParticipantAddedWebhookEvent
-from .capability_check_i_message_params import CapabilityCheckiMessageParams as CapabilityCheckiMessageParams
+from .capability_check_i_message_params import CapabilityCheckIMessageParams as CapabilityCheckIMessageParams
 from .participant_removed_webhook_event import ParticipantRemovedWebhookEvent as ParticipantRemovedWebhookEvent
 from .webhook_subscription_create_params import WebhookSubscriptionCreateParams as WebhookSubscriptionCreateParams
 from .webhook_subscription_list_response import WebhookSubscriptionListResponse as WebhookSubscriptionListResponse

{linq_python-0.13.0 → linq_python-0.14.0}/src/linq/types/capability_check_i_message_params.py

@@ -6,10 +6,10 @@ from typing_extensions import Required, Annotated, TypedDict
 
 from .._utils import PropertyInfo
 
-__all__ = ["CapabilityCheckiMessageParams"]
+__all__ = ["CapabilityCheckIMessageParams"]
 
 
-class CapabilityCheckiMessageParams(TypedDict, total=False):
+class CapabilityCheckIMessageParams(TypedDict, total=False):
     address: Required[str]
     """The recipient phone number or email address to check"""
 

linq_python-0.14.0/src/linq/types/chats/sent_message.py

@@ -0,0 +1,153 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Union, Optional
+from datetime import datetime
+from typing_extensions import Literal, TypeAlias
+
+from ..._models import BaseModel
+from ..reply_to import ReplyTo
+from ..message_effect import MessageEffect
+from ..shared.reaction import Reaction
+from ..shared.chat_handle import ChatHandle
+from ..shared.service_type import ServiceType
+from ..shared.link_part_response import LinkPartResponse
+from ..shared.text_part_response import TextPartResponse
+from ..shared.media_part_response import MediaPartResponse
+
+__all__ = [
+    "SentMessage",
+    "Part",
+    "PartIMessageAppPartResponse",
+    "PartIMessageAppPartResponseApp",
+    "PartIMessageAppPartResponseLayout",
+]
+
+
+class PartIMessageAppPartResponseApp(BaseModel):
+    """Identifies the iMessage app (Messages app extension) that backs the card."""
+
+    bundle_id: str
+    """Bundle identifier of the Messages app extension. Must not contain `:`."""
+
+    name: str
+    """Display name of the app, shown by Messages' fallback UI."""
+
+    team_id: str
+    """The app's 10-character uppercase alphanumeric team identifier."""
+
+    app_store_id: Optional[int] = None
+    """The owning app's App Store id (optional).
+
+    When set, recipients without the iMessage app installed see a "Get the app"
+    affordance.
+    """
+
+
+class PartIMessageAppPartResponseLayout(BaseModel):
+    """Visible layout of the card.
+
+    At least one of
+    `caption`, `subcaption`, `trailing_caption`, `trailing_subcaption`, or `image_url` must be
+    set, otherwise the card renders as an empty bubble.
+    """
+
+    caption: Optional[str] = None
+    """Primary label, top-left and bold."""
+
+    image_subtitle: Optional[str] = None
+    """Overlay text shown below `image_title`. Requires `image_url`."""
+
+    image_title: Optional[str] = None
+    """Overlay text shown above the image. Requires `image_url`."""
+
+    image_url: Optional[str] = None
+    """Optional HTTPS URL of a preview image.
+
+    The server downloads it and embeds it in the card as JPEG (10MB max, same fetch
+    rules as media parts).
+    """
+
+    subcaption: Optional[str] = None
+    """Secondary label, below `caption` on the left."""
+
+    trailing_caption: Optional[str] = None
+    """Label shown top-right."""
+
+    trailing_subcaption: Optional[str] = None
+    """Label shown below `trailing_caption`, on the right."""
+
+
+class PartIMessageAppPartResponse(BaseModel):
+    """An iMessage app card part."""
+
+    app: PartIMessageAppPartResponseApp
+    """Identifies the iMessage app (Messages app extension) that backs the card."""
+
+    layout: PartIMessageAppPartResponseLayout
+    """Visible layout of the card.
+
+    At least one of `caption`, `subcaption`, `trailing_caption`,
+    `trailing_subcaption`, or `image_url` must be set, otherwise the card renders as
+    an empty bubble.
+    """
+
+    reactions: Optional[List[Reaction]] = None
+    """Reactions on this message part"""
+
+    type: Literal["imessage_app"]
+    """Indicates this is an iMessage app card part."""
+
+    url: str
+    """The URL delivered to the iMessage app on tap."""
+
+    fallback_text: Optional[str] = None
+    """Fallback text for surfaces that cannot render the card."""
+
+    session_id: Optional[str] = None
+    """Client-supplied session identifier, echoed back when provided."""
+
+
+Part: TypeAlias = Union[TextPartResponse, MediaPartResponse, LinkPartResponse, PartIMessageAppPartResponse]
+
+
+class SentMessage(BaseModel):
+    """A message that was sent (used in CreateChat and SendMessage responses)"""
+
+    id: str
+    """Message identifier (UUID)"""
+
+    created_at: datetime
+    """When the message was created"""
+
+    delivery_status: Literal["pending", "queued", "sent", "delivered", "received", "read", "failed"]
+    """Current delivery status of a message"""
+
+    is_read: bool
+    """DEPRECATED: Use `delivery_status == "read"` instead.
+
+    Whether the message has been read.
+    """
+
+    parts: List[Part]
+    """Message parts in order (text, media, and link)"""
+
+    sent_at: Optional[datetime] = None
+    """When the message was actually sent (null if still queued)"""
+
+    delivered_at: Optional[datetime] = None
+    """When the message was delivered"""
+
+    effect: Optional[MessageEffect] = None
+    """iMessage effect applied to a message (screen or bubble effect)"""
+
+    from_handle: Optional[ChatHandle] = None
+    """The sender of this message as a full handle object"""
+
+    preferred_service: Optional[ServiceType] = None
+    """Messaging service type"""
+
+    reply_to: Optional[ReplyTo] = None
+    """Indicates this message is a threaded reply to another message"""
+
+    service: Optional[ServiceType] = None
+    """Messaging service type"""

linq_python-0.14.0/src/linq/types/message.py

@@ -0,0 +1,174 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Union, Optional
+from datetime import datetime
+from typing_extensions import Literal, TypeAlias
+
+from pydantic import Field as FieldInfo
+
+from .._models import BaseModel
+from .reply_to import ReplyTo
+from .message_effect import MessageEffect
+from .shared.reaction import Reaction
+from .shared.chat_handle import ChatHandle
+from .shared.service_type import ServiceType
+from .shared.link_part_response import LinkPartResponse
+from .shared.text_part_response import TextPartResponse
+from .shared.media_part_response import MediaPartResponse
+
+__all__ = [
+    "Message",
+    "Part",
+    "PartIMessageAppPartResponse",
+    "PartIMessageAppPartResponseApp",
+    "PartIMessageAppPartResponseLayout",
+]
+
+
+class PartIMessageAppPartResponseApp(BaseModel):
+    """Identifies the iMessage app (Messages app extension) that backs the card."""
+
+    bundle_id: str
+    """Bundle identifier of the Messages app extension. Must not contain `:`."""
+
+    name: str
+    """Display name of the app, shown by Messages' fallback UI."""
+
+    team_id: str
+    """The app's 10-character uppercase alphanumeric team identifier."""
+
+    app_store_id: Optional[int] = None
+    """The owning app's App Store id (optional).
+
+    When set, recipients without the iMessage app installed see a "Get the app"
+    affordance.
+    """
+
+
+class PartIMessageAppPartResponseLayout(BaseModel):
+    """Visible layout of the card.
+
+    At least one of
+    `caption`, `subcaption`, `trailing_caption`, `trailing_subcaption`, or `image_url` must be
+    set, otherwise the card renders as an empty bubble.
+    """
+
+    caption: Optional[str] = None
+    """Primary label, top-left and bold."""
+
+    image_subtitle: Optional[str] = None
+    """Overlay text shown below `image_title`. Requires `image_url`."""
+
+    image_title: Optional[str] = None
+    """Overlay text shown above the image. Requires `image_url`."""
+
+    image_url: Optional[str] = None
+    """Optional HTTPS URL of a preview image.
+
+    The server downloads it and embeds it in the card as JPEG (10MB max, same fetch
+    rules as media parts).
+    """
+
+    subcaption: Optional[str] = None
+    """Secondary label, below `caption` on the left."""
+
+    trailing_caption: Optional[str] = None
+    """Label shown top-right."""
+
+    trailing_subcaption: Optional[str] = None
+    """Label shown below `trailing_caption`, on the right."""
+
+
+class PartIMessageAppPartResponse(BaseModel):
+    """An iMessage app card part."""
+
+    app: PartIMessageAppPartResponseApp
+    """Identifies the iMessage app (Messages app extension) that backs the card."""
+
+    layout: PartIMessageAppPartResponseLayout
+    """Visible layout of the card.
+
+    At least one of `caption`, `subcaption`, `trailing_caption`,
+    `trailing_subcaption`, or `image_url` must be set, otherwise the card renders as
+    an empty bubble.
+    """
+
+    reactions: Optional[List[Reaction]] = None
+    """Reactions on this message part"""
+
+    type: Literal["imessage_app"]
+    """Indicates this is an iMessage app card part."""
+
+    url: str
+    """The URL delivered to the iMessage app on tap."""
+
+    fallback_text: Optional[str] = None
+    """Fallback text for surfaces that cannot render the card."""
+
+    session_id: Optional[str] = None
+    """Client-supplied session identifier, echoed back when provided."""
+
+
+Part: TypeAlias = Union[TextPartResponse, MediaPartResponse, LinkPartResponse, PartIMessageAppPartResponse]
+
+
+class Message(BaseModel):
+    id: str
+    """Unique identifier for the message"""
+
+    chat_id: str
+    """ID of the chat this message belongs to"""
+
+    created_at: datetime
+    """When the message was created"""
+
+    delivery_status: Literal["pending", "queued", "sent", "delivered", "received", "read", "failed"]
+    """Current delivery status of a message"""
+
+    is_delivered: bool
+    """
+    DEPRECATED: Use `delivery_status` instead (true when `delivery_status` is
+    `delivered` or `read`). Whether the message has been delivered.
+    """
+
+    is_from_me: bool
+    """Whether this message was sent by the authenticated user"""
+
+    is_read: bool
+    """DEPRECATED: Use `delivery_status == "read"` instead.
+
+    Whether the message has been read.
+    """
+
+    updated_at: datetime
+    """When the message was last updated"""
+
+    delivered_at: Optional[datetime] = None
+    """When the message was delivered"""
+
+    effect: Optional[MessageEffect] = None
+    """iMessage effect applied to a message (screen or bubble effect)"""
+
+    from_: Optional[str] = FieldInfo(alias="from", default=None)
+    """DEPRECATED: Use from_handle instead. Phone number of the message sender."""
+
+    from_handle: Optional[ChatHandle] = None
+    """The sender of this message as a full handle object"""
+
+    parts: Optional[List[Part]] = None
+    """Message parts in order (text, media, and link)"""
+
+    preferred_service: Optional[ServiceType] = None
+    """Messaging service type"""
+
+    read_at: Optional[datetime] = None
+    """When the message was read"""
+
+    reply_to: Optional[ReplyTo] = None
+    """Indicates this message is a threaded reply to another message"""
+
+    sent_at: Optional[datetime] = None
+    """When the message was sent"""
+
+    service: Optional[ServiceType] = None
+    """Messaging service type"""

linq_python-0.14.0/src/linq/types/message_content_param.py

@@ -0,0 +1,179 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Union, Iterable
+from typing_extensions import Literal, Required, TypeAlias, TypedDict
+
+from .reply_to_param import ReplyToParam
+from .link_part_param import LinkPartParam
+from .text_part_param import TextPartParam
+from .media_part_param import MediaPartParam
+from .shared.service_type import ServiceType
+from .message_effect_param import MessageEffectParam
+
+__all__ = ["MessageContentParam", "Part", "PartIMessageAppPart", "PartIMessageAppPartApp", "PartIMessageAppPartLayout"]
+
+
+class PartIMessageAppPartApp(TypedDict, total=False):
+    """Identifies the iMessage app (Messages app extension) that backs the card."""
+
+    bundle_id: Required[str]
+    """Bundle identifier of the Messages app extension. Must not contain `:`."""
+
+    name: Required[str]
+    """Display name of the app, shown by Messages' fallback UI."""
+
+    team_id: Required[str]
+    """The app's 10-character uppercase alphanumeric team identifier."""
+
+    app_store_id: int
+    """The owning app's App Store id (optional).
+
+    When set, recipients without the iMessage app installed see a "Get the app"
+    affordance.
+    """
+
+
+class PartIMessageAppPartLayout(TypedDict, total=False):
+    """Visible layout of the card.
+
+    At least one of
+    `caption`, `subcaption`, `trailing_caption`, `trailing_subcaption`, or `image_url` must be
+    set, otherwise the card renders as an empty bubble.
+    """
+
+    caption: str
+    """Primary label, top-left and bold."""
+
+    image_subtitle: str
+    """Overlay text shown below `image_title`. Requires `image_url`."""
+
+    image_title: str
+    """Overlay text shown above the image. Requires `image_url`."""
+
+    image_url: str
+    """Optional HTTPS URL of a preview image.
+
+    The server downloads it and embeds it in the card as JPEG (10MB max, same fetch
+    rules as media parts).
+    """
+
+    subcaption: str
+    """Secondary label, below `caption` on the left."""
+
+    trailing_caption: str
+    """Label shown top-right."""
+
+    trailing_subcaption: str
+    """Label shown below `trailing_caption`, on the right."""
+
+
+class PartIMessageAppPart(TypedDict, total=False):
+    """An iMessage app card, backed by a Messages app extension.
+
+    iMessage only —
+    an `imessage_app` part must be the **only** part in the message and is never delivered over
+    SMS/RCS. See the IMessageAppServiceUnsupported (2018) and RecipientUnsupportedMessageType
+    (4005) error codes.
+    """
+
+    app: Required[PartIMessageAppPartApp]
+    """Identifies the iMessage app (Messages app extension) that backs the card."""
+
+    layout: Required[PartIMessageAppPartLayout]
+    """Visible layout of the card.
+
+    At least one of `caption`, `subcaption`, `trailing_caption`,
+    `trailing_subcaption`, or `image_url` must be set, otherwise the card renders as
+    an empty bubble.
+    """
+
+    type: Required[Literal["imessage_app"]]
+    """Indicates this is an iMessage app card part."""
+
+    url: Required[str]
+    """
+    Absolute HTTPS URL delivered to the recipient's installed iMessage app when they
+    tap the card. Opaque to Messages.
+    """
+
+    fallback_text: str
+    """Text shown on surfaces that cannot render the card (notifications, lock screen).
+
+    Defaults to the caption when omitted.
+    """
+
+    session_id: str
+    """
+    Optional client-supplied identifier to correlate updatable/collaborative app
+    sessions (advanced). Not interpreted by Synapse.
+    """
+
+
+Part: TypeAlias = Union[TextPartParam, MediaPartParam, LinkPartParam, PartIMessageAppPart]
+
+
+class MessageContentParam(TypedDict, total=False):
+    """Message content container.
+
+    Groups all message-related fields together,
+    separating the "what" (message content) from the "where" (routing fields like from/to).
+    """
+
+    parts: Required[Iterable[Part]]
+    """Array of message parts.
+
+    Each part can be text, media, or link. Parts are displayed in order. Text and
+    media can be mixed freely, but a `link` part must be the only part in the
+    message.
+
+    **Rich Link Previews:**
+
+    - Use a `link` part to send a URL with a rich preview card
+    - A `link` part must be the **only** part in the message
+    - To send a URL as plain text (no preview), use a `text` part instead
+
+    **Supported Media:**
+
+    - Images: .jpg, .jpeg, .png, .gif, .heic, .heif, .tif, .tiff, .bmp
+    - Videos: .mp4, .mov, .m4v, .mpeg, .mpg, .3gp
+    - Audio: .m4a, .mp3, .aac, .caf, .wav, .aiff, .amr
+    - Documents: .pdf, .txt, .rtf, .csv, .doc, .docx, .xls, .xlsx, .ppt, .pptx,
+      .pages, .numbers, .key, .epub, .zip, .html, .htm
+    - Contact & Calendar: .vcf, .ics
+
+    **Audio:**
+
+    - Audio files (.m4a, .mp3, .aac, .caf, .wav, .aiff, .amr) are fully supported as
+      media parts
+    - To send audio as an **iMessage voice memo bubble** (inline playback UI), use
+      the dedicated `/v3/chats/{chatId}/voicememo` endpoint instead
+
+    **Validation Rules:**
+
+    - A `link` part must be the **only** part in the message. It cannot be combined
+      with text or media parts.
+    - Consecutive text parts are not allowed. Text parts must be separated by media
+      parts. For example, [text, text] is invalid, but [text, media, text] is valid.
+    - Maximum of **100 parts** total.
+    - Media parts using a public `url` (downloaded by the server on send) are capped
+      at **40**. Parts using `attachment_id` or presigned URLs are exempt from this
+      sub-limit. For bulk media sends exceeding 40 files, pre-upload via
+      `POST /v3/attachments` and reference by `attachment_id` or `download_url`.
+    """
+
+    effect: MessageEffectParam
+    """iMessage effect to apply to this message (screen or bubble effect)"""
+
+    idempotency_key: str
+    """
+    Optional idempotency key for this message. Use this to prevent duplicate sends
+    of the same message.
+    """
+
+    preferred_service: ServiceType
+    """Messaging service type"""
+
+    reply_to: ReplyToParam
+    """Reply to another message to create a threaded conversation"""