aiinbx 0.4.0__tar.gz → 0.5.0__tar.gz

aiinbx-0.5.0/.release-please-manifest.json

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

{aiinbx-0.4.0 → aiinbx-0.5.0}/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.5.0 (2025-10-15)
+
+Full Changelog: [v0.4.0...v0.5.0](https://github.com/aiinbx/aiinbx-py/compare/v0.4.0...v0.5.0)
+
+### Features
+
+* **api:** manual updates ([ddacc81](https://github.com/aiinbx/aiinbx-py/commit/ddacc8158fd4079c1ee4b8ae04f89f22e2fcd46a))
+
+
+### Chores
+
+* **internal:** detect missing future annotations with ruff ([6f6a3da](https://github.com/aiinbx/aiinbx-py/commit/6f6a3da5978b34e1a2959b38715d4311474f1c5e))
+
 ## 0.4.0 (2025-10-05)
 
 Full Changelog: [v0.3.0...v0.4.0](https://github.com/aiinbx/aiinbx-py/compare/v0.3.0...v0.4.0)

{aiinbx-0.4.0 → aiinbx-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: aiinbx
-Version: 0.4.0
+Version: 0.5.0
 Summary: The official Python library for the AIInbx API
 Project-URL: Homepage, https://github.com/aiinbx/aiinbx-py
 Project-URL: Repository, https://github.com/aiinbx/aiinbx-py

{aiinbx-0.4.0 → aiinbx-0.5.0}/api.md

@@ -47,3 +47,32 @@ Methods:
 - <code title="get /domains">client.domains.<a href="./src/aiinbx/resources/domains.py">list</a>() -> <a href="./src/aiinbx/types/domain_list_response.py">DomainListResponse</a></code>
 - <code title="delete /domains/{domainId}">client.domains.<a href="./src/aiinbx/resources/domains.py">delete</a>(domain_id) -> <a href="./src/aiinbx/types/domain_delete_response.py">DomainDeleteResponse</a></code>
 - <code title="post /domains/{domainId}/verify">client.domains.<a href="./src/aiinbx/resources/domains.py">verify</a>(domain_id) -> <a href="./src/aiinbx/types/domain_verify_response.py">DomainVerifyResponse</a></code>
+
+# Webhooks
+
+Types:
+
+```python
+from aiinbx.types import (
+    InboundEmailReceivedWebhookEvent,
+    OutboundEmailDeliveredWebhookEvent,
+    OutboundEmailBouncedWebhookEvent,
+    OutboundEmailComplainedWebhookEvent,
+    OutboundEmailRejectedWebhookEvent,
+    OutboundEmailOpenedWebhookEvent,
+    OutboundEmailClickedWebhookEvent,
+    UnwrapWebhookEvent,
+)
+```
+
+# Meta
+
+Types:
+
+```python
+from aiinbx.types import MetaWebhooksSchemaResponse
+```
+
+Methods:
+
+- <code title="get /_meta/webhooks">client.meta.<a href="./src/aiinbx/resources/meta.py">webhooks_schema</a>() -> <a href="./src/aiinbx/types/meta_webhooks_schema_response.py">MetaWebhooksSchemaResponse</a></code>

{aiinbx-0.4.0 → aiinbx-0.5.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "aiinbx"
-version = "0.4.0"
+version = "0.5.0"
 description = "The official Python library for the AIInbx API"
 dynamic = ["readme"]
 license = "Apache-2.0"
@@ -224,6 +224,8 @@ select = [
   "B",
   # remove unused imports
   "F401",
+  # check for missing future annotations
+  "FA102",
   # bare except statements
   "E722",
   # unused arguments
@@ -246,6 +248,8 @@ unfixable = [
   "T203",
 ]
 
+extend-safe-fixes = ["FA102"]
+
 [tool.ruff.lint.flake8-tidy-imports.banned-api]
 "functools.lru_cache".msg = "This function does not retain type information for the wrapped function's arguments; The `lru_cache` function from `_utils` should be used instead"
 

{aiinbx-0.4.0 → aiinbx-0.5.0}/src/aiinbx/_client.py

@@ -21,7 +21,7 @@ from ._types import (
 )
 from ._utils import is_given, get_async_library
 from ._version import __version__
-from .resources import emails, domains, threads
+from .resources import meta, emails, domains, threads, webhooks
 from ._streaming import Stream as Stream, AsyncStream as AsyncStream
 from ._exceptions import AIInbxError, APIStatusError
 from ._base_client import (
@@ -37,6 +37,8 @@ class AIInbx(SyncAPIClient):
     threads: threads.ThreadsResource
     emails: emails.EmailsResource
     domains: domains.DomainsResource
+    webhooks: webhooks.WebhooksResource
+    meta: meta.MetaResource
     with_raw_response: AIInbxWithRawResponse
     with_streaming_response: AIInbxWithStreamedResponse
 
@@ -97,6 +99,8 @@ class AIInbx(SyncAPIClient):
         self.threads = threads.ThreadsResource(self)
         self.emails = emails.EmailsResource(self)
         self.domains = domains.DomainsResource(self)
+        self.webhooks = webhooks.WebhooksResource(self)
+        self.meta = meta.MetaResource(self)
         self.with_raw_response = AIInbxWithRawResponse(self)
         self.with_streaming_response = AIInbxWithStreamedResponse(self)
 
@@ -209,6 +213,8 @@ class AsyncAIInbx(AsyncAPIClient):
     threads: threads.AsyncThreadsResource
     emails: emails.AsyncEmailsResource
     domains: domains.AsyncDomainsResource
+    webhooks: webhooks.AsyncWebhooksResource
+    meta: meta.AsyncMetaResource
     with_raw_response: AsyncAIInbxWithRawResponse
     with_streaming_response: AsyncAIInbxWithStreamedResponse
 
@@ -269,6 +275,8 @@ class AsyncAIInbx(AsyncAPIClient):
         self.threads = threads.AsyncThreadsResource(self)
         self.emails = emails.AsyncEmailsResource(self)
         self.domains = domains.AsyncDomainsResource(self)
+        self.webhooks = webhooks.AsyncWebhooksResource(self)
+        self.meta = meta.AsyncMetaResource(self)
         self.with_raw_response = AsyncAIInbxWithRawResponse(self)
         self.with_streaming_response = AsyncAIInbxWithStreamedResponse(self)
 
@@ -382,6 +390,7 @@ class AIInbxWithRawResponse:
         self.threads = threads.ThreadsResourceWithRawResponse(client.threads)
         self.emails = emails.EmailsResourceWithRawResponse(client.emails)
         self.domains = domains.DomainsResourceWithRawResponse(client.domains)
+        self.meta = meta.MetaResourceWithRawResponse(client.meta)
 
 
 class AsyncAIInbxWithRawResponse:
@@ -389,6 +398,7 @@ class AsyncAIInbxWithRawResponse:
         self.threads = threads.AsyncThreadsResourceWithRawResponse(client.threads)
         self.emails = emails.AsyncEmailsResourceWithRawResponse(client.emails)
         self.domains = domains.AsyncDomainsResourceWithRawResponse(client.domains)
+        self.meta = meta.AsyncMetaResourceWithRawResponse(client.meta)
 
 
 class AIInbxWithStreamedResponse:
@@ -396,6 +406,7 @@ class AIInbxWithStreamedResponse:
         self.threads = threads.ThreadsResourceWithStreamingResponse(client.threads)
         self.emails = emails.EmailsResourceWithStreamingResponse(client.emails)
         self.domains = domains.DomainsResourceWithStreamingResponse(client.domains)
+        self.meta = meta.MetaResourceWithStreamingResponse(client.meta)
 
 
 class AsyncAIInbxWithStreamedResponse:
@@ -403,6 +414,7 @@ class AsyncAIInbxWithStreamedResponse:
         self.threads = threads.AsyncThreadsResourceWithStreamingResponse(client.threads)
         self.emails = emails.AsyncEmailsResourceWithStreamingResponse(client.emails)
         self.domains = domains.AsyncDomainsResourceWithStreamingResponse(client.domains)
+        self.meta = meta.AsyncMetaResourceWithStreamingResponse(client.meta)
 
 
 Client = AIInbx

{aiinbx-0.4.0 → aiinbx-0.5.0}/src/aiinbx/_version.py

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

{aiinbx-0.4.0 → aiinbx-0.5.0}/src/aiinbx/resources/__init__.py

@@ -1,5 +1,13 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+from .meta import (
+    MetaResource,
+    AsyncMetaResource,
+    MetaResourceWithRawResponse,
+    AsyncMetaResourceWithRawResponse,
+    MetaResourceWithStreamingResponse,
+    AsyncMetaResourceWithStreamingResponse,
+)
 from .emails import (
     EmailsResource,
     AsyncEmailsResource,
@@ -24,6 +32,7 @@ from .threads import (
     ThreadsResourceWithStreamingResponse,
     AsyncThreadsResourceWithStreamingResponse,
 )
+from .webhooks import WebhooksResource, AsyncWebhooksResource
 
 __all__ = [
     "ThreadsResource",
@@ -44,4 +53,12 @@ __all__ = [
     "AsyncDomainsResourceWithRawResponse",
     "DomainsResourceWithStreamingResponse",
     "AsyncDomainsResourceWithStreamingResponse",
+    "WebhooksResource",
+    "AsyncWebhooksResource",
+    "MetaResource",
+    "AsyncMetaResource",
+    "MetaResourceWithRawResponse",
+    "AsyncMetaResourceWithRawResponse",
+    "MetaResourceWithStreamingResponse",
+    "AsyncMetaResourceWithStreamingResponse",
 ]

aiinbx-0.5.0/src/aiinbx/resources/meta.py

@@ -0,0 +1,147 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Any, cast
+
+import httpx
+
+from .._types import Body, Query, Headers, NotGiven, not_given
+from .._compat import cached_property
+from .._resource import SyncAPIResource, AsyncAPIResource
+from .._response import (
+    to_raw_response_wrapper,
+    to_streamed_response_wrapper,
+    async_to_raw_response_wrapper,
+    async_to_streamed_response_wrapper,
+)
+from .._base_client import make_request_options
+from ..types.meta_webhooks_schema_response import MetaWebhooksSchemaResponse
+
+__all__ = ["MetaResource", "AsyncMetaResource"]
+
+
+class MetaResource(SyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> MetaResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/aiinbx/aiinbx-py#accessing-raw-response-data-eg-headers
+        """
+        return MetaResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> MetaResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/aiinbx/aiinbx-py#with_streaming_response
+        """
+        return MetaResourceWithStreamingResponse(self)
+
+    def webhooks_schema(
+        self,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> MetaWebhooksSchemaResponse:
+        """Internal endpoint to expose webhook event schemas to SDK generators."""
+        return cast(
+            MetaWebhooksSchemaResponse,
+            self._get(
+                "/_meta/webhooks",
+                options=make_request_options(
+                    extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+                ),
+                cast_to=cast(
+                    Any, MetaWebhooksSchemaResponse
+                ),  # Union types cannot be passed in as arguments in the type system
+            ),
+        )
+
+
+class AsyncMetaResource(AsyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> AsyncMetaResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/aiinbx/aiinbx-py#accessing-raw-response-data-eg-headers
+        """
+        return AsyncMetaResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> AsyncMetaResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/aiinbx/aiinbx-py#with_streaming_response
+        """
+        return AsyncMetaResourceWithStreamingResponse(self)
+
+    async def webhooks_schema(
+        self,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> MetaWebhooksSchemaResponse:
+        """Internal endpoint to expose webhook event schemas to SDK generators."""
+        return cast(
+            MetaWebhooksSchemaResponse,
+            await self._get(
+                "/_meta/webhooks",
+                options=make_request_options(
+                    extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+                ),
+                cast_to=cast(
+                    Any, MetaWebhooksSchemaResponse
+                ),  # Union types cannot be passed in as arguments in the type system
+            ),
+        )
+
+
+class MetaResourceWithRawResponse:
+    def __init__(self, meta: MetaResource) -> None:
+        self._meta = meta
+
+        self.webhooks_schema = to_raw_response_wrapper(
+            meta.webhooks_schema,
+        )
+
+
+class AsyncMetaResourceWithRawResponse:
+    def __init__(self, meta: AsyncMetaResource) -> None:
+        self._meta = meta
+
+        self.webhooks_schema = async_to_raw_response_wrapper(
+            meta.webhooks_schema,
+        )
+
+
+class MetaResourceWithStreamingResponse:
+    def __init__(self, meta: MetaResource) -> None:
+        self._meta = meta
+
+        self.webhooks_schema = to_streamed_response_wrapper(
+            meta.webhooks_schema,
+        )
+
+
+class AsyncMetaResourceWithStreamingResponse:
+    def __init__(self, meta: AsyncMetaResource) -> None:
+        self._meta = meta
+
+        self.webhooks_schema = async_to_streamed_response_wrapper(
+            meta.webhooks_schema,
+        )

aiinbx-0.5.0/src/aiinbx/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.unwrap_webhook_event import UnwrapWebhookEvent
+
+__all__ = ["WebhooksResource", "AsyncWebhooksResource"]
+
+
+class WebhooksResource(SyncAPIResource):
+    def unwrap(self, payload: str) -> UnwrapWebhookEvent:
+        return cast(
+            UnwrapWebhookEvent,
+            construct_type(
+                type_=UnwrapWebhookEvent,
+                value=json.loads(payload),
+            ),
+        )
+
+
+class AsyncWebhooksResource(AsyncAPIResource):
+    def unwrap(self, payload: str) -> UnwrapWebhookEvent:
+        return cast(
+            UnwrapWebhookEvent,
+            construct_type(
+                type_=UnwrapWebhookEvent,
+                value=json.loads(payload),
+            ),
+        )

{aiinbx-0.4.0 → aiinbx-0.5.0}/src/aiinbx/types/__init__.py

@@ -9,6 +9,7 @@ from .domain_create_params import DomainCreateParams as DomainCreateParams
 from .domain_list_response import DomainListResponse as DomainListResponse
 from .email_reply_response import EmailReplyResponse as EmailReplyResponse
 from .thread_search_params import ThreadSearchParams as ThreadSearchParams
+from .unwrap_webhook_event import UnwrapWebhookEvent as UnwrapWebhookEvent
 from .thread_forward_params import ThreadForwardParams as ThreadForwardParams
 from .domain_create_response import DomainCreateResponse as DomainCreateResponse
 from .domain_delete_response import DomainDeleteResponse as DomainDeleteResponse
@@ -18,3 +19,17 @@ from .email_retrieve_response import EmailRetrieveResponse as EmailRetrieveRespo
 from .thread_forward_response import ThreadForwardResponse as ThreadForwardResponse
 from .domain_retrieve_response import DomainRetrieveResponse as DomainRetrieveResponse
 from .thread_retrieve_response import ThreadRetrieveResponse as ThreadRetrieveResponse
+from .meta_webhooks_schema_response import MetaWebhooksSchemaResponse as MetaWebhooksSchemaResponse
+from .outbound_email_opened_webhook_event import OutboundEmailOpenedWebhookEvent as OutboundEmailOpenedWebhookEvent
+from .inbound_email_received_webhook_event import InboundEmailReceivedWebhookEvent as InboundEmailReceivedWebhookEvent
+from .outbound_email_bounced_webhook_event import OutboundEmailBouncedWebhookEvent as OutboundEmailBouncedWebhookEvent
+from .outbound_email_clicked_webhook_event import OutboundEmailClickedWebhookEvent as OutboundEmailClickedWebhookEvent
+from .outbound_email_rejected_webhook_event import (
+    OutboundEmailRejectedWebhookEvent as OutboundEmailRejectedWebhookEvent,
+)
+from .outbound_email_delivered_webhook_event import (
+    OutboundEmailDeliveredWebhookEvent as OutboundEmailDeliveredWebhookEvent,
+)
+from .outbound_email_complained_webhook_event import (
+    OutboundEmailComplainedWebhookEvent as OutboundEmailComplainedWebhookEvent,
+)

aiinbx-0.5.0/src/aiinbx/types/inbound_email_received_webhook_event.py

@@ -0,0 +1,113 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+from datetime import datetime
+from typing_extensions import Literal
+
+from pydantic import Field as FieldInfo
+
+from .._models import BaseModel
+
+__all__ = ["InboundEmailReceivedWebhookEvent", "Data", "DataEmail", "DataEmailAttachment", "DataOrganization"]
+
+
+class DataEmailAttachment(BaseModel):
+    id: str
+
+    content_type: str = FieldInfo(alias="contentType")
+
+    created_at: datetime = FieldInfo(alias="createdAt")
+
+    expires_at: datetime = FieldInfo(alias="expiresAt")
+
+    file_name: str = FieldInfo(alias="fileName")
+
+    signed_url: str = FieldInfo(alias="signedUrl")
+
+    size_in_bytes: float = FieldInfo(alias="sizeInBytes")
+
+    cid: Optional[str] = None
+
+    disposition: Optional[str] = None
+
+
+class DataEmail(BaseModel):
+    id: str
+
+    attachments: List[DataEmailAttachment]
+
+    bcc_addresses: List[str] = FieldInfo(alias="bccAddresses")
+
+    cc_addresses: List[str] = FieldInfo(alias="ccAddresses")
+
+    created_at: datetime = FieldInfo(alias="createdAt")
+
+    direction: Literal["INBOUND", "OUTBOUND"]
+
+    from_address: str = FieldInfo(alias="fromAddress")
+
+    message_id: str = FieldInfo(alias="messageId")
+
+    references: List[str]
+
+    reply_to_addresses: List[str] = FieldInfo(alias="replyToAddresses")
+
+    status: Literal[
+        "DRAFT",
+        "QUEUED",
+        "ACCEPTED",
+        "SENT",
+        "RECEIVED",
+        "FAILED",
+        "BOUNCED",
+        "COMPLAINED",
+        "REJECTED",
+        "READ",
+        "ARCHIVED",
+    ]
+
+    thread_id: str = FieldInfo(alias="threadId")
+
+    to_addresses: List[str] = FieldInfo(alias="toAddresses")
+
+    from_name: Optional[str] = FieldInfo(alias="fromName", default=None)
+
+    html: Optional[str] = None
+
+    in_reply_to_id: Optional[str] = FieldInfo(alias="inReplyToId", default=None)
+
+    received_at: Optional[datetime] = FieldInfo(alias="receivedAt", default=None)
+
+    sent_at: Optional[datetime] = FieldInfo(alias="sentAt", default=None)
+
+    snippet: Optional[str] = None
+
+    stripped_html: Optional[str] = FieldInfo(alias="strippedHtml", default=None)
+
+    stripped_text: Optional[str] = FieldInfo(alias="strippedText", default=None)
+
+    subject: Optional[str] = None
+
+    text: Optional[str] = None
+
+
+class DataOrganization(BaseModel):
+    id: str
+
+    slug: str
+
+
+class Data(BaseModel):
+    email: DataEmail
+
+    organization: DataOrganization
+
+
+class InboundEmailReceivedWebhookEvent(BaseModel):
+    attempt: int
+
+    data: Data
+
+    event: Literal["inbound.email.received"]
+
+    timestamp: int