linq-python 0.1.0__py3-none-any.whl

linq/types/message_event_v2.py

@@ -0,0 +1,116 @@
+# 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, Annotated, TypeAlias
+
+from .._utils import PropertyInfo
+from .._models import BaseModel
+from .shared.chat_handle import ChatHandle
+from .shared.service_type import ServiceType
+from .schemas_message_effect import SchemasMessageEffect
+from .schemas_text_part_response import SchemasTextPartResponse
+from .schemas_media_part_response import SchemasMediaPartResponse
+
+__all__ = ["MessageEventV2", "Chat", "Part", "PartSchemasLinkPartResponse", "ReplyTo"]
+
+
+class Chat(BaseModel):
+    """Chat information"""
+
+    id: str
+    """Chat identifier"""
+
+    is_group: Optional[bool] = None
+    """Whether this is a group chat"""
+
+    owner_handle: Optional[ChatHandle] = None
+    """Your phone number's handle. Always has is_me=true."""
+
+
+class PartSchemasLinkPartResponse(BaseModel):
+    """A rich link preview part"""
+
+    type: Literal["link"]
+    """Indicates this is a rich link preview part"""
+
+    value: str
+    """The URL"""
+
+
+Part: TypeAlias = Annotated[
+    Union[SchemasTextPartResponse, SchemasMediaPartResponse, PartSchemasLinkPartResponse],
+    PropertyInfo(discriminator="type"),
+]
+
+
+class ReplyTo(BaseModel):
+    """Reference to the message this is replying to (for threaded replies)"""
+
+    message_id: Optional[str] = None
+    """ID of the message being replied to"""
+
+    part_index: Optional[int] = None
+    """Index of the part being replied to"""
+
+
+class MessageEventV2(BaseModel):
+    """Unified payload for message webhooks when using `webhook_version: "2026-02-03"`.
+
+    This schema is used for message.sent, message.received, message.delivered, and message.read
+    events when the subscription URL includes `?version=2026-02-03`.
+
+    Key differences from V1 (2025-01-01):
+    - `direction`: "inbound" or "outbound" instead of `is_from_me` boolean
+    - `sender_handle`: Full handle object for the sender
+    - `chat`: Nested object with `id`, `is_group`, and `owner_handle`
+    - Message fields (`id`, `parts`, `effect`, etc.) are at the top level, not nested in `message`
+
+    Timestamps indicate the message state:
+    - `message.sent`: sent_at set, delivered_at=null, read_at=null
+    - `message.received`: sent_at set, delivered_at=null, read_at=null
+    - `message.delivered`: sent_at set, delivered_at set, read_at=null
+    - `message.read`: sent_at set, delivered_at set, read_at set
+    """
+
+    id: str
+    """Message identifier"""
+
+    chat: Chat
+    """Chat information"""
+
+    direction: Literal["inbound", "outbound"]
+    """Message direction - "outbound" if sent by you, "inbound" if received"""
+
+    parts: List[Part]
+    """Message parts (text and/or media)"""
+
+    sender_handle: ChatHandle
+    """The handle that sent this message"""
+
+    service: ServiceType
+    """Messaging service type"""
+
+    delivered_at: Optional[datetime] = None
+    """When the message was delivered. Null if not yet delivered."""
+
+    effect: Optional[SchemasMessageEffect] = None
+    """iMessage effect applied to a message (screen or bubble animation)"""
+
+    idempotency_key: Optional[str] = None
+    """Idempotency key for deduplication of outbound messages."""
+
+    preferred_service: Optional[Literal["iMessage", "SMS", "RCS", "auto"]] = None
+    """Preferred messaging service type.
+
+    Includes "auto" for default fallback behavior.
+    """
+
+    read_at: Optional[datetime] = None
+    """When the message was read. Null if not yet read."""
+
+    reply_to: Optional[ReplyTo] = None
+    """Reference to the message this is replying to (for threaded replies)"""
+
+    sent_at: Optional[datetime] = None
+    """When the message was sent. Null if not yet sent."""

linq/types/message_failed_webhook_event.py

