linq-python 0.41.2__py3-none-any.whl → 0.42.0__py3-none-any.whl

linq/_client.py

@@ -1067,6 +1067,12 @@ class LinqAPIV3(SyncAPIClient):
 
         return WebhookSubscriptionsResource(self)
 
+    @cached_property
+    def webhooks(self) -> WebhooksResource:
+        from .resources.webhooks import WebhooksResource
+
+        return WebhooksResource(self)
+
     @cached_property
     def capability(self) -> CapabilityResource:
         """
@@ -1076,12 +1082,6 @@ class LinqAPIV3(SyncAPIClient):
 
         return CapabilityResource(self)
 
-    @cached_property
-    def webhooks(self) -> WebhooksResource:
-        from .resources.webhooks import WebhooksResource
-
-        return WebhooksResource(self)
-
     @cached_property
     def contact_card(self) -> ContactCardResource:
         """
@@ -2202,6 +2202,12 @@ class AsyncLinqAPIV3(AsyncAPIClient):
 
         return AsyncWebhookSubscriptionsResource(self)
 
+    @cached_property
+    def webhooks(self) -> AsyncWebhooksResource:
+        from .resources.webhooks import AsyncWebhooksResource
+
+        return AsyncWebhooksResource(self)
+
     @cached_property
     def capability(self) -> AsyncCapabilityResource:
         """
@@ -2211,12 +2217,6 @@ class AsyncLinqAPIV3(AsyncAPIClient):
 
         return AsyncCapabilityResource(self)
 
-    @cached_property
-    def webhooks(self) -> AsyncWebhooksResource:
-        from .resources.webhooks import AsyncWebhooksResource
-
-        return AsyncWebhooksResource(self)
-
     @cached_property
     def contact_card(self) -> AsyncContactCardResource:
         """

linq/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "linq"
-__version__ = "0.41.2"  # x-release-please-version
+__version__ = "0.42.0"  # x-release-please-version

linq/resources/__init__.py

