linq-python 0.1.0__py3-none-any.whl

linq/resources/webhooks.py

@@ -0,0 +1,34 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+import json
+from typing import cast
+
+from .._models import construct_type
+from .._resource import SyncAPIResource, AsyncAPIResource
+from ..types.events_webhook_event import EventsWebhookEvent
+
+__all__ = ["WebhooksResource", "AsyncWebhooksResource"]
+
+
+class WebhooksResource(SyncAPIResource):
+    def events(self, payload: str) -> EventsWebhookEvent:
+        return cast(
+            EventsWebhookEvent,
+            construct_type(
+                type_=EventsWebhookEvent,
+                value=json.loads(payload),
+            ),
+        )
+
+
+class AsyncWebhooksResource(AsyncAPIResource):
+    def events(self, payload: str) -> EventsWebhookEvent:
+        return cast(
+            EventsWebhookEvent,
+            construct_type(
+                type_=EventsWebhookEvent,
+                value=json.loads(payload),
+            ),
+        )

linq/types/__init__.py

@@ -0,0 +1,90 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from .chat import Chat as Chat
+from .shared import (
+    Reaction as Reaction,
+    ChatHandle as ChatHandle,
+    ServiceType as ServiceType,
+    ReactionType as ReactionType,
+    TextDecoration as TextDecoration,
+    TextPartResponse as TextPartResponse,
+    MediaPartResponse as MediaPartResponse,
+)
+from .message import Message as Message
+from .reply_to import ReplyTo as ReplyTo
+from .message_effect import MessageEffect as MessageEffect
+from .reply_to_param import ReplyToParam as ReplyToParam
+from .link_part_param import LinkPartParam as LinkPartParam
+from .text_part_param import TextPartParam as TextPartParam
+from .media_part_param import MediaPartParam as MediaPartParam
+from .message_event_v2 import MessageEventV2 as MessageEventV2
+from .set_contact_card import SetContactCard as SetContactCard
+from .chat_create_params import ChatCreateParams as ChatCreateParams
+from .chat_update_params import ChatUpdateParams as ChatUpdateParams
+from .webhook_event_type import WebhookEventType as WebhookEventType
+from .reaction_event_base import ReactionEventBase as ReactionEventBase
+from .chat_create_response import ChatCreateResponse as ChatCreateResponse
+from .chat_update_response import ChatUpdateResponse as ChatUpdateResponse
+from .events_webhook_event import EventsWebhookEvent as EventsWebhookEvent
+from .message_effect_param import MessageEffectParam as MessageEffectParam
+from .webhook_subscription import WebhookSubscription as WebhookSubscription
+from .handle_check_response import HandleCheckResponse as HandleCheckResponse
+from .message_content_param import MessageContentParam as MessageContentParam
+from .message_update_params import MessageUpdateParams as MessageUpdateParams
+from .chat_list_chats_params import ChatListChatsParams as ChatListChatsParams
+from .schemas_message_effect import SchemasMessageEffect as SchemasMessageEffect
+from .supported_content_type import SupportedContentType as SupportedContentType
+from .attachment_create_params import AttachmentCreateParams as AttachmentCreateParams
+from .chat_leave_chat_response import ChatLeaveChatResponse as ChatLeaveChatResponse
+from .phonenumber_list_response import PhonenumberListResponse as PhonenumberListResponse
+from .attachment_create_response import AttachmentCreateResponse as AttachmentCreateResponse
+from .chat_created_webhook_event import ChatCreatedWebhookEvent as ChatCreatedWebhookEvent
+from .chat_send_voicememo_params import ChatSendVoicememoParams as ChatSendVoicememoParams
+from .contact_card_create_params import ContactCardCreateParams as ContactCardCreateParams
+from .contact_card_update_params import ContactCardUpdateParams as ContactCardUpdateParams
+from .message_read_webhook_event import MessageReadWebhookEvent as MessageReadWebhookEvent
+from .message_sent_webhook_event import MessageSentWebhookEvent as MessageSentWebhookEvent
+from .phone_number_list_response import PhoneNumberListResponse as PhoneNumberListResponse
+from .schemas_text_part_response import SchemasTextPartResponse as SchemasTextPartResponse
+from .capability_check_RCS_params import CapabilityCheckRCSParams as CapabilityCheckRCSParams
+from .message_add_reaction_params import MessageAddReactionParams as MessageAddReactionParams
+from .schemas_media_part_response import SchemasMediaPartResponse as SchemasMediaPartResponse
+from .webhook_event_list_response import WebhookEventListResponse as WebhookEventListResponse
+from .attachment_retrieve_response import AttachmentRetrieveResponse as AttachmentRetrieveResponse
+from .chat_send_voicememo_response import ChatSendVoicememoResponse as ChatSendVoicememoResponse
+from .contact_card_retrieve_params import ContactCardRetrieveParams as ContactCardRetrieveParams
+from .message_edited_webhook_event import MessageEditedWebhookEvent as MessageEditedWebhookEvent
+from .message_failed_webhook_event import MessageFailedWebhookEvent as MessageFailedWebhookEvent
+from .reaction_added_webhook_event import ReactionAddedWebhookEvent as ReactionAddedWebhookEvent
+from .message_add_reaction_response import MessageAddReactionResponse as MessageAddReactionResponse
+from .contact_card_retrieve_response import ContactCardRetrieveResponse as ContactCardRetrieveResponse
+from .message_received_webhook_event import MessageReceivedWebhookEvent as MessageReceivedWebhookEvent
+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 .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
+from .webhook_subscription_update_params import WebhookSubscriptionUpdateParams as WebhookSubscriptionUpdateParams
+from .message_list_messages_thread_params import MessageListMessagesThreadParams as MessageListMessagesThreadParams
+from .webhook_subscription_create_response import WebhookSubscriptionCreateResponse as WebhookSubscriptionCreateResponse
+from .chat_group_icon_updated_webhook_event import ChatGroupIconUpdatedWebhookEvent as ChatGroupIconUpdatedWebhookEvent
+from .chat_group_name_updated_webhook_event import ChatGroupNameUpdatedWebhookEvent as ChatGroupNameUpdatedWebhookEvent
+from .phone_number_status_updated_webhook_event import (
+    PhoneNumberStatusUpdatedWebhookEvent as PhoneNumberStatusUpdatedWebhookEvent,
+)
+from .chat_group_icon_update_failed_webhook_event import (
+    ChatGroupIconUpdateFailedWebhookEvent as ChatGroupIconUpdateFailedWebhookEvent,
+)
+from .chat_group_name_update_failed_webhook_event import (
+    ChatGroupNameUpdateFailedWebhookEvent as ChatGroupNameUpdateFailedWebhookEvent,
+)
+from .chat_typing_indicator_started_webhook_event import (
+    ChatTypingIndicatorStartedWebhookEvent as ChatTypingIndicatorStartedWebhookEvent,
+)
+from .chat_typing_indicator_stopped_webhook_event import (
+    ChatTypingIndicatorStoppedWebhookEvent as ChatTypingIndicatorStoppedWebhookEvent,
+)

