linq-python 0.1.0__py3-none-any.whl

linq/types/chat_group_name_update_failed_webhook_event.py

@@ -0,0 +1,65 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from datetime import datetime
+
+from .._models import BaseModel
+from .webhook_event_type import WebhookEventType
+
+__all__ = ["ChatGroupNameUpdateFailedWebhookEvent", "Data"]
+
+
+class Data(BaseModel):
+    """
+    Error details for chat.group_name_update_failed webhook events.
+    See [WebhookErrorCode](#/components/schemas/WebhookErrorCode) for the full error code reference.
+    """
+
+    chat_id: str
+    """Chat identifier (UUID) of the group chat"""
+
+    error_code: int
+    """Error codes in webhook failure events (3007, 4001)."""
+
+    failed_at: datetime
+    """When the failure was detected"""
+
+
+class ChatGroupNameUpdateFailedWebhookEvent(BaseModel):
+    """Complete webhook payload for chat.group_name_update_failed events"""
+
+    api_version: str
+    """API version for the webhook payload format"""
+
+    created_at: datetime
+    """When the event was created"""
+
+    data: Data
+    """
+    Error details for chat.group_name_update_failed webhook events. See
+    [WebhookErrorCode](#/components/schemas/WebhookErrorCode) for the full error
+    code reference.
+    """
+
+    event_id: str
+    """Unique identifier for this event (for deduplication)"""
+
+    event_type: WebhookEventType
+    """Valid webhook event types that can be subscribed to.
+
+    **Note:** `message.edited` is only delivered to subscriptions using
+    `webhook_version: "2026-02-03"`. Subscribing to this event on a v2025
+    subscription will not produce any deliveries.
+    """
+
+    partner_id: str
+    """Partner identifier. Present on all webhooks for cross-referencing."""
+
+    trace_id: str
+    """Trace ID for debugging and correlation across systems."""
+
+    webhook_version: str
+    """
+    Date-based webhook payload version. Determined by the `?version=` query
+    parameter in your webhook subscription URL. If no version parameter is
+    specified, defaults based on subscription creation date.
+    """

linq/types/chat_group_name_updated_webhook_event.py

@@ -0,0 +1,66 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from datetime import datetime
+
+from .._models import BaseModel
+from .shared.chat_handle import ChatHandle
+from .webhook_event_type import WebhookEventType
+
+__all__ = ["ChatGroupNameUpdatedWebhookEvent", "Data"]
+
+
+class Data(BaseModel):
+    """Payload for chat.group_name_updated webhook events"""
+
+    chat_id: str
+    """Chat identifier (UUID) of the group chat"""
+
+    updated_at: datetime
+    """When the update occurred"""
+
+    changed_by_handle: Optional[ChatHandle] = None
+    """The handle who made the change."""
+
+    new_value: Optional[str] = None
+    """New group name (null if the name was removed)"""
+
+    old_value: Optional[str] = None
+    """Previous group name (null if no previous name)"""
+
+
+class ChatGroupNameUpdatedWebhookEvent(BaseModel):
+    """Complete webhook payload for chat.group_name_updated events"""
+
+    api_version: str
+    """API version for the webhook payload format"""
+
+    created_at: datetime
+    """When the event was created"""
+
+    data: Data
+    """Payload for chat.group_name_updated webhook events"""
+
+    event_id: str
+    """Unique identifier for this event (for deduplication)"""
+
+    event_type: WebhookEventType
+    """Valid webhook event types that can be subscribed to.
+
+    **Note:** `message.edited` is only delivered to subscriptions using
+    `webhook_version: "2026-02-03"`. Subscribing to this event on a v2025
+    subscription will not produce any deliveries.
+    """
+
+    partner_id: str
+    """Partner identifier. Present on all webhooks for cross-referencing."""
+
+    trace_id: str
+    """Trace ID for debugging and correlation across systems."""
+
+    webhook_version: str
+    """
+    Date-based webhook payload version. Determined by the `?version=` query
+    parameter in your webhook subscription URL. If no version parameter is
+    specified, defaults based on subscription creation date.
+    """

linq/types/chat_leave_chat_response.py

@@ -0,0 +1,15 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from .._models import BaseModel
+
+__all__ = ["ChatLeaveChatResponse"]
+
+
+class ChatLeaveChatResponse(BaseModel):
+    message: Optional[str] = None
+
+    status: Optional[str] = None
+
+    trace_id: Optional[str] = None