@@ -215,14 +215,14 @@ __all__ = [
     "AsyncWebhookSubscriptionsResourceWithRawResponse",
     "WebhookSubscriptionsResourceWithStreamingResponse",
     "AsyncWebhookSubscriptionsResourceWithStreamingResponse",
+    "WebhooksResource",
+    "AsyncWebhooksResource",
     "CapabilityResource",
     "AsyncCapabilityResource",
     "CapabilityResourceWithRawResponse",
     "AsyncCapabilityResourceWithRawResponse",
     "CapabilityResourceWithStreamingResponse",
     "AsyncCapabilityResourceWithStreamingResponse",
-    "WebhooksResource",
-    "AsyncWebhooksResource",
     "ContactCardResource",
     "AsyncContactCardResource",
     "ContactCardResourceWithRawResponse",

linq/types/__init__.py

@@ -94,19 +94,26 @@ from .reaction_added_webhook_event import ReactionAddedWebhookEvent as ReactionA
 from .blocked_handle_block_response import BlockedHandleBlockResponse as BlockedHandleBlockResponse
 from .blocked_handle_unblock_params import BlockedHandleUnblockParams as BlockedHandleUnblockParams
 from .message_add_reaction_response import MessageAddReactionResponse as MessageAddReactionResponse
+from .payment_expired_webhook_event import PaymentExpiredWebhookEvent as PaymentExpiredWebhookEvent
 from .payment_request_create_params import PaymentRequestCreateParams as PaymentRequestCreateParams
 from .payment_request_list_response import PaymentRequestListResponse as PaymentRequestListResponse
 from .poll_vote_added_webhook_event import PollVoteAddedWebhookEvent as PollVoteAddedWebhookEvent
 from .contact_card_retrieve_response import ContactCardRetrieveResponse as ContactCardRetrieveResponse
 from .message_received_webhook_event import MessageReceivedWebhookEvent as MessageReceivedWebhookEvent
 from .message_update_app_card_params import MessageUpdateAppCardParams as MessageUpdateAppCardParams
+from .payment_canceled_webhook_event import PaymentCanceledWebhookEvent as PaymentCanceledWebhookEvent
+from .payment_declined_webhook_event import PaymentDeclinedWebhookEvent as PaymentDeclinedWebhookEvent
 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 .payment_provider_connect_params import PaymentProviderConnectParams as PaymentProviderConnectParams
+from .payment_succeeded_webhook_event import PaymentSucceededWebhookEvent as PaymentSucceededWebhookEvent
 from .poll_vote_removed_webhook_event import PollVoteRemovedWebhookEvent as PollVoteRemovedWebhookEvent
 from .available_number_retrieve_params import AvailableNumberRetrieveParams as AvailableNumberRetrieveParams
+from .connection_created_webhook_event import ConnectionCreatedWebhookEvent as ConnectionCreatedWebhookEvent
+from .connection_revoked_webhook_event import ConnectionRevokedWebhookEvent as ConnectionRevokedWebhookEvent
 from .message_update_app_card_response import MessageUpdateAppCardResponse as MessageUpdateAppCardResponse
+from .payment_authorized_webhook_event import PaymentAuthorizedWebhookEvent as PaymentAuthorizedWebhookEvent
 from .capability_check_i_message_params import CapabilityCheckIMessageParams as CapabilityCheckIMessageParams
 from .participant_removed_webhook_event import ParticipantRemovedWebhookEvent as ParticipantRemovedWebhookEvent
 from .payment_provider_connect_response import PaymentProviderConnectResponse as PaymentProviderConnectResponse
@@ -123,6 +130,12 @@ from .chat_background_updated_webhook_event import (
 )
 from .chat_group_icon_updated_webhook_event import ChatGroupIconUpdatedWebhookEvent as ChatGroupIconUpdatedWebhookEvent
 from .chat_group_name_updated_webhook_event import ChatGroupNameUpdatedWebhookEvent as ChatGroupNameUpdatedWebhookEvent
+from .location_sharing_started_webhook_event import (
+    LocationSharingStartedWebhookEvent as LocationSharingStartedWebhookEvent,
+)
+from .location_sharing_stopped_webhook_event import (
+    LocationSharingStoppedWebhookEvent as LocationSharingStoppedWebhookEvent,
+)
 from .phone_number_status_updated_webhook_event import (
     PhoneNumberStatusUpdatedWebhookEvent as PhoneNumberStatusUpdatedWebhookEvent,
 )

linq/types/connection_created_webhook_event.py

@@ -0,0 +1,212 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Dict, Optional
+from datetime import datetime
+from typing_extensions import Literal
+
+from .._models import BaseModel
+
+__all__ = ["ConnectionCreatedWebhookEvent", "Data", "DataDiscount", "DataNatural", "DataStripe"]
+
+
+class DataDiscount(BaseModel):
+    """Subscription mode — the discount Stripe applied, read back
+    from the coupon.
+
+    Absent when none was applied.
+    """
+
+    coupon: Optional[str] = None
+
+    label: Optional[str] = None
+    """Name of the coupon/promo code displayed to customers."""
+
+    promotion_code: Optional[str] = None
+
+
+class DataNatural(BaseModel):
+    """Natural-rail join keys, present when `rail: natural`."""
+
+    payment_request_id: Optional[str] = None
+    """The Natural payment request (`prq_...`)."""
+
+    transaction_id: Optional[str] = None
+    """The settled transaction (`txn_...`)."""
+
+
+class DataStripe(BaseModel):
+    """
+    Ids of the Stripe objects on your connected account — join
+    keys into your own Stripe Dashboard/API. Manage a
+    subscription's post-checkout lifecycle with `subscription_id`.
+    """
+
+    customer_id: Optional[str] = None
+    """
+    The Customer the request is attached to (`cus_...`). Always set in subscription
+    mode; set in payment mode only when the request was created with a
+    `customer_id`.
+    """
+
+    payment_intent_id: Optional[str] = None
+    """The PaymentIntent collected at checkout (`pi_...`)."""
+
+    subscription_id: Optional[str] = None
+    """Subscription mode — the Subscription (`sub_...`)."""
+
+
+class Data(BaseModel):
+    """
+    The payment request, as returned by
+    `GET /v3/payment_requests/{paymentRequestId}`.
+    """
+
+    id: str
+    """The payment request id."""
+
+    amount: int
+    """What was charged at checkout, in the currency's minor units.
+
+    In `subscription` mode this is the first invoice's total — all items after any
+    discounts are applied.
+    """
+
+    checkout_url: str
+    """
+    URL the recipient opens to pay
+    (`https://zero.linqapp.com/pay/{slug}?session=...`).
+    """
+
+    created_at: datetime
+
+    currency: str
+
+    object: str
+
+    status: Literal["succeeded", "failed", "canceled", "expired"]
+
+    description: Optional[str] = None
+
+    discount: Optional[DataDiscount] = None
+    """Subscription mode — the discount Stripe applied, read back from the coupon.
+
+    Absent when none was applied.
+    """
+
+    interval: Optional[Literal["day", "week", "month", "year"]] = None
+    """Subscription mode — how often the subscription renews."""
+
+    interval_count: Optional[int] = None
+    """Subscription mode — intervals per renewal."""
+
+    metadata: Optional[Dict[str, str]] = None
+
+    mode: Optional[Literal["payment", "subscription"]] = None
+    """Whether the request collected a one-time charge or started a subscription."""
+
+    natural: Optional[DataNatural] = None
+    """Natural-rail join keys, present when `rail: natural`."""
+
+    price_id: Optional[str] = None
+    """Subscription mode — the recurring price subscribed to."""
+
+    quantity: Optional[int] = None
+    """Subscription mode — units of the price subscribed to."""
+
+    rail: Optional[Literal["stripe", "natural"]] = None
+    """The rail this request settled on."""
+
+    stripe: Optional[DataStripe] = None
+    """
+    Ids of the Stripe objects on your connected account — join keys into your own
+    Stripe Dashboard/API. Manage a subscription's post-checkout lifecycle with
+    `subscription_id`.
+    """
+
+    trial_end: Optional[datetime] = None
+    """Subscription mode — when the free trial ends and the first charge happens.
+
+    On a trial request, `payment.succeeded` means the payment method was collected
+    ($0 moved).
+    """
+
+    updated_at: Optional[datetime] = None
+
+
+class ConnectionCreatedWebhookEvent(BaseModel):
+    api_version: str
+    """API version for the webhook payload format"""
+
+    created_at: datetime
+    """When the event was created"""
+
+    data: Data
+    """
+    The payment request, as returned by
+    `GET /v3/payment_requests/{paymentRequestId}`.
+    """
+
+    event_id: str
+    """Unique identifier for this event (for deduplication)"""
+
+    event_type: Literal[
+        "payment.succeeded",
+        "payment.canceled",
+        "payment.expired",
+        "message.sent",
+        "message.received",
+        "message.read",
+        "message.delivered",
+        "message.failed",
+        "message.edited",
+        "reaction.added",
+        "reaction.removed",
+        "poll.received",
+        "poll.failed",
+        "poll.sent",
+        "poll.delivered",
+        "poll.read",
+        "poll.updated",
+        "poll.vote.added",
+        "poll.vote.removed",
+        "poll.reaction.added",
+        "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.background_updated",
+        "chat.background_update_failed",
+        "chat.typing_indicator.started",
+        "chat.typing_indicator.stopped",
+        "phone_number.status_updated",
+        "contact_card.received",
+        "call.initiated",
+        "call.ringing",
+        "call.answered",
+        "call.ended",
+        "call.failed",
+        "call.declined",
+        "call.no_answer",
+        "location.sharing.started",
+        "location.sharing.stopped",
+        "payment.declined",
+        "payment.authorized",
+        "connection.created",
+        "connection.revoked",
+    ]
+
+    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/connection_revoked_webhook_event.py

@@ -0,0 +1,212 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Dict, Optional
+from datetime import datetime
+from typing_extensions import Literal
+
+from .._models import BaseModel
+
+__all__ = ["ConnectionRevokedWebhookEvent", "Data", "DataDiscount", "DataNatural", "DataStripe"]
+
+
+class DataDiscount(BaseModel):
+    """Subscription mode — the discount Stripe applied, read back
+    from the coupon.
+
+    Absent when none was applied.
+    """
+
+    coupon: Optional[str] = None
+
+    label: Optional[str] = None
+    """Name of the coupon/promo code displayed to customers."""
+
+    promotion_code: Optional[str] = None
+
+
+class DataNatural(BaseModel):
+    """Natural-rail join keys, present when `rail: natural`."""
+
+    payment_request_id: Optional[str] = None
+    """The Natural payment request (`prq_...`)."""
+
+    transaction_id: Optional[str] = None
+    """The settled transaction (`txn_...`)."""
+
+
+class DataStripe(BaseModel):
+    """
+    Ids of the Stripe objects on your connected account — join
+    keys into your own Stripe Dashboard/API. Manage a
+    subscription's post-checkout lifecycle with `subscription_id`.
+    """
+
+    customer_id: Optional[str] = None
+    """
+    The Customer the request is attached to (`cus_...`). Always set in subscription
+    mode; set in payment mode only when the request was created with a
+    `customer_id`.
+    """
+
+    payment_intent_id: Optional[str] = None
+    """The PaymentIntent collected at checkout (`pi_...`)."""
+
+    subscription_id: Optional[str] = None
+    """Subscription mode — the Subscription (`sub_...`)."""
+
+
+class Data(BaseModel):
+    """
+    The payment request, as returned by
+    `GET /v3/payment_requests/{paymentRequestId}`.
+    """
+
+    id: str
+    """The payment request id."""
+
+    amount: int
+    """What was charged at checkout, in the currency's minor units.
+
+    In `subscription` mode this is the first invoice's total — all items after any
+    discounts are applied.
+    """
+
+    checkout_url: str
+    """
+    URL the recipient opens to pay
+    (`https://zero.linqapp.com/pay/{slug}?session=...`).
+    """
+
+    created_at: datetime
+
+    currency: str
+
+    object: str
+
+    status: Literal["succeeded", "failed", "canceled", "expired"]
+
+    description: Optional[str] = None
+
+    discount: Optional[DataDiscount] = None
+    """Subscription mode — the discount Stripe applied, read back from the coupon.
+
+    Absent when none was applied.
+    """
+
+    interval: Optional[Literal["day", "week", "month", "year"]] = None
+    """Subscription mode — how often the subscription renews."""
+
+    interval_count: Optional[int] = None
+    """Subscription mode — intervals per renewal."""
+
+    metadata: Optional[Dict[str, str]] = None
+
+    mode: Optional[Literal["payment", "subscription"]] = None
+    """Whether the request collected a one-time charge or started a subscription."""
+
+    natural: Optional[DataNatural] = None
+    """Natural-rail join keys, present when `rail: natural`."""
+
+    price_id: Optional[str] = None
+    """Subscription mode — the recurring price subscribed to."""
+
+    quantity: Optional[int] = None
+    """Subscription mode — units of the price subscribed to."""
+
+    rail: Optional[Literal["stripe", "natural"]] = None
+    """The rail this request settled on."""
+
+    stripe: Optional[DataStripe] = None
+    """
+    Ids of the Stripe objects on your connected account — join keys into your own
+    Stripe Dashboard/API. Manage a subscription's post-checkout lifecycle with
+    `subscription_id`.
+    """
+
+    trial_end: Optional[datetime] = None
+    """Subscription mode — when the free trial ends and the first charge happens.
+
+    On a trial request, `payment.succeeded` means the payment method was collected
+    ($0 moved).
+    """
+
+    updated_at: Optional[datetime] = None
+
+
+class ConnectionRevokedWebhookEvent(BaseModel):
+    api_version: str
+    """API version for the webhook payload format"""
+
+    created_at: datetime
+    """When the event was created"""
+
+    data: Data
+    """
+    The payment request, as returned by
+    `GET /v3/payment_requests/{paymentRequestId}`.
+    """
+
+    event_id: str
+    """Unique identifier for this event (for deduplication)"""
+
+    event_type: Literal[
+        "payment.succeeded",
+        "payment.canceled",
+        "payment.expired",
+        "message.sent",
+        "message.received",
+        "message.read",
+        "message.delivered",
+        "message.failed",
+        "message.edited",
+        "reaction.added",
+        "reaction.removed",
+        "poll.received",
+        "poll.failed",
+        "poll.sent",
+        "poll.delivered",
+        "poll.read",
+        "poll.updated",
+        "poll.vote.added",
+        "poll.vote.removed",
+        "poll.reaction.added",
+        "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.background_updated",
+        "chat.background_update_failed",
+        "chat.typing_indicator.started",
+        "chat.typing_indicator.stopped",
+        "phone_number.status_updated",
+        "contact_card.received",
+        "call.initiated",
+        "call.ringing",
+        "call.answered",
+        "call.ended",
+        "call.failed",
+        "call.declined",
+        "call.no_answer",
+        "location.sharing.started",
+        "location.sharing.stopped",
+        "payment.declined",
+        "payment.authorized",
+        "connection.created",
+        "connection.revoked",
+    ]
+
+    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/location_sharing_started_webhook_event.py

@@ -0,0 +1,111 @@
+# 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
+
+__all__ = ["LocationSharingStartedWebhookEvent", "Data"]
+
+
+class Data(BaseModel):
+    began_at: Optional[datetime] = None
+    """When location sharing started.
+
+    Always present: falls back to when the share was first observed if the device
+    reported no start time.
+    """
+
+    chat_id: Optional[str] = None
+    """The chat this share was first sent to.
+
+    Location sharing is per-contact rather than per-chat, so the location may also
+    be visible in other chats with the same handle; this identifies where the share
+    originated and does not change if the contact later shares into another chat.
+    Null when the originating chat could not be determined.
+    """
+
+    ends_at: Optional[datetime] = None
+    """When location sharing will expire. Null when sharing indefinitely."""
+
+    shared_by: str
+    """Phone number of the person sharing their location"""
+
+    shared_with: str
+    """Your phone number receiving the location"""
+
+
+class LocationSharingStartedWebhookEvent(BaseModel):
+    api_version: str
+    """API version for the webhook payload format"""
+
+    created_at: datetime
+    """When the event was created"""
+
+    data: Data
+
+    event_id: str
+    """Unique identifier for this event (for deduplication)"""
+
+    event_type: Literal[
+        "location.sharing.started",
+        "message.sent",
+        "message.received",
+        "message.read",
+        "message.delivered",
+        "message.failed",
+        "message.edited",
+        "reaction.added",
+        "reaction.removed",
+        "poll.received",
+        "poll.failed",
+        "poll.sent",
+        "poll.delivered",
+        "poll.read",
+        "poll.updated",
+        "poll.vote.added",
+        "poll.vote.removed",
+        "poll.reaction.added",
+        "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.background_updated",
+        "chat.background_update_failed",
+        "chat.typing_indicator.started",
+        "chat.typing_indicator.stopped",
+        "phone_number.status_updated",
+        "contact_card.received",
+        "call.initiated",
+        "call.ringing",
+        "call.answered",
+        "call.ended",
+        "call.failed",
+        "call.declined",
+        "call.no_answer",
+        "location.sharing.stopped",
+        "payment.succeeded",
+        "payment.canceled",
+        "payment.expired",
+        "payment.declined",
+        "payment.authorized",
+        "connection.created",
+        "connection.revoked",
+    ]
+
+    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.
+    """