@@ -0,0 +1,72 @@
+# 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 .webhook_event_type import WebhookEventType
+
+__all__ = ["MessageFailedWebhookEvent", "Data"]
+
+
+class Data(BaseModel):
+    """
+    Error details for message.failed webhook events.
+    See [WebhookErrorCode](#/components/schemas/WebhookErrorCode) for the full error code reference.
+    """
+
+    code: int
+    """Error codes in webhook failure events (3007, 4001)."""
+
+    failed_at: datetime
+    """When the failure was detected"""
+
+    chat_id: Optional[str] = None
+    """Chat identifier (UUID)"""
+
+    message_id: Optional[str] = None
+    """Message identifier (UUID)"""
+
+    reason: Optional[str] = None
+    """Human-readable description of the failure"""
+
+
+class MessageFailedWebhookEvent(BaseModel):
+    """Complete webhook payload for message.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 message.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/message_list_messages_thread_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 Literal, TypedDict
+
+__all__ = ["MessageListMessagesThreadParams"]
+
+
+class MessageListMessagesThreadParams(TypedDict, total=False):
+    cursor: str
+    """Pagination cursor from previous next_cursor response"""
+
+    limit: int
+    """Maximum number of messages to return"""
+
+    order: Literal["asc", "desc"]
+    """Sort order for messages (asc = oldest first, desc = newest first)"""

linq/types/message_read_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 .message_event_v2 import MessageEventV2
+from .webhook_event_type import WebhookEventType
+
+__all__ = ["MessageReadWebhookEvent"]
+
+
+class MessageReadWebhookEvent(BaseModel):
+    """Complete webhook payload for message.read events (2026-02-03 format)"""
+
+    api_version: str
+    """API version for the webhook payload format"""
+
+    created_at: datetime
+    """When the event was created"""
+
+    data: MessageEventV2
+    """Unified payload for message webhooks when using `webhook_version: "2026-02-03"`.
+
+    This schema is used for message.sent, message.received, message.delivered, and
+    message.read events when the subscription URL includes `?version=2026-02-03`.
+
+    Key differences from V1 (2025-01-01):
+
+    - `direction`: "inbound" or "outbound" instead of `is_from_me` boolean
+    - `sender_handle`: Full handle object for the sender
+    - `chat`: Nested object with `id`, `is_group`, and `owner_handle`
+    - Message fields (`id`, `parts`, `effect`, etc.) are at the top level, not
+      nested in `message`
+
+    Timestamps indicate the message state:
+
+    - `message.sent`: sent_at set, delivered_at=null, read_at=null
+    - `message.received`: sent_at set, delivered_at=null, read_at=null
+    - `message.delivered`: sent_at set, delivered_at set, read_at=null
+    - `message.read`: sent_at set, delivered_at set, read_at set
+    """
+
+    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/message_received_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 .message_event_v2 import MessageEventV2
+from .webhook_event_type import WebhookEventType
+
+__all__ = ["MessageReceivedWebhookEvent"]
+
+
+class MessageReceivedWebhookEvent(BaseModel):
+    """Complete webhook payload for message.received events (2026-02-03 format)"""
+
+    api_version: str
+    """API version for the webhook payload format"""
+
+    created_at: datetime
+    """When the event was created"""
+
+    data: MessageEventV2
+    """Unified payload for message webhooks when using `webhook_version: "2026-02-03"`.
+
+    This schema is used for message.sent, message.received, message.delivered, and
+    message.read events when the subscription URL includes `?version=2026-02-03`.
+
+    Key differences from V1 (2025-01-01):
+
+    - `direction`: "inbound" or "outbound" instead of `is_from_me` boolean
+    - `sender_handle`: Full handle object for the sender
+    - `chat`: Nested object with `id`, `is_group`, and `owner_handle`
+    - Message fields (`id`, `parts`, `effect`, etc.) are at the top level, not
+      nested in `message`
+
+    Timestamps indicate the message state:
+
+    - `message.sent`: sent_at set, delivered_at=null, read_at=null
+    - `message.received`: sent_at set, delivered_at=null, read_at=null
+    - `message.delivered`: sent_at set, delivered_at set, read_at=null
+    - `message.read`: sent_at set, delivered_at set, read_at set
+    """
+
+    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/message_sent_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 .message_event_v2 import MessageEventV2
+from .webhook_event_type import WebhookEventType
+
+__all__ = ["MessageSentWebhookEvent"]
+
+
+class MessageSentWebhookEvent(BaseModel):
+    """Complete webhook payload for message.sent events (2026-02-03 format)"""
+
+    api_version: str
+    """API version for the webhook payload format"""
+
+    created_at: datetime
+    """When the event was created"""
+
+    data: MessageEventV2
+    """Unified payload for message webhooks when using `webhook_version: "2026-02-03"`.
+
+    This schema is used for message.sent, message.received, message.delivered, and
+    message.read events when the subscription URL includes `?version=2026-02-03`.
+
+    Key differences from V1 (2025-01-01):
+
+    - `direction`: "inbound" or "outbound" instead of `is_from_me` boolean
+    - `sender_handle`: Full handle object for the sender
+    - `chat`: Nested object with `id`, `is_group`, and `owner_handle`
+    - Message fields (`id`, `parts`, `effect`, etc.) are at the top level, not
+      nested in `message`
+
+    Timestamps indicate the message state:
+
+    - `message.sent`: sent_at set, delivered_at=null, read_at=null
+    - `message.received`: sent_at set, delivered_at=null, read_at=null
+    - `message.delivered`: sent_at set, delivered_at set, read_at=null
+    - `message.read`: sent_at set, delivered_at set, read_at set
+    """
+
+    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/message_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 Required, TypedDict
+
+__all__ = ["MessageUpdateParams"]
+
+
+class MessageUpdateParams(TypedDict, total=False):
+    text: Required[str]
+    """New text content for the message part"""
+
+    part_index: int
+    """Index of the message part to edit. Defaults to 0."""

linq/types/participant_added_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__ = ["ParticipantAddedWebhookEvent", "Data"]
+
+
+class Data(BaseModel):
+    """Payload for participant.added webhook events"""
+
+    handle: str
+    """DEPRECATED: Use participant instead.
+
+    Handle (phone number or email address) of the added participant.
+    """
+
+    added_at: Optional[datetime] = None
+    """When the participant was added"""
+
+    chat_id: Optional[str] = None
+    """Chat identifier (UUID) of the group chat"""
+
+    participant: Optional[ChatHandle] = None
+    """The added participant as a full handle object"""
+
+
+class ParticipantAddedWebhookEvent(BaseModel):
+    """Complete webhook payload for participant.added events"""
+
+    api_version: str
+    """API version for the webhook payload format"""
+
+    created_at: datetime
+    """When the event was created"""
+
+    data: Data
+    """Payload for participant.added 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/participant_removed_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__ = ["ParticipantRemovedWebhookEvent", "Data"]
+
+
+class Data(BaseModel):
+    """Payload for participant.removed webhook events"""
+
+    handle: str
+    """DEPRECATED: Use participant instead.
+
+    Handle (phone number or email address) of the removed participant.
+    """
+
+    chat_id: Optional[str] = None
+    """Chat identifier (UUID) of the group chat"""
+
+    participant: Optional[ChatHandle] = None
+    """The removed participant as a full handle object"""
+
+    removed_at: Optional[datetime] = None
+    """When the participant was removed"""
+
+
+class ParticipantRemovedWebhookEvent(BaseModel):
+    """Complete webhook payload for participant.removed events"""
+
+    api_version: str
+    """API version for the webhook payload format"""
+
+    created_at: datetime
+    """When the event was created"""
+
+    data: Data
+    """Payload for participant.removed 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/phone_number_list_response.py

@@ -0,0 +1,20 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List
+
+from .._models import BaseModel
+
+__all__ = ["PhoneNumberListResponse", "PhoneNumber"]
+
+
+class PhoneNumber(BaseModel):
+    id: str
+    """Unique identifier for the phone number"""
+
+    phone_number: str
+    """Phone number in E.164 format"""
+
+
+class PhoneNumberListResponse(BaseModel):
+    phone_numbers: List[PhoneNumber]
+    """List of phone numbers assigned to the partner"""

linq/types/phone_number_status_updated_webhook_event.py

@@ -0,0 +1,82 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from datetime import datetime
+from typing_extensions import Literal
+
+from .._models import BaseModel
+
+__all__ = ["PhoneNumberStatusUpdatedWebhookEvent", "Data"]
+
+
+class Data(BaseModel):
+    """Payload for phone_number.status_updated webhook events"""
+
+    changed_at: datetime
+    """When the status change occurred"""
+
+    new_status: Literal["ACTIVE", "FLAGGED"]
+    """The new service status"""
+
+    phone_number: str
+    """Phone number in E.164 format"""
+
+    previous_status: Literal["ACTIVE", "FLAGGED"]
+    """The previous service status"""
+
+
+class PhoneNumberStatusUpdatedWebhookEvent(BaseModel):
+    """Complete webhook payload for phone_number.status_updated events"""
+
+    api_version: str
+    """API version for the webhook payload format"""
+
+    created_at: datetime
+    """When the event was created"""
+
+    data: Data
+    """Payload for phone_number.status_updated webhook events"""
+
+    event_id: str
+    """Unique identifier for this event (for deduplication)"""
+
+    event_type: Literal[
+        "message.sent",
+        "message.received",
+        "message.read",
+        "message.delivered",
+        "message.failed",
+        "message.edited",
+        "reaction.added",
+        "reaction.removed",
+        "participant.added",
+        "participant.removed",
+        "chat.created",
+        "chat.group_name_updated",
+        "chat.group_icon_updated",
+        "chat.group_name_update_failed",
+        "chat.group_icon_update_failed",
+        "chat.typing_indicator.started",
+        "chat.typing_indicator.stopped",
+        "phone_number.status_updated",
+        "call.initiated",
+        "call.ringing",
+        "call.answered",
+        "call.ended",
+        "call.failed",
+        "call.declined",
+        "call.no_answer",
+    ]
+    """The type of event"""
+
+    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.
+    """