feat(api): updates (#13)

Author: stainless-bot

.stats.yml

@@ -1 +1 @@
-configured_endpoints: 73
+configured_endpoints: 74

README.md

@@ -278,6 +278,27 @@ if response.my_field is None:
     print('Got json like {"my_field": null}.')
 ```
 
+### Accessing raw response data (e.g. headers)
+
+The "raw" Response object can be accessed by prefixing `.with_raw_response.` to any HTTP method call.
+
+```py
+from orb import Orb
+
+client = Orb()
+response = client.customers.with_raw_response.create(
+    email="string",
+    name="string",
+)
+
+print(response.headers.get('X-My-Header'))
+
+customer = response.parse()  # get the object that `customers.create()` would have returned
+print(customer.id)
+```
+
+These methods return an [`APIResponse`](https://github.com/orbcorp/orb-python/src/orb/_response.py) object.
+
 ### Configuring the HTTP client
 
 You can directly override the [httpx client](https://www.python-httpx.org/api/#client) to customize it for your use case, including:

api.md

@@ -220,13 +220,14 @@ Methods:
 Types:
 
 ```python
-from orb.types import ItemListResponse, ItemFetchResponse
+from orb.types import Item
 ```
 
 Methods:
 
-- <code title="get /items">client.items.<a href="./src/orb/resources/items.py">list</a>(\*\*<a href="src/orb/types/item_list_params.py">params</a>) -> <a href="./src/orb/types/item_list_response.py">SyncPage[ItemListResponse]</a></code>
-- <code title="get /items/{item_id}">client.items.<a href="./src/orb/resources/items.py">fetch</a>(item_id) -> <a href="./src/orb/types/item_fetch_response.py">ItemFetchResponse</a></code>
+- <code title="post /items">client.items.<a href="./src/orb/resources/items.py">create</a>(\*\*<a href="src/orb/types/item_create_params.py">params</a>) -> <a href="./src/orb/types/item.py">Item</a></code>
+- <code title="get /items">client.items.<a href="./src/orb/resources/items.py">list</a>(\*\*<a href="src/orb/types/item_list_params.py">params</a>) -> <a href="./src/orb/types/item.py">SyncPage[Item]</a></code>
+- <code title="get /items/{item_id}">client.items.<a href="./src/orb/resources/items.py">fetch</a>(item_id) -> <a href="./src/orb/types/item.py">Item</a></code>
 
 # Metrics
 

pyproject.toml

@@ -58,7 +58,6 @@ format = { chain = [
 
 typecheck = { chain = [
   "typecheck:pyright",
-  "typecheck:verify-types",
   "typecheck:mypy"
 ]}
 "typecheck:pyright" = "pyright"

src/orb/__init__.py

@@ -32,6 +32,7 @@
     ResourceTooLarge,
     APIConnectionError,
     AuthenticationError,
+    ConstraintViolation,
     FeatureNotAvailable,
     InternalServerError,
     PermissionDeniedError,
@@ -65,6 +66,7 @@
     "UnprocessableEntityError",
     "RateLimitError",
     "InternalServerError",
+    "ConstraintViolation",
     "DuplicateResourceCreation",
     "RequestValidationError",
     "OrbAuthenticationError",