linq/types/attachment_create_params.py

@@ -0,0 +1,42 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Required, TypedDict
+
+from .supported_content_type import SupportedContentType
+
+__all__ = ["AttachmentCreateParams"]
+
+
+class AttachmentCreateParams(TypedDict, total=False):
+    content_type: Required[SupportedContentType]
+    """Supported MIME types for file attachments and media URLs.
+
+    **Images:** image/jpeg, image/png, image/gif, image/heic, image/heif,
+    image/tiff, image/bmp
+
+    **Videos:** video/mp4, video/quicktime, video/mpeg, video/3gpp
+
+    **Audio:** audio/mpeg, audio/mp4, audio/x-m4a, audio/x-caf, audio/wav,
+    audio/aiff, audio/aac, audio/amr
+
+    **Documents:** application/pdf, text/plain, text/markdown, text/vcard, text/rtf,
+    text/csv, text/html, text/calendar, application/msword,
+    application/vnd.openxmlformats-officedocument.wordprocessingml.document,
+    application/vnd.ms-excel,
+    application/vnd.openxmlformats-officedocument.spreadsheetml.sheet,
+    application/vnd.ms-powerpoint,
+    application/vnd.openxmlformats-officedocument.presentationml.presentation,
+    application/vnd.apple.pages, application/vnd.apple.numbers,
+    application/vnd.apple.keynote, application/epub+zip, application/zip
+
+    **Unsupported:** WebP, SVG, FLAC, OGG, and executable files are explicitly
+    rejected.
+    """
+
+    filename: Required[str]
+    """Name of the file to upload"""
+
+    size_bytes: Required[int]
+    """Size of the file in bytes (max 100MB)"""

linq/types/attachment_create_response.py

