chunkr-ai 0.1.0a5__tar.gz → 0.1.0a7__tar.gz

chunkr_ai-0.1.0a7/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.1.0-alpha.7"
+}

{chunkr_ai-0.1.0a5 → chunkr_ai-0.1.0a7}/CHANGELOG.md

@@ -1,5 +1,72 @@
 # Changelog
 
+## 0.1.0-alpha.7 (2025-09-01)
+
+Full Changelog: [v0.1.0-alpha.6...v0.1.0-alpha.7](https://github.com/lumina-ai-inc/chunkr-python/compare/v0.1.0-alpha.6...v0.1.0-alpha.7)
+
+### Features
+
+* **api:** api update ([02812f9](https://github.com/lumina-ai-inc/chunkr-python/commit/02812f9d493dd4cae6bb9d266f490dc718b8680c))
+* **api:** api update ([5d6370e](https://github.com/lumina-ai-inc/chunkr-python/commit/5d6370ed319787e45675bc8bd09f8a00da73f39f))
+* **api:** api update ([af27299](https://github.com/lumina-ai-inc/chunkr-python/commit/af27299366bb0912cbc2821cebc46bcfabf1feb9))
+* **api:** api update ([2e3411b](https://github.com/lumina-ai-inc/chunkr-python/commit/2e3411b71c8e14ef2e5498b0642b9b1a37a787fe))
+* **api:** api update ([0af0a90](https://github.com/lumina-ai-inc/chunkr-python/commit/0af0a90ec0f53bd52a263adaa7112caeb0a0aac4))
+* **api:** api update ([f6aaa1a](https://github.com/lumina-ai-inc/chunkr-python/commit/f6aaa1aa3f7125e5e849f955ddfd6af016e21b14))
+* **api:** api update ([8180896](https://github.com/lumina-ai-inc/chunkr-python/commit/818089630b344ade9830799e88bb6a3239829de2))
+* **api:** api update ([0ba4d05](https://github.com/lumina-ai-inc/chunkr-python/commit/0ba4d05909f42872bd8849a60a57d10e479f0428))
+* **api:** api update ([911a6c5](https://github.com/lumina-ai-inc/chunkr-python/commit/911a6c5e548bef1499dd57fa6c5502500675ceae))
+* **api:** api update ([cff79e9](https://github.com/lumina-ai-inc/chunkr-python/commit/cff79e9e362df754ea1eee6a1bc0b10d2a828ea7))
+* **api:** api update ([4d85d90](https://github.com/lumina-ai-inc/chunkr-python/commit/4d85d9069f57fc4d0fe163d96a2e01b6a0966a9d))
+* **api:** api update ([ade4cba](https://github.com/lumina-ai-inc/chunkr-python/commit/ade4cba6ba9baf4a1b615aa7b8ccf354eb352553))
+* **api:** manual updates ([195cc4f](https://github.com/lumina-ai-inc/chunkr-python/commit/195cc4f76978e18da7748de95f3cf1ae653c153d))
+* **api:** manual updates ([8799814](https://github.com/lumina-ai-inc/chunkr-python/commit/87998148609113db8497a5643bfe7275ce974aad))
+* **api:** manual updates ([5c16a7d](https://github.com/lumina-ai-inc/chunkr-python/commit/5c16a7d0e3a1395f3633727402f850d1a880a600))
+* **api:** manual updates ([5ec0746](https://github.com/lumina-ai-inc/chunkr-python/commit/5ec0746f626f52fec003915207bd805e692682e4))
+* **api:** manual updates ([10e9653](https://github.com/lumina-ai-inc/chunkr-python/commit/10e9653139e8757b90f6cfa0f590732dd9a10fcd))
+* **api:** manual updates ([6c81d70](https://github.com/lumina-ai-inc/chunkr-python/commit/6c81d70aea548d2361bea74d0bacf750ad374434))
+* **api:** manual updates ([6b8f3b7](https://github.com/lumina-ai-inc/chunkr-python/commit/6b8f3b7888c28f86ac94e1293bc7b71dcd856cff))
+* **api:** manual updates ([4342c14](https://github.com/lumina-ai-inc/chunkr-python/commit/4342c141020a1b6fd2aeaa10c3d95c942d54ffd8))
+* **api:** manual updates ([3c082a0](https://github.com/lumina-ai-inc/chunkr-python/commit/3c082a087c0fa9d6c3763380d2dc85d60cf9c13b))
+* **api:** manual updates ([d6ae694](https://github.com/lumina-ai-inc/chunkr-python/commit/d6ae6940f6b21802bd50c968cfe63ad5d594042e))
+* **api:** manual updates ([1e49205](https://github.com/lumina-ai-inc/chunkr-python/commit/1e49205b9eb5557f136a11c4a94ea8f1365bcb69))
+* **api:** manual updates ([42590a7](https://github.com/lumina-ai-inc/chunkr-python/commit/42590a732126e0b7408fe87a7e0269f0fa18fdf6))
+* **api:** manual updates ([f066102](https://github.com/lumina-ai-inc/chunkr-python/commit/f06610261af15c371a3cbf277761ffa38a8755fc))
+* **api:** manual updates ([8c5941a](https://github.com/lumina-ai-inc/chunkr-python/commit/8c5941a515d25b36e01702fc05d4afe6cc09227f))
+* **api:** manual updates ([2a8991d](https://github.com/lumina-ai-inc/chunkr-python/commit/2a8991d7e8b86713cb522b8545cc5df049832326))
+* **api:** manual updates ([81dc04d](https://github.com/lumina-ai-inc/chunkr-python/commit/81dc04df72cb26e60103624967136a72809c8035))
+* **api:** manual updates ([66dc5b0](https://github.com/lumina-ai-inc/chunkr-python/commit/66dc5b0297a117ac3e62b41b2a2830d61a797c5f))
+* **api:** manual updates ([66600d6](https://github.com/lumina-ai-inc/chunkr-python/commit/66600d68d0077b2c5af8e4d0267929ed8327ac62))
+* **api:** manual updates ([c6edf0a](https://github.com/lumina-ai-inc/chunkr-python/commit/c6edf0a704b7df24242b037ea0ccf9bdb2754266))
+* **api:** manual updates ([a54621c](https://github.com/lumina-ai-inc/chunkr-python/commit/a54621cf3982edac65148c2eaeda3bb49de6b135))
+* **api:** manual updates ([f50efb7](https://github.com/lumina-ai-inc/chunkr-python/commit/f50efb718490e24a57a11592992d7dc6c122cd0e))
+* **api:** manual updates ([268732f](https://github.com/lumina-ai-inc/chunkr-python/commit/268732f3c680dae25c20a99254356f8c1bc06054))
+
+
+### Bug Fixes
+
+* avoid newer type syntax ([e2da818](https://github.com/lumina-ai-inc/chunkr-python/commit/e2da8187ee09cc65bd886d1c9b19efb99dcd7821))
+
+
+### Chores
+
+* **internal:** add Sequence related utils ([6fca828](https://github.com/lumina-ai-inc/chunkr-python/commit/6fca8285ff66f8a72c202777dbf44670fc29382c))
+* **internal:** change ci workflow machines ([d19d52c](https://github.com/lumina-ai-inc/chunkr-python/commit/d19d52c5b853c83781949966f81acc5f14d18573))
+* **internal:** update pyright exclude list ([0a89f30](https://github.com/lumina-ai-inc/chunkr-python/commit/0a89f30528bda37759ad8d19fcfec1fc43d18329))
+* update github action ([fa46248](https://github.com/lumina-ai-inc/chunkr-python/commit/fa462489cc7f9061bee1199f95b0d5a724fa4e98))
+
+## 0.1.0-alpha.6 (2025-08-12)
+
+Full Changelog: [v0.1.0-alpha.5...v0.1.0-alpha.6](https://github.com/lumina-ai-inc/chunkr-python/compare/v0.1.0-alpha.5...v0.1.0-alpha.6)
+
+### Features
+
+* **api:** api update ([5be70ea](https://github.com/lumina-ai-inc/chunkr-python/commit/5be70ea879606227d056d3dfc9b7b67add2871cd))
+
+
+### Chores
+
+* **internal:** codegen related update ([ba667c4](https://github.com/lumina-ai-inc/chunkr-python/commit/ba667c468ec6af4fb059196e6cf9b7da8ad0b524))
+
 ## 0.1.0-alpha.5 (2025-08-12)
 
 Full Changelog: [v0.1.0-alpha.4...v0.1.0-alpha.5](https://github.com/lumina-ai-inc/chunkr-python/compare/v0.1.0-alpha.4...v0.1.0-alpha.5)

{chunkr_ai-0.1.0a5 → chunkr_ai-0.1.0a7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: chunkr-ai
-Version: 0.1.0a5
+Version: 0.1.0a7
 Summary: The official Python library for the chunkr API
 Project-URL: Homepage, https://github.com/lumina-ai-inc/chunkr-python
 Project-URL: Repository, https://github.com/lumina-ai-inc/chunkr-python
@@ -31,6 +31,8 @@ Requires-Dist: typing-extensions<5,>=4.10
 Provides-Extra: aiohttp
 Requires-Dist: aiohttp; extra == 'aiohttp'
 Requires-Dist: httpx-aiohttp>=0.1.8; extra == 'aiohttp'
+Provides-Extra: webhooks
+Requires-Dist: standardwebhooks; extra == 'webhooks'
 Description-Content-Type: text/markdown
 
 # Chunkr Python API library
@@ -70,10 +72,10 @@ client = Chunkr(
     api_key=os.environ.get("CHUNKR_API_KEY"),  # This is the default and can be omitted
 )
 
-task = client.tasks.parse.create(
+parse = client.tasks.parse.create(
     file="string",
 )
-print(task.task_id)
+print(parse.task_id)
 ```
 
 While you can provide an `api_key` keyword argument,
@@ -96,10 +98,10 @@ client = AsyncChunkr(
 
 
 async def main() -> None:
-    task = await client.tasks.parse.create(
+    parse = await client.tasks.parse.create(
         file="string",
     )
-    print(task.task_id)
+    print(parse.task_id)
 
 
 asyncio.run(main())
@@ -131,10 +133,10 @@ async def main() -> None:
         api_key="My API Key",
         http_client=DefaultAioHttpClient(),
     ) as client:
-        task = await client.tasks.parse.create(
+        parse = await client.tasks.parse.create(
             file="string",
         )
-        print(task.task_id)
+        print(parse.task_id)
 
 
 asyncio.run(main())
@@ -229,11 +231,11 @@ from chunkr_ai import Chunkr
 
 client = Chunkr()
 
-task = client.tasks.parse.create(
+parse = client.tasks.parse.create(
     file="file",
     chunk_processing={},
 )
-print(task.chunk_processing)
+print(parse.chunk_processing)
 ```
 
 ## File uploads
@@ -248,7 +250,6 @@ client = Chunkr()
 
 client.files.create(
     file=Path("/path/to/file"),
-    file_metadata="file_metadata",
 )
 ```
 
@@ -299,7 +300,7 @@ Error codes are as follows:
 
 ### Retries
 
-Certain errors are automatically retried 50 times by default, with a short exponential backoff.
+Certain errors are automatically retried 2 times by default, with a short exponential backoff.
 Connection errors (for example, due to a network connectivity problem), 408 Request Timeout, 409 Conflict,
 429 Rate Limit, and >=500 Internal errors are all retried by default.
 
@@ -322,7 +323,7 @@ client.with_options(max_retries=5).tasks.parse.create(
 
 ### Timeouts
 
-By default requests time out after 30 seconds. You can configure this with a `timeout` option,
+By default requests time out after 1 minute. You can configure this with a `timeout` option,
 which accepts a float or an [`httpx.Timeout`](https://www.python-httpx.org/advanced/timeouts/#fine-tuning-the-configuration) object:
 
 ```python
@@ -330,7 +331,7 @@ from chunkr_ai import Chunkr
 
 # Configure the default for all requests:
 client = Chunkr(
-    # 20 seconds (default is 30 seconds)
+    # 20 seconds (default is 1 minute)
     timeout=20.0,
 )
 

{chunkr_ai-0.1.0a5 → chunkr_ai-0.1.0a7}/README.md

@@ -35,10 +35,10 @@ client = Chunkr(
     api_key=os.environ.get("CHUNKR_API_KEY"),  # This is the default and can be omitted
 )
 
-task = client.tasks.parse.create(
+parse = client.tasks.parse.create(
     file="string",
 )
-print(task.task_id)
+print(parse.task_id)
 ```
 
 While you can provide an `api_key` keyword argument,
@@ -61,10 +61,10 @@ client = AsyncChunkr(
 
 
 async def main() -> None:
-    task = await client.tasks.parse.create(
+    parse = await client.tasks.parse.create(
         file="string",
     )
-    print(task.task_id)
+    print(parse.task_id)
 
 
 asyncio.run(main())
@@ -96,10 +96,10 @@ async def main() -> None:
         api_key="My API Key",
         http_client=DefaultAioHttpClient(),
     ) as client:
-        task = await client.tasks.parse.create(
+        parse = await client.tasks.parse.create(
             file="string",
         )
-        print(task.task_id)
+        print(parse.task_id)
 
 
 asyncio.run(main())
@@ -194,11 +194,11 @@ from chunkr_ai import Chunkr
 
 client = Chunkr()
 
-task = client.tasks.parse.create(
+parse = client.tasks.parse.create(
     file="file",
     chunk_processing={},
 )
-print(task.chunk_processing)
+print(parse.chunk_processing)
 ```
 
 ## File uploads
@@ -213,7 +213,6 @@ client = Chunkr()
 
 client.files.create(
     file=Path("/path/to/file"),
-    file_metadata="file_metadata",
 )
 ```
 
@@ -264,7 +263,7 @@ Error codes are as follows:
 
 ### Retries
 
-Certain errors are automatically retried 50 times by default, with a short exponential backoff.
+Certain errors are automatically retried 2 times by default, with a short exponential backoff.
 Connection errors (for example, due to a network connectivity problem), 408 Request Timeout, 409 Conflict,
 429 Rate Limit, and >=500 Internal errors are all retried by default.
 
@@ -287,7 +286,7 @@ client.with_options(max_retries=5).tasks.parse.create(
 
 ### Timeouts
 
-By default requests time out after 30 seconds. You can configure this with a `timeout` option,
+By default requests time out after 1 minute. You can configure this with a `timeout` option,
 which accepts a float or an [`httpx.Timeout`](https://www.python-httpx.org/advanced/timeouts/#fine-tuning-the-configuration) object:
 
 ```python
@@ -295,7 +294,7 @@ from chunkr_ai import Chunkr
 
 # Configure the default for all requests:
 client = Chunkr(
-    # 20 seconds (default is 30 seconds)
+    # 20 seconds (default is 1 minute)
     timeout=20.0,
 )
 

{chunkr_ai-0.1.0a5 → chunkr_ai-0.1.0a7}/api.md

@@ -3,22 +3,60 @@
 Types:
 
 ```python
-from chunkr_ai.types import Task
+from chunkr_ai.types import (
+    BoundingBox,
+    Cell,
+    CellStyle,
+    Chunk,
+    ChunkProcessing,
+    ExtractConfiguration,
+    ExtractOutputResponse,
+    FileInfo,
+    GenerationConfig,
+    LlmProcessing,
+    OcrResult,
+    Page,
+    ParseConfiguration,
+    ParseOutputResponse,
+    Segment,
+    SegmentProcessing,
+    TaskResponse,
+    VersionInfo,
+)
 ```
 
 Methods:
 
-- <code title="get /tasks">client.tasks.<a href="./src/chunkr_ai/resources/tasks/tasks.py">list</a>(\*\*<a href="src/chunkr_ai/types/task_list_params.py">params</a>) -> <a href="./src/chunkr_ai/types/task.py">SyncTasksPage[Task]</a></code>
+- <code title="get /tasks">client.tasks.<a href="./src/chunkr_ai/resources/tasks/tasks.py">list</a>(\*\*<a href="src/chunkr_ai/types/task_list_params.py">params</a>) -> <a href="./src/chunkr_ai/types/task_response.py">SyncTasksPage[TaskResponse]</a></code>
 - <code title="delete /tasks/{task_id}">client.tasks.<a href="./src/chunkr_ai/resources/tasks/tasks.py">delete</a>(task_id) -> None</code>
 - <code title="get /tasks/{task_id}/cancel">client.tasks.<a href="./src/chunkr_ai/resources/tasks/tasks.py">cancel</a>(task_id) -> None</code>
-- <code title="get /tasks/{task_id}">client.tasks.<a href="./src/chunkr_ai/resources/tasks/tasks.py">get</a>(task_id, \*\*<a href="src/chunkr_ai/types/task_get_params.py">params</a>) -> <a href="./src/chunkr_ai/types/task.py">Task</a></code>
+- <code title="get /tasks/{task_id}">client.tasks.<a href="./src/chunkr_ai/resources/tasks/tasks.py">get</a>(task_id, \*\*<a href="src/chunkr_ai/types/task_get_params.py">params</a>) -> <a href="./src/chunkr_ai/types/task_response.py">TaskResponse</a></code>
+
+## Extract
+
+Types:
+
+```python
+from chunkr_ai.types.tasks import ExtractCreateResponse, ExtractGetResponse
+```
+
+Methods:
+
+- <code title="post /tasks/extract">client.tasks.extract.<a href="./src/chunkr_ai/resources/tasks/extract.py">create</a>(\*\*<a href="src/chunkr_ai/types/tasks/extract_create_params.py">params</a>) -> <a href="./src/chunkr_ai/types/tasks/extract_create_response.py">ExtractCreateResponse</a></code>
+- <code title="get /tasks/{task_id}/extract">client.tasks.extract.<a href="./src/chunkr_ai/resources/tasks/extract.py">get</a>(task_id, \*\*<a href="src/chunkr_ai/types/tasks/extract_get_params.py">params</a>) -> <a href="./src/chunkr_ai/types/tasks/extract_get_response.py">ExtractGetResponse</a></code>
 
 ## Parse
 
+Types:
+
+```python
+from chunkr_ai.types.tasks import ParseCreateResponse, ParseGetResponse
+```
+
 Methods:
 
-- <code title="post /tasks/parse">client.tasks.parse.<a href="./src/chunkr_ai/resources/tasks/parse.py">create</a>(\*\*<a href="src/chunkr_ai/types/tasks/parse_create_params.py">params</a>) -> <a href="./src/chunkr_ai/types/task.py">Task</a></code>
-- <code title="patch /tasks/parse/{task_id}">client.tasks.parse.<a href="./src/chunkr_ai/resources/tasks/parse.py">update</a>(task_id, \*\*<a href="src/chunkr_ai/types/tasks/parse_update_params.py">params</a>) -> <a href="./src/chunkr_ai/types/task.py">Task</a></code>
+- <code title="post /tasks/parse">client.tasks.parse.<a href="./src/chunkr_ai/resources/tasks/parse.py">create</a>(\*\*<a href="src/chunkr_ai/types/tasks/parse_create_params.py">params</a>) -> <a href="./src/chunkr_ai/types/tasks/parse_create_response.py">ParseCreateResponse</a></code>
+- <code title="get /tasks/{task_id}/parse">client.tasks.parse.<a href="./src/chunkr_ai/resources/tasks/parse.py">get</a>(task_id, \*\*<a href="src/chunkr_ai/types/tasks/parse_get_params.py">params</a>) -> <a href="./src/chunkr_ai/types/tasks/parse_get_response.py">ParseGetResponse</a></code>
 
 # Files
 
@@ -48,3 +86,20 @@ from chunkr_ai.types import HealthCheckResponse
 Methods:
 
 - <code title="get /health">client.health.<a href="./src/chunkr_ai/resources/health.py">check</a>() -> str</code>
+
+# Webhooks
+
+Types:
+
+```python
+from chunkr_ai.types import (
+    WebhookURLResponse,
+    TaskExtractUpdatedWebhookEvent,
+    TaskParseUpdatedWebhookEvent,
+    UnwrapWebhookEvent,
+)
+```
+
+Methods:
+
+- <code title="get /webhook/url">client.webhooks.<a href="./src/chunkr_ai/resources/webhooks.py">url</a>() -> <a href="./src/chunkr_ai/types/webhook_url_response.py">WebhookURLResponse</a></code>

{chunkr_ai-0.1.0a5 → chunkr_ai-0.1.0a7}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "chunkr-ai"
-version = "0.1.0-alpha.5"
+version = "0.1.0-alpha.7"
 description = "The official Python library for the chunkr API"
 dynamic = ["readme"]
 license = "Apache-2.0"
@@ -40,6 +40,7 @@ Repository = "https://github.com/lumina-ai-inc/chunkr-python"
 
 [project.optional-dependencies]
 aiohttp = ["aiohttp", "httpx_aiohttp>=0.1.8"]
+webhooks = ["standardwebhooks"]
 
 [tool.rye]
 managed = true
@@ -148,6 +149,7 @@ exclude = [
     "_dev",
     ".venv",
     ".nox",
+    ".git",
 ]
 
 reportImplicitOverride = true

{chunkr_ai-0.1.0a5 → chunkr_ai-0.1.0a7}/requirements-dev.lock

@@ -28,11 +28,14 @@ async-timeout==5.0.1
     # via aiohttp
 attrs==25.3.0
     # via aiohttp
+    # via standardwebhooks
 certifi==2023.7.22
     # via httpcore
     # via httpx
 colorlog==6.7.0
     # via nox
+deprecated==1.2.18
+    # via standardwebhooks
 dirty-equals==0.6.0
 distlib==0.3.7
     # via virtualenv
@@ -56,6 +59,7 @@ httpx==0.28.1
     # via chunkr-ai
     # via httpx-aiohttp
     # via respx
+    # via standardwebhooks
 httpx-aiohttp==0.1.8
     # via chunkr-ai
 idna==3.4
@@ -102,6 +106,7 @@ pytest==8.3.3
 pytest-asyncio==0.24.0
 pytest-xdist==3.7.0
 python-dateutil==2.8.2
+    # via standardwebhooks
     # via time-machine
 pytz==2023.3.post1
     # via dirty-equals
@@ -115,10 +120,16 @@ six==1.16.0
 sniffio==1.3.0
     # via anyio
     # via chunkr-ai
+standardwebhooks==1.0.0
+    # via chunkr-ai
 time-machine==2.9.0
 tomli==2.0.2
     # via mypy
     # via pytest
+types-deprecated==1.2.15.20250304
+    # via standardwebhooks
+types-python-dateutil==2.9.0.20250822
+    # via standardwebhooks
 typing-extensions==4.12.2
     # via anyio
     # via chunkr-ai
@@ -129,6 +140,8 @@ typing-extensions==4.12.2
     # via pyright
 virtualenv==20.24.5
     # via nox
+wrapt==1.17.3
+    # via deprecated
 yarl==1.20.0
     # via aiohttp
 zipp==3.17.0

{chunkr_ai-0.1.0a5 → chunkr_ai-0.1.0a7}/requirements.lock

@@ -26,9 +26,12 @@ async-timeout==5.0.1
     # via aiohttp
 attrs==25.3.0
     # via aiohttp
+    # via standardwebhooks
 certifi==2023.7.22
     # via httpcore
     # via httpx
+deprecated==1.2.18
+    # via standardwebhooks
 distro==1.8.0
     # via chunkr-ai
 exceptiongroup==1.2.2
@@ -43,6 +46,7 @@ httpcore==1.0.9
 httpx==0.28.1
     # via chunkr-ai
     # via httpx-aiohttp
+    # via standardwebhooks
 httpx-aiohttp==0.1.8
     # via chunkr-ai
 idna==3.4
@@ -59,14 +63,26 @@ pydantic==2.10.3
     # via chunkr-ai
 pydantic-core==2.27.1
     # via pydantic
+python-dateutil==2.9.0.post0
+    # via standardwebhooks
+six==1.17.0
+    # via python-dateutil
 sniffio==1.3.0
     # via anyio
     # via chunkr-ai
+standardwebhooks==1.0.0
+    # via chunkr-ai
+types-deprecated==1.2.15.20250304
+    # via standardwebhooks
+types-python-dateutil==2.9.0.20250822
+    # via standardwebhooks
 typing-extensions==4.12.2
     # via anyio
     # via chunkr-ai
     # via multidict
     # via pydantic
     # via pydantic-core
+wrapt==1.17.3
+    # via deprecated
 yarl==1.20.0
     # via aiohttp

{chunkr_ai-0.1.0a5 → chunkr_ai-0.1.0a7}/src/chunkr_ai/__init__.py

@@ -24,6 +24,7 @@ from ._exceptions import (
     InternalServerError,
     PermissionDeniedError,
     UnprocessableEntityError,
+    APIWebhookValidationError,
     APIResponseValidationError,
 )
 from ._base_client import DefaultHttpxClient, DefaultAioHttpClient, DefaultAsyncHttpxClient
@@ -45,6 +46,7 @@ __all__ = [
     "APITimeoutError",
     "APIConnectionError",
     "APIResponseValidationError",
+    "APIWebhookValidationError",
     "BadRequestError",
     "AuthenticationError",
     "PermissionDeniedError",

{chunkr_ai-0.1.0a5 → chunkr_ai-0.1.0a7}/src/chunkr_ai/_client.py

@@ -21,7 +21,7 @@ from ._types import (
 )
 from ._utils import is_given, get_async_library
 from ._version import __version__
-from .resources import files, health
+from .resources import files, health, webhooks
 from ._streaming import Stream as Stream, AsyncStream as AsyncStream
 from ._exceptions import ChunkrError, APIStatusError
 from ._base_client import (
@@ -38,16 +38,19 @@ class Chunkr(SyncAPIClient):
     tasks: tasks.TasksResource
     files: files.FilesResource
     health: health.HealthResource
+    webhooks: webhooks.WebhooksResource
     with_raw_response: ChunkrWithRawResponse
     with_streaming_response: ChunkrWithStreamedResponse
 
     # client options
     api_key: str
+    webhook_key: str | None
 
     def __init__(
         self,
         *,
         api_key: str | None = None,
+        webhook_key: str | None = None,
         base_url: str | httpx.URL | None = None,
         timeout: Union[float, Timeout, None, NotGiven] = NOT_GIVEN,
         max_retries: int = DEFAULT_MAX_RETRIES,
@@ -69,7 +72,9 @@ class Chunkr(SyncAPIClient):
     ) -> None:
         """Construct a new synchronous Chunkr client instance.
 
-        This automatically infers the `api_key` argument from the `CHUNKR_API_KEY` environment variable if it is not provided.
+        This automatically infers the following arguments from their corresponding environment variables if they are not provided:
+        - `api_key` from `CHUNKR_API_KEY`
+        - `webhook_key` from `CHUNKR_WEBHOOK_KEY`
         """
         if api_key is None:
             api_key = os.environ.get("CHUNKR_API_KEY")
@@ -79,6 +84,10 @@ class Chunkr(SyncAPIClient):
             )
         self.api_key = api_key
 
+        if webhook_key is None:
+            webhook_key = os.environ.get("CHUNKR_WEBHOOK_KEY")
+        self.webhook_key = webhook_key
+
         if base_url is None:
             base_url = os.environ.get("CHUNKR_BASE_URL")
         if base_url is None:
@@ -100,6 +109,7 @@ class Chunkr(SyncAPIClient):
         self.tasks = tasks.TasksResource(self)
         self.files = files.FilesResource(self)
         self.health = health.HealthResource(self)
+        self.webhooks = webhooks.WebhooksResource(self)
         self.with_raw_response = ChunkrWithRawResponse(self)
         self.with_streaming_response = ChunkrWithStreamedResponse(self)
 
@@ -127,6 +137,7 @@ class Chunkr(SyncAPIClient):
         self,
         *,
         api_key: str | None = None,
+        webhook_key: str | None = None,
         base_url: str | httpx.URL | None = None,
         timeout: float | Timeout | None | NotGiven = NOT_GIVEN,
         http_client: httpx.Client | None = None,
@@ -161,6 +172,7 @@ class Chunkr(SyncAPIClient):
         http_client = http_client or self._client
         return self.__class__(
             api_key=api_key or self.api_key,
+            webhook_key=webhook_key or self.webhook_key,
             base_url=base_url or self.base_url,
             timeout=self.timeout if isinstance(timeout, NotGiven) else timeout,
             http_client=http_client,
@@ -212,16 +224,19 @@ class AsyncChunkr(AsyncAPIClient):
     tasks: tasks.AsyncTasksResource
     files: files.AsyncFilesResource
     health: health.AsyncHealthResource
+    webhooks: webhooks.AsyncWebhooksResource
     with_raw_response: AsyncChunkrWithRawResponse
     with_streaming_response: AsyncChunkrWithStreamedResponse
 
     # client options
     api_key: str
+    webhook_key: str | None
 
     def __init__(
         self,
         *,
         api_key: str | None = None,
+        webhook_key: str | None = None,
         base_url: str | httpx.URL | None = None,
         timeout: Union[float, Timeout, None, NotGiven] = NOT_GIVEN,
         max_retries: int = DEFAULT_MAX_RETRIES,
@@ -243,7 +258,9 @@ class AsyncChunkr(AsyncAPIClient):
     ) -> None:
         """Construct a new async AsyncChunkr client instance.
 
-        This automatically infers the `api_key` argument from the `CHUNKR_API_KEY` environment variable if it is not provided.
+        This automatically infers the following arguments from their corresponding environment variables if they are not provided:
+        - `api_key` from `CHUNKR_API_KEY`
+        - `webhook_key` from `CHUNKR_WEBHOOK_KEY`
         """
         if api_key is None:
             api_key = os.environ.get("CHUNKR_API_KEY")
@@ -253,6 +270,10 @@ class AsyncChunkr(AsyncAPIClient):
             )
         self.api_key = api_key
 
+        if webhook_key is None:
+            webhook_key = os.environ.get("CHUNKR_WEBHOOK_KEY")
+        self.webhook_key = webhook_key
+
         if base_url is None:
             base_url = os.environ.get("CHUNKR_BASE_URL")
         if base_url is None:
@@ -274,6 +295,7 @@ class AsyncChunkr(AsyncAPIClient):
         self.tasks = tasks.AsyncTasksResource(self)
         self.files = files.AsyncFilesResource(self)
         self.health = health.AsyncHealthResource(self)
+        self.webhooks = webhooks.AsyncWebhooksResource(self)
         self.with_raw_response = AsyncChunkrWithRawResponse(self)
         self.with_streaming_response = AsyncChunkrWithStreamedResponse(self)
 
@@ -301,6 +323,7 @@ class AsyncChunkr(AsyncAPIClient):
         self,
         *,
         api_key: str | None = None,
+        webhook_key: str | None = None,
         base_url: str | httpx.URL | None = None,
         timeout: float | Timeout | None | NotGiven = NOT_GIVEN,
         http_client: httpx.AsyncClient | None = None,
@@ -335,6 +358,7 @@ class AsyncChunkr(AsyncAPIClient):
         http_client = http_client or self._client
         return self.__class__(
             api_key=api_key or self.api_key,
+            webhook_key=webhook_key or self.webhook_key,
             base_url=base_url or self.base_url,
             timeout=self.timeout if isinstance(timeout, NotGiven) else timeout,
             http_client=http_client,
@@ -387,6 +411,7 @@ class ChunkrWithRawResponse:
         self.tasks = tasks.TasksResourceWithRawResponse(client.tasks)
         self.files = files.FilesResourceWithRawResponse(client.files)
         self.health = health.HealthResourceWithRawResponse(client.health)
+        self.webhooks = webhooks.WebhooksResourceWithRawResponse(client.webhooks)
 
 
 class AsyncChunkrWithRawResponse:
@@ -394,6 +419,7 @@ class AsyncChunkrWithRawResponse:
         self.tasks = tasks.AsyncTasksResourceWithRawResponse(client.tasks)
         self.files = files.AsyncFilesResourceWithRawResponse(client.files)
         self.health = health.AsyncHealthResourceWithRawResponse(client.health)
+        self.webhooks = webhooks.AsyncWebhooksResourceWithRawResponse(client.webhooks)
 
 
 class ChunkrWithStreamedResponse:
@@ -401,6 +427,7 @@ class ChunkrWithStreamedResponse:
         self.tasks = tasks.TasksResourceWithStreamingResponse(client.tasks)
         self.files = files.FilesResourceWithStreamingResponse(client.files)
         self.health = health.HealthResourceWithStreamingResponse(client.health)
+        self.webhooks = webhooks.WebhooksResourceWithStreamingResponse(client.webhooks)
 
 
 class AsyncChunkrWithStreamedResponse:
@@ -408,6 +435,7 @@ class AsyncChunkrWithStreamedResponse:
         self.tasks = tasks.AsyncTasksResourceWithStreamingResponse(client.tasks)
         self.files = files.AsyncFilesResourceWithStreamingResponse(client.files)
         self.health = health.AsyncHealthResourceWithStreamingResponse(client.health)
+        self.webhooks = webhooks.AsyncWebhooksResourceWithStreamingResponse(client.webhooks)
 
 
 Client = Chunkr