linq/types/chat_list_chats_params.py

@@ -0,0 +1,36 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Annotated, TypedDict
+
+from .._utils import PropertyInfo
+
+__all__ = ["ChatListChatsParams"]
+
+
+class ChatListChatsParams(TypedDict, total=False):
+    cursor: str
+    """
+    Pagination cursor from the previous response's `next_cursor` field. Omit this
+    parameter for the first page of results.
+    """
+
+    from_: Annotated[str, PropertyInfo(alias="from")]
+    """Phone number to filter chats by.
+
+    Returns chats made from this phone number. Must be in E.164 format (e.g.,
+    `+13343284472`). The `+` is automatically URL-encoded by HTTP clients. If
+    omitted, returns chats across all phone numbers owned by the partner.
+    """
+
+    limit: int
+    """Maximum number of chats to return per page"""
+
+    to: str
+    """Filter chats by a participant handle.
+
+    Only returns chats where this handle is a participant. Can be an E.164 phone
+    number (e.g., `+13343284472`) or an email address (e.g., `user@example.com`).
+    For phone numbers, the `+` is automatically URL-encoded by HTTP clients.
+    """

linq/types/chat_send_voicememo_params.py

@@ -0,0 +1,23 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import TypedDict
+
+__all__ = ["ChatSendVoicememoParams"]
+
+
+class ChatSendVoicememoParams(TypedDict, total=False):
+    attachment_id: str
+    """
+    Reference to a voice memo file pre-uploaded via `POST /v3/attachments`. The file
+    is already stored, so sends using this ID skip the download step.
+
+    Either `voice_memo_url` or `attachment_id` must be provided, but not both.
+    """
+
+    voice_memo_url: str
+    """URL of the voice memo audio file. Must be a publicly accessible HTTPS URL.
+
+    Either `voice_memo_url` or `attachment_id` must be provided, but not both.
+    """

linq/types/chat_send_voicememo_response.py

@@ -0,0 +1,79 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+from datetime import datetime
+
+from pydantic import Field as FieldInfo
+
+from .._models import BaseModel
+from .shared.chat_handle import ChatHandle
+from .shared.service_type import ServiceType
+
+__all__ = ["ChatSendVoicememoResponse", "VoiceMemo", "VoiceMemoChat", "VoiceMemoVoiceMemo"]
+
+
+class VoiceMemoChat(BaseModel):
+    id: str
+    """Chat identifier"""
+
+    handles: List[ChatHandle]
+    """Chat participants"""
+
+    is_active: bool
+    """Whether the chat is active"""
+
+    is_group: bool
+    """Whether this is a group chat"""
+
+    service: ServiceType
+    """Messaging service type"""
+
+
+class VoiceMemoVoiceMemo(BaseModel):
+    id: str
+    """Attachment identifier"""
+
+    filename: str
+    """Original filename"""
+
+    mime_type: str
+    """Audio MIME type"""
+
+    size_bytes: int
+    """File size in bytes"""
+
+    url: str
+    """CDN URL for downloading the voice memo"""
+
+    duration_ms: Optional[int] = None
+    """Duration in milliseconds"""
+
+
+class VoiceMemo(BaseModel):
+    id: str
+    """Message identifier"""
+
+    chat: VoiceMemoChat
+
+    created_at: datetime
+    """When the voice memo was created"""
+
+    from_: str = FieldInfo(alias="from")
+    """Sender phone number"""
+
+    status: str
+    """Current delivery status"""
+
+    to: List[str]
+    """Recipient handles (phone numbers or email addresses)"""
+
+    voice_memo: VoiceMemoVoiceMemo
+
+    service: Optional[ServiceType] = None
+    """Messaging service type"""
+
+
+class ChatSendVoicememoResponse(BaseModel):
+    """Response for sending a voice memo to a chat"""
+
+    voice_memo: VoiceMemo

linq/types/chat_typing_indicator_started_webhook_event.py