@@ -0,0 +1,44 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Dict
+from datetime import datetime
+from typing_extensions import Literal
+
+from .._models import BaseModel
+
+__all__ = ["AttachmentCreateResponse"]
+
+
+class AttachmentCreateResponse(BaseModel):
+    attachment_id: str
+    """
+    Unique identifier for the attachment (for status checks via GET
+    /v3/attachments/{id})
+    """
+
+    download_url: str
+    """Permanent CDN URL for the file.
+
+    Does not expire. Use the `attachment_id` to reference this file in media parts
+    when sending messages.
+    """
+
+    expires_at: datetime
+    """When the upload URL expires (15 minutes from now)"""
+
+    http_method: Literal["PUT"]
+    """HTTP method to use for upload (always PUT)"""
+
+    required_headers: Dict[str, str]
+    """HTTP headers that must be set on the upload request.
+
+    The presigned URL is signed with these exact values — S3 will reject the upload
+    if they don't match.
+    """
+
+    upload_url: str
+    """Presigned URL for uploading the file.
+
+    PUT the raw binary file content to this URL with the `required_headers`. Do not
+    JSON-encode or multipart-wrap the body. Expires after 15 minutes.
+    """

linq/types/attachment_retrieve_response.py

@@ -0,0 +1,55 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from datetime import datetime
+from typing_extensions import Literal
+
+from .._models import BaseModel
+from .supported_content_type import SupportedContentType
+
+__all__ = ["AttachmentRetrieveResponse"]
+
+
+class AttachmentRetrieveResponse(BaseModel):
+    id: str
+    """Unique identifier for the attachment (UUID)"""
+
+    content_type: SupportedContentType
+    """Supported MIME types for file attachments and media URLs.
+
+    **Images:** image/jpeg, image/png, image/gif, image/heic, image/heif,
+    image/tiff, image/bmp
+
+    **Videos:** video/mp4, video/quicktime, video/mpeg, video/3gpp
+
+    **Audio:** audio/mpeg, audio/mp4, audio/x-m4a, audio/x-caf, audio/wav,
+    audio/aiff, audio/aac, audio/amr
+
+    **Documents:** application/pdf, text/plain, text/markdown, text/vcard, text/rtf,
+    text/csv, text/html, text/calendar, application/msword,
+    application/vnd.openxmlformats-officedocument.wordprocessingml.document,
+    application/vnd.ms-excel,
+    application/vnd.openxmlformats-officedocument.spreadsheetml.sheet,
+    application/vnd.ms-powerpoint,
+    application/vnd.openxmlformats-officedocument.presentationml.presentation,
+    application/vnd.apple.pages, application/vnd.apple.numbers,
+    application/vnd.apple.keynote, application/epub+zip, application/zip
+
+    **Unsupported:** WebP, SVG, FLAC, OGG, and executable files are explicitly
+    rejected.
+    """
+
+    created_at: datetime
+    """When the attachment was created"""
+
+    filename: str
+    """Original filename of the attachment"""
+
+    size_bytes: int
+    """Size of the attachment in bytes"""
+
+    status: Literal["pending", "complete", "failed"]
+    """Current upload/processing status"""
+
+    download_url: Optional[str] = None
+    """URL to download the attachment"""

linq/types/capability_check_RCS_params.py

@@ -0,0 +1,20 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Required, Annotated, TypedDict
+
+from .._utils import PropertyInfo
+
+__all__ = ["CapabilityCheckRCSParams"]
+
+
+class CapabilityCheckRCSParams(TypedDict, total=False):
+    address: Required[str]
+    """The recipient phone number or email address to check"""
+
+    from_: Annotated[str, PropertyInfo(alias="from")]
+    """Optional sender phone number.
+
+    If omitted, an available phone from your pool is used automatically.
+    """

linq/types/capability_check_i_message_params.py

@@ -0,0 +1,20 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Required, Annotated, TypedDict
+
+from .._utils import PropertyInfo
+
+__all__ = ["CapabilityCheckiMessageParams"]
+
+
+class CapabilityCheckiMessageParams(TypedDict, total=False):
+    address: Required[str]
+    """The recipient phone number or email address to check"""
+
+    from_: Annotated[str, PropertyInfo(alias="from")]
+    """Optional sender phone number.
+
+    If omitted, an available phone from your pool is used automatically.
+    """

linq/types/chat.py

@@ -0,0 +1,44 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+from datetime import datetime
+
+from .._models import BaseModel
+from .shared.chat_handle import ChatHandle
+from .shared.service_type import ServiceType
+
+__all__ = ["Chat"]
+
+
+class Chat(BaseModel):
+    id: str
+    """Unique identifier for the chat"""
+
+    created_at: datetime
+    """When the chat was created"""
+
+    display_name: Optional[str] = None
+    """Display name for the chat.
+
+    Defaults to a comma-separated list of recipient handles. Can be updated for
+    group chats.
+    """
+
+    handles: List[ChatHandle]
+    """List of chat participants with full handle details.
+
+    Always contains at least two handles (your phone number and the other
+    participant).
+    """
+
+    is_archived: bool
+    """Whether the chat is archived"""
+
+    is_group: bool
+    """Whether this is a group chat"""
+
+    updated_at: datetime
+    """When the chat was last updated"""
+
+    service: Optional[ServiceType] = None
+    """Messaging service type"""

linq/types/chat_create_params.py

@@ -0,0 +1,33 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Required, Annotated, TypedDict
+
+from .._types import SequenceNotStr
+from .._utils import PropertyInfo
+from .message_content_param import MessageContentParam
+
+__all__ = ["ChatCreateParams"]
+
+
+class ChatCreateParams(TypedDict, total=False):
+    from_: Required[Annotated[str, PropertyInfo(alias="from")]]
+    """Sender phone number in E.164 format.
+
+    Must be a phone number that the authenticated partner has permission to send
+    from.
+    """
+
+    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).
+    """
+
+    to: Required[SequenceNotStr[str]]
+    """
+    Array of recipient handles (phone numbers in E.164 format or email addresses).
+    For individual chats, provide one recipient. For group chats, provide multiple.
+    """

linq/types/chat_create_response.py

@@ -0,0 +1,44 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+
+from .._models import BaseModel
+from .chats.sent_message import SentMessage
+from .shared.chat_handle import ChatHandle
+from .shared.service_type import ServiceType
+
+__all__ = ["ChatCreateResponse", "Chat"]
+
+
+class Chat(BaseModel):
+    id: str
+    """Unique identifier for the created chat (UUID)"""
+
+    display_name: Optional[str] = None
+    """Display name for the chat.
+
+    Defaults to a comma-separated list of recipient handles. Can be updated for
+    group chats.
+    """
+
+    handles: List[ChatHandle]
+    """List of participants in the chat.
+
+    Always contains at least two handles (your phone number and the other
+    participant).
+    """
+
+    is_group: bool
+    """Whether this is a group chat"""
+
+    message: SentMessage
+    """A message that was sent (used in CreateChat and SendMessage responses)"""
+
+    service: ServiceType
+    """Messaging service type"""
+
+
+class ChatCreateResponse(BaseModel):
+    """Response for creating a new chat with an initial message"""
+
+    chat: Chat

linq/types/chat_created_webhook_event.py

@@ -0,0 +1,87 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+from datetime import datetime
+
+from .._models import BaseModel
+from .shared.chat_handle import ChatHandle
+from .webhook_event_type import WebhookEventType
+from .shared.service_type import ServiceType
+
+__all__ = ["ChatCreatedWebhookEvent", "Data"]
+
+
+class Data(BaseModel):
+    """Payload for chat.created webhook events.
+
+    Matches GET /v3/chats/{chatId} response.
+    """
+
+    id: str
+    """Unique identifier for the chat"""
+
+    created_at: datetime
+    """When the chat was created"""
+
+    display_name: Optional[str] = None
+    """Display name for the chat.
+
+    Defaults to a comma-separated list of recipient handles. Can be updated for
+    group chats.
+    """
+
+    handles: List[ChatHandle]
+    """List of chat participants with full handle details.
+
+    Always contains at least two handles (your phone number and the other
+    participant).
+    """
+
+    is_group: bool
+    """Whether this is a group chat"""
+
+    updated_at: datetime
+    """When the chat was last updated"""
+
+    service: Optional[ServiceType] = None
+    """Messaging service type"""
+
+
+class ChatCreatedWebhookEvent(BaseModel):
+    """Complete webhook payload for chat.created events"""
+
+    api_version: str
+    """API version for the webhook payload format"""
+
+    created_at: datetime
+    """When the event was created"""
+
+    data: Data
+    """Payload for chat.created webhook events.
+
+    Matches GET /v3/chats/{chatId} response.
+    """
+
+    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_icon_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__ = ["ChatGroupIconUpdateFailedWebhookEvent", "Data"]
+
+
+class Data(BaseModel):
+    """
+    Error details for chat.group_icon_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 ChatGroupIconUpdateFailedWebhookEvent(BaseModel):
+    """Complete webhook payload for chat.group_icon_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_icon_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_icon_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__ = ["ChatGroupIconUpdatedWebhookEvent", "Data"]
+
+
+class Data(BaseModel):
+    """Payload for chat.group_icon_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 icon URL (null if the icon was removed)"""
+
+    old_value: Optional[str] = None
+    """Previous icon URL (null if no previous icon)"""
+
+
+class ChatGroupIconUpdatedWebhookEvent(BaseModel):
+    """Complete webhook payload for chat.group_icon_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_icon_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.
+    """