@@ -0,0 +1,52 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from datetime import datetime
+
+from .._models import BaseModel
+from .webhook_event_type import WebhookEventType
+
+__all__ = ["ChatTypingIndicatorStartedWebhookEvent", "Data"]
+
+
+class Data(BaseModel):
+    """Payload for chat.typing_indicator.started webhook events"""
+
+    chat_id: str
+    """Chat identifier"""
+
+
+class ChatTypingIndicatorStartedWebhookEvent(BaseModel):
+    """Complete webhook payload for chat.typing_indicator.started events"""
+
+    api_version: str
+    """API version for the webhook payload format"""
+
+    created_at: datetime
+    """When the event was created"""
+
+    data: Data
+    """Payload for chat.typing_indicator.started webhook events"""
+
+    event_id: str
+    """Unique identifier for this event (for deduplication)"""
+
+    event_type: WebhookEventType
+    """Valid webhook event types that can be subscribed to.
+
+    **Note:** `message.edited` is only delivered to subscriptions using
+    `webhook_version: "2026-02-03"`. Subscribing to this event on a v2025
+    subscription will not produce any deliveries.
+    """
+
+    partner_id: str
+    """Partner identifier. Present on all webhooks for cross-referencing."""
+
+    trace_id: str
+    """Trace ID for debugging and correlation across systems."""
+
+    webhook_version: str
+    """
+    Date-based webhook payload version. Determined by the `?version=` query
+    parameter in your webhook subscription URL. If no version parameter is
+    specified, defaults based on subscription creation date.
+    """

linq/types/chat_typing_indicator_stopped_webhook_event.py

@@ -0,0 +1,52 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from datetime import datetime
+
+from .._models import BaseModel
+from .webhook_event_type import WebhookEventType
+
+__all__ = ["ChatTypingIndicatorStoppedWebhookEvent", "Data"]
+
+
+class Data(BaseModel):
+    """Payload for chat.typing_indicator.stopped webhook events"""
+
+    chat_id: str
+    """Chat identifier"""
+
+
+class ChatTypingIndicatorStoppedWebhookEvent(BaseModel):
+    """Complete webhook payload for chat.typing_indicator.stopped events"""
+
+    api_version: str
+    """API version for the webhook payload format"""
+
+    created_at: datetime
+    """When the event was created"""
+
+    data: Data
+    """Payload for chat.typing_indicator.stopped webhook events"""
+
+    event_id: str
+    """Unique identifier for this event (for deduplication)"""
+
+    event_type: WebhookEventType
+    """Valid webhook event types that can be subscribed to.
+
+    **Note:** `message.edited` is only delivered to subscriptions using
+    `webhook_version: "2026-02-03"`. Subscribing to this event on a v2025
+    subscription will not produce any deliveries.
+    """
+
+    partner_id: str
+    """Partner identifier. Present on all webhooks for cross-referencing."""
+
+    trace_id: str
+    """Trace ID for debugging and correlation across systems."""
+
+    webhook_version: str
+    """
+    Date-based webhook payload version. Determined by the `?version=` query
+    parameter in your webhook subscription URL. If no version parameter is
+    specified, defaults based on subscription creation date.
+    """

linq/types/chat_update_params.py

@@ -0,0 +1,15 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import TypedDict
+
+__all__ = ["ChatUpdateParams"]
+
+
+class ChatUpdateParams(TypedDict, total=False):
+    display_name: str
+    """New display name for the chat (group chats only)"""
+
+    group_chat_icon: str
+    """URL of an image to set as the group chat icon (group chats only)"""

linq/types/chat_update_response.py

@@ -0,0 +1,13 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from .._models import BaseModel
+
+__all__ = ["ChatUpdateResponse"]
+
+
+class ChatUpdateResponse(BaseModel):
+    chat_id: Optional[str] = None
+
+    status: Optional[str] = None

linq/types/chats/__init__.py

@@ -0,0 +1,12 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from .sent_message import SentMessage as SentMessage
+from .message_list_params import MessageListParams as MessageListParams
+from .message_send_params import MessageSendParams as MessageSendParams
+from .message_send_response import MessageSendResponse as MessageSendResponse
+from .participant_add_params import ParticipantAddParams as ParticipantAddParams
+from .participant_add_response import ParticipantAddResponse as ParticipantAddResponse
+from .participant_remove_params import ParticipantRemoveParams as ParticipantRemoveParams
+from .participant_remove_response import ParticipantRemoveResponse as ParticipantRemoveResponse

linq/types/chats/message_list_params.py

@@ -0,0 +1,15 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import TypedDict
+
+__all__ = ["MessageListParams"]
+
+
+class MessageListParams(TypedDict, total=False):
+    cursor: str
+    """Pagination cursor from previous next_cursor response"""
+
+    limit: int
+    """Maximum number of messages to return"""

linq/types/chats/message_send_params.py

@@ -0,0 +1,18 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Required, TypedDict
+
+from ..message_content_param import MessageContentParam
+
+__all__ = ["MessageSendParams"]
+
+
+class MessageSendParams(TypedDict, total=False):
+    message: Required[MessageContentParam]
+    """Message content container.
+
+    Groups all message-related fields together, separating the "what" (message
+    content) from the "where" (routing fields like from/to).
+    """

linq/types/chats/message_send_response.py

@@ -0,0 +1,16 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from ..._models import BaseModel
+from .sent_message import SentMessage
+
+__all__ = ["MessageSendResponse"]
+
+
+class MessageSendResponse(BaseModel):
+    """Response for sending a message to a chat"""
+
+    chat_id: str
+    """Unique identifier of the chat this message was sent to"""
+
+    message: SentMessage
+    """A message that was sent (used in CreateChat and SendMessage responses)"""

linq/types/chats/participant_add_params.py

@@ -0,0 +1,12 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Required, TypedDict
+
+__all__ = ["ParticipantAddParams"]
+
+
+class ParticipantAddParams(TypedDict, total=False):
+    handle: Required[str]
+    """Phone number (E.164 format) or email address of the participant to add"""

linq/types/chats/participant_add_response.py

@@ -0,0 +1,15 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from ..._models import BaseModel
+
+__all__ = ["ParticipantAddResponse"]
+
+
+class ParticipantAddResponse(BaseModel):
+    message: Optional[str] = None
+
+    status: Optional[str] = None
+
+    trace_id: Optional[str] = None

linq/types/chats/participant_remove_params.py

@@ -0,0 +1,12 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Required, TypedDict
+
+__all__ = ["ParticipantRemoveParams"]
+
+
+class ParticipantRemoveParams(TypedDict, total=False):
+    handle: Required[str]
+    """Phone number (E.164 format) or email address of the participant to remove"""

linq/types/chats/participant_remove_response.py

@@ -0,0 +1,15 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from ..._models import BaseModel
+
+__all__ = ["ParticipantRemoveResponse"]
+
+
+class ParticipantRemoveResponse(BaseModel):
+    message: Optional[str] = None
+
+    status: Optional[str] = None
+
+    trace_id: Optional[str] = None

linq/types/chats/sent_message.py

@@ -0,0 +1,69 @@
+# 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.text_part_response import TextPartResponse
+from ..shared.media_part_response import MediaPartResponse
+
+__all__ = ["SentMessage", "Part", "PartLinkPartResponse"]
+
+
+class PartLinkPartResponse(BaseModel):
+    """A rich link preview part"""
+
+    reactions: Optional[List[Reaction]] = None
+    """Reactions on this message part"""
+
+    type: Literal["link"]
+    """Indicates this is a rich link preview part"""
+
+    value: str
+    """The URL"""
+
+
+Part: TypeAlias = Union[TextPartResponse, MediaPartResponse, PartLinkPartResponse]
+
+
+class SentMessage(BaseModel):
+    """A message that was sent (used in CreateChat and SendMessage responses)"""
+
+    id: str
+    """Message identifier (UUID)"""
+
+    delivery_status: Literal["pending", "queued", "sent", "delivered", "failed"]
+    """Current delivery status of a message"""
+
+    is_read: bool
+    """Whether the message has been read"""
+
+    parts: List[Part]
+    """Message parts in order (text, media, and link)"""
+
+    sent_at: datetime
+    """When the message was sent"""
+
+    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/types/contact_card_create_params.py

@@ -0,0 +1,24 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Required, TypedDict
+
+__all__ = ["ContactCardCreateParams"]
+
+
+class ContactCardCreateParams(TypedDict, total=False):
+    first_name: Required[str]
+    """First name for the contact card. Required."""
+
+    phone_number: Required[str]
+    """E.164 phone number to associate the contact card with"""
+
+    image_url: str
+    """URL of the profile image to rehost on the CDN.
+
+    Only re-uploaded when a new value is provided.
+    """
+
+    last_name: str
+    """Last name for the contact card. Optional."""

linq/types/contact_card_retrieve_params.py

@@ -0,0 +1,15 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import TypedDict
+
+__all__ = ["ContactCardRetrieveParams"]
+
+
+class ContactCardRetrieveParams(TypedDict, total=False):
+    phone_number: str
+    """E.164 phone number to filter by.
+
+    If omitted, all my cards for the partner are returned.
+    """