xberg-io-sdk 0.4.0__tar.gz

xberg_io_sdk-0.4.0/.gitignore

@@ -0,0 +1,77 @@
+# Build artifacts
+build/
+dist/
+target/
+*.whl
+*.tar.gz
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+.venv/
+.python-version
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+htmlcov/
+.coverage
+.coverage.*
+coverage.xml
+coverage.lcov
+
+# TypeScript / Node
+node_modules/
+dist/
+.turbo/
+*.tsbuildinfo
+coverage/
+.vitest-cache/
+
+# Go
+vendor/
+*.test
+*.out
+go.work.sum
+# `go build ./...` inside the tools module drops a binary named after its directory
+tools/oapi-schemaset-config/oapi-schemaset-config
+
+# Generated client code (kept out of git; produced by `task generate`)
+packages/python/src/xberg_io_sdk/_generated_api/
+packages/python/src/xberg_io_sdk/_generated_pro/
+packages/python/src/xberg_io_sdk/_generated_backend/
+packages/typescript/src/_generated/
+packages/go/generated_api.go
+packages/go/generated_pro.go
+packages/go/generated_backend.go
+# Derived oapi-codegen config for each secondary Go schema set, and the derived
+# spec it is generated against (both written by tools/oapi-schemaset-config from
+# the matching base config + the vendored specs).
+packages/go/oapi-codegen-pro.gen.yaml
+packages/go/spec-pro.gen.yaml
+packages/go/oapi-codegen-backend.gen.yaml
+packages/go/spec-backend.gen.yaml
+
+# Editor
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Misc
+*.log
+.env
+.env.local
+
+# polylint cache
+.polylint/
+
+# Astro docs-site
+docs-site/dist/
+docs-site/.astro/
+docs-site/node_modules/

xberg_io_sdk-0.4.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kreuzberg, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

xberg_io_sdk-0.4.0/PKG-INFO

@@ -0,0 +1,198 @@
+Metadata-Version: 2.5
+Name: xberg-io-sdk
+Version: 0.4.0
+Summary: Official Python client for the Xberg Enterprise and Xberg Pro document-processing APIs.
+Project-URL: Changelog, https://github.com/xberg-io/sdks/blob/main/CHANGELOG.md
+Project-URL: Documentation, https://enterprise.xberg.io
+Project-URL: Homepage, https://enterprise.xberg.io
+Project-URL: Issues, https://github.com/xberg-io/sdks/issues
+Project-URL: Repository, https://github.com/xberg-io/sdks
+Author-email: "Kreuzberg, Inc." <contact@xberg.io>
+Maintainer-email: "Kreuzberg, Inc." <contact@xberg.io>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: client,cloud,document-extraction,openapi,sdk,xberg
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: attrs>=24.2
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: python-dateutil>=2.9
+Requires-Dist: typing-extensions>=4.12; python_version < '3.11'
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://cdn.jsdelivr.net/gh/xberg-io/assets@v1/banner/readme-banner-dark.svg">
+    <img alt="Xberg" width="420" src="https://cdn.jsdelivr.net/gh/xberg-io/assets@v1/banner/readme-banner-light.svg">
+  </picture>
+</p>
+
+# xberg-io-sdk
+
+<div align="center">
+
+<img width="3384" height="573" alt="Xberg Enterprise" src="https://github.com/user-attachments/assets/1b6c6ad7-3b6d-4171-b1c9-f2026cc9deb8">
+
+</div>
+
+<div align="center" style="display: flex; flex-wrap: wrap; gap: 8px; justify-content: center; margin: 20px 0;">
+
+<a href="https://pypi.org/project/xberg-io-sdk/"><img src="https://img.shields.io/pypi/v/xberg-io-sdk?label=PyPI&color=007ec6" alt="PyPI"></a>
+<a href="https://www.npmjs.com/package/@xberg-io/sdk"><img src="https://img.shields.io/npm/v/%40xberg-io%2Fsdk?label=npm&color=007ec6" alt="npm"></a>
+<a href="https://pkg.go.dev/github.com/xberg-io/sdks/packages/go"><img src="https://img.shields.io/badge/Go-pkg.go.dev-007ec6?logo=go&logoColor=white" alt="Go Reference"></a>
+<a href="https://github.com/xberg-io/sdks/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License"></a>
+<a href="https://docs.sdks.xberg.io"><img src="https://img.shields.io/badge/docs-docs.sdks.xberg.io-007ec6" alt="Documentation"></a>
+<a href="https://github.com/xberg-io/sdks/actions/workflows/validate.yml"><img src="https://github.com/xberg-io/sdks/actions/workflows/validate.yml/badge.svg" alt="CI"></a>
+
+</div>
+
+<div align="center" style="margin-top: 20px;">
+
+<a href="https://discord.gg/xt9WY3GnKR"><img height="22" src="https://img.shields.io/badge/Discord-Join%20our%20community-7289da?logo=discord&logoColor=white" alt="Discord"></a>
+
+</div>
+
+Official Python client for the [Xberg Enterprise](https://enterprise.xberg.io)
+and Xberg Pro document-processing APIs — one client, two targets.
+
+- httpx-based, sync (`XbergClient`) and async (`AsyncXbergClient`) surfaces
+- One client speaks to both products: shared
+  extraction/jobs/presets/auto-tune/RAG surface, plus capability-gated
+  tier-specific methods (Pro auth and control plane; Enterprise
+  uploads/usage/document diff/enrichment)
+- Generated from two OpenAPI 3.1 specs (Enterprise + Pro), then wrapped in
+  ergonomic helpers
+- Configurable retry engine (honors `Retry-After`, exponential backoff)
+- Type-annotated end to end, `py.typed` shipped
+
+## Install
+
+```sh
+pip install xberg-io-sdk
+# or
+uv add xberg-io-sdk
+```
+
+Requires Python 3.10+.
+
+## Quickstart
+
+### Sync — single file with explicit API key
+
+```python
+from pathlib import Path
+from xberg_io_sdk import XbergClient
+
+# Enterprise (base_url defaults to https://api.xberg.io)
+with XbergClient(api_key="kz_...") as client:
+    job = client.extract_and_wait(file=Path("invoice.pdf"))
+    if job.result is not None:
+        print(job.result.content)
+```
+
+### Connecting to Xberg Pro
+
+Pro is self-hosted and has no default URL — pass `base_url` (and, to skip the
+`/healthz` tier probe, `target="pro"`):
+
+```python
+from xberg_io_sdk import XbergClient
+
+with XbergClient(api_key="kz_...", base_url="https://pro.internal", target="pro") as client:
+    config = client.auth_config()          # Pro-only
+    presets = client.list_saved_presets()  # both tiers; the path spelling follows the tier
+```
+
+Saved presets are served by both products under different spellings —
+`/v1/saved_presets` on Enterprise, `/v1/saved-presets` on Pro. The client
+renders the right one from the resolved tier, so the same call works against
+either target.
+
+### Async — batch extract with parallel waits
+
+```python
+import asyncio
+from pathlib import Path
+from xberg_io_sdk import AsyncXbergClient
+
+async def main() -> None:
+    async with AsyncXbergClient(api_key="kz_...") as client:
+        jobs = await client.extract_batch([Path("a.pdf"), Path("b.pdf"), Path("c.pdf")])
+        results = await client.wait_for_jobs([str(j.id) for j in jobs])
+        for job in results:
+            print(job.filename, job.status)
+
+asyncio.run(main())
+```
+
+## Public API
+
+One `XbergClient` (sync) / `AsyncXbergClient` (async) serves both products.
+Constructor: `(api_key=None, base_url=None, target=None, timeout=30,
+headers=None, retries=0, retry_on=..., retry_backoff="exponential")`.
+
+Shared methods (both tiers):
+
+| Method | Purpose |
+|---|---|
+| `extract(file=..., options=..., webhook=...)` | Submit one document, get back a `Job`. |
+| `extract_batch(files, options=...)` | Submit many documents in ONE multipart request. |
+| `get_job(job_id)` | Fetch current job status / result. |
+| `wait_for_job(job_id, timeout=300, ...)` | Poll until terminal (raises on `failed`/`cancelled`). |
+| `wait_for_jobs(job_ids, ...)` | Wait for multiple jobs. |
+| `extract_and_wait(file=..., ...)` | Submit + wait in one call. |
+| `get_job_result(job_id)` | Fetch a job's stored `JobResult` envelope. |
+| `list_jobs(...)`, `audit(...)` | List jobs / read the audit log. |
+| `cancel_job(job_id)` | Cancel a job (idempotent — also 204s if already terminal). |
+| `list_rag_collections()`, `rag_retrieve(name, body)`, `get_rag_job(job_id)`, … | RAG collections/documents/retrieval. |
+| `delete_rag_documents(name, body)` | Delete documents from a collection by ID list or metadata filter. |
+| `presets()`, `get_preset(id)`, `get_preset_sample(id, name)` | Curated managed presets. |
+| `list_saved_presets(...)`, `create_saved_preset(body)`, `get_saved_preset(id)`, `update_saved_preset(id, body)`, `delete_saved_preset(id)` | Project-owned saved presets (path spelling follows the tier). |
+| `list_auto_tune_jobs(...)`, `submit_auto_tune(request, files)`, `get_auto_tune_status(id)`, `get_auto_tune_result(id)`, `delete_auto_tune_job(id)` | Auto-tune runs (`submit_auto_tune` is multipart). |
+| `get_auto_tune_capabilities()`, `promote_auto_tune_profile(id, body)` | Discover tunable knobs; promote a run to a named profile. |
+| `list_tuning_profiles(...)`, `get_tuning_profile(id)`, `delete_tuning_profile(id)` | Promoted tuning profiles. |
+
+Tier-specific methods are capability-gated — calling one against the wrong tier
+raises a clear error instead of a raw 404:
+
+- **Pro only:** `login`, `auth_config`, `get_rag_config`/`set_rag_config`
+- **Pro only (control plane):** `list_projects`/`create_project`, `list_api_keys`/`create_api_key`/`revoke_api_key`, `list_integrations`/`create_integration`/`get_integration`/`delete_integration`, `connect_integration`/`disconnect_integration`, `list_integration_documents`/`fetch_integration_document`
+- **Enterprise only:** `versions`, `get_document`, `diff`/`get_diff_job`, `presign_upload`/`confirm_upload`, `usage`, `list_extraction_events`, `get_job_page` (raw `image/png` bytes), `submit_enrich`/`get_enrich_status`, `stream_crawl_events` (a generator of Server-Sent Events)
+
+### Deliberately not exposed
+
+Three documented routes have no client method, on purpose:
+
+- `GET /readyz` — an infrastructure readiness probe for orchestrators, not
+  caller-facing API surface. `GET /healthz` is exposed indirectly: it is the
+  tier probe behind `target=None`.
+- `GET /v1/oauth/callback` (Pro) — a browser redirect leg of the OIDC flow. The
+  provider calls it, not an API client.
+- `DELETE /auth/account` (Pro) — a session-cookie account-deletion flow, not
+  API-key surface. `POST /auth/login` is exposed because it mints the session
+  JWT this client can then send as a bearer token.
+
+Errors are raised as one of:
+`XbergError` (base), `AuthError` (401 **and** 403), `ValidationError`,
+`NotFoundError`, `RateLimitError` (carries `retry_after`), `ServerError`,
+`TimeoutError`.
+
+## Documentation
+
+- SDK docs: <https://docs.sdks.xberg.io>
+- Full reference and guides: <https://enterprise.xberg.io>
+
+## License
+
+MIT — © Kreuzberg, Inc.

xberg_io_sdk-0.4.0/README.md

@@ -0,0 +1,165 @@
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://cdn.jsdelivr.net/gh/xberg-io/assets@v1/banner/readme-banner-dark.svg">
+    <img alt="Xberg" width="420" src="https://cdn.jsdelivr.net/gh/xberg-io/assets@v1/banner/readme-banner-light.svg">
+  </picture>
+</p>
+
+# xberg-io-sdk
+
+<div align="center">
+
+<img width="3384" height="573" alt="Xberg Enterprise" src="https://github.com/user-attachments/assets/1b6c6ad7-3b6d-4171-b1c9-f2026cc9deb8">
+
+</div>
+
+<div align="center" style="display: flex; flex-wrap: wrap; gap: 8px; justify-content: center; margin: 20px 0;">
+
+<a href="https://pypi.org/project/xberg-io-sdk/"><img src="https://img.shields.io/pypi/v/xberg-io-sdk?label=PyPI&color=007ec6" alt="PyPI"></a>
+<a href="https://www.npmjs.com/package/@xberg-io/sdk"><img src="https://img.shields.io/npm/v/%40xberg-io%2Fsdk?label=npm&color=007ec6" alt="npm"></a>
+<a href="https://pkg.go.dev/github.com/xberg-io/sdks/packages/go"><img src="https://img.shields.io/badge/Go-pkg.go.dev-007ec6?logo=go&logoColor=white" alt="Go Reference"></a>
+<a href="https://github.com/xberg-io/sdks/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License"></a>
+<a href="https://docs.sdks.xberg.io"><img src="https://img.shields.io/badge/docs-docs.sdks.xberg.io-007ec6" alt="Documentation"></a>
+<a href="https://github.com/xberg-io/sdks/actions/workflows/validate.yml"><img src="https://github.com/xberg-io/sdks/actions/workflows/validate.yml/badge.svg" alt="CI"></a>
+
+</div>
+
+<div align="center" style="margin-top: 20px;">
+
+<a href="https://discord.gg/xt9WY3GnKR"><img height="22" src="https://img.shields.io/badge/Discord-Join%20our%20community-7289da?logo=discord&logoColor=white" alt="Discord"></a>
+
+</div>
+
+Official Python client for the [Xberg Enterprise](https://enterprise.xberg.io)
+and Xberg Pro document-processing APIs — one client, two targets.
+
+- httpx-based, sync (`XbergClient`) and async (`AsyncXbergClient`) surfaces
+- One client speaks to both products: shared
+  extraction/jobs/presets/auto-tune/RAG surface, plus capability-gated
+  tier-specific methods (Pro auth and control plane; Enterprise
+  uploads/usage/document diff/enrichment)
+- Generated from two OpenAPI 3.1 specs (Enterprise + Pro), then wrapped in
+  ergonomic helpers
+- Configurable retry engine (honors `Retry-After`, exponential backoff)
+- Type-annotated end to end, `py.typed` shipped
+
+## Install
+
+```sh
+pip install xberg-io-sdk
+# or
+uv add xberg-io-sdk
+```
+
+Requires Python 3.10+.
+
+## Quickstart
+
+### Sync — single file with explicit API key
+
+```python
+from pathlib import Path
+from xberg_io_sdk import XbergClient
+
+# Enterprise (base_url defaults to https://api.xberg.io)
+with XbergClient(api_key="kz_...") as client:
+    job = client.extract_and_wait(file=Path("invoice.pdf"))
+    if job.result is not None:
+        print(job.result.content)
+```
+
+### Connecting to Xberg Pro
+
+Pro is self-hosted and has no default URL — pass `base_url` (and, to skip the
+`/healthz` tier probe, `target="pro"`):
+
+```python
+from xberg_io_sdk import XbergClient
+
+with XbergClient(api_key="kz_...", base_url="https://pro.internal", target="pro") as client:
+    config = client.auth_config()          # Pro-only
+    presets = client.list_saved_presets()  # both tiers; the path spelling follows the tier
+```
+
+Saved presets are served by both products under different spellings —
+`/v1/saved_presets` on Enterprise, `/v1/saved-presets` on Pro. The client
+renders the right one from the resolved tier, so the same call works against
+either target.
+
+### Async — batch extract with parallel waits
+
+```python
+import asyncio
+from pathlib import Path
+from xberg_io_sdk import AsyncXbergClient
+
+async def main() -> None:
+    async with AsyncXbergClient(api_key="kz_...") as client:
+        jobs = await client.extract_batch([Path("a.pdf"), Path("b.pdf"), Path("c.pdf")])
+        results = await client.wait_for_jobs([str(j.id) for j in jobs])
+        for job in results:
+            print(job.filename, job.status)
+
+asyncio.run(main())
+```
+
+## Public API
+
+One `XbergClient` (sync) / `AsyncXbergClient` (async) serves both products.
+Constructor: `(api_key=None, base_url=None, target=None, timeout=30,
+headers=None, retries=0, retry_on=..., retry_backoff="exponential")`.
+
+Shared methods (both tiers):
+
+| Method | Purpose |
+|---|---|
+| `extract(file=..., options=..., webhook=...)` | Submit one document, get back a `Job`. |
+| `extract_batch(files, options=...)` | Submit many documents in ONE multipart request. |
+| `get_job(job_id)` | Fetch current job status / result. |
+| `wait_for_job(job_id, timeout=300, ...)` | Poll until terminal (raises on `failed`/`cancelled`). |
+| `wait_for_jobs(job_ids, ...)` | Wait for multiple jobs. |
+| `extract_and_wait(file=..., ...)` | Submit + wait in one call. |
+| `get_job_result(job_id)` | Fetch a job's stored `JobResult` envelope. |
+| `list_jobs(...)`, `audit(...)` | List jobs / read the audit log. |
+| `cancel_job(job_id)` | Cancel a job (idempotent — also 204s if already terminal). |
+| `list_rag_collections()`, `rag_retrieve(name, body)`, `get_rag_job(job_id)`, … | RAG collections/documents/retrieval. |
+| `delete_rag_documents(name, body)` | Delete documents from a collection by ID list or metadata filter. |
+| `presets()`, `get_preset(id)`, `get_preset_sample(id, name)` | Curated managed presets. |
+| `list_saved_presets(...)`, `create_saved_preset(body)`, `get_saved_preset(id)`, `update_saved_preset(id, body)`, `delete_saved_preset(id)` | Project-owned saved presets (path spelling follows the tier). |
+| `list_auto_tune_jobs(...)`, `submit_auto_tune(request, files)`, `get_auto_tune_status(id)`, `get_auto_tune_result(id)`, `delete_auto_tune_job(id)` | Auto-tune runs (`submit_auto_tune` is multipart). |
+| `get_auto_tune_capabilities()`, `promote_auto_tune_profile(id, body)` | Discover tunable knobs; promote a run to a named profile. |
+| `list_tuning_profiles(...)`, `get_tuning_profile(id)`, `delete_tuning_profile(id)` | Promoted tuning profiles. |
+
+Tier-specific methods are capability-gated — calling one against the wrong tier
+raises a clear error instead of a raw 404:
+
+- **Pro only:** `login`, `auth_config`, `get_rag_config`/`set_rag_config`
+- **Pro only (control plane):** `list_projects`/`create_project`, `list_api_keys`/`create_api_key`/`revoke_api_key`, `list_integrations`/`create_integration`/`get_integration`/`delete_integration`, `connect_integration`/`disconnect_integration`, `list_integration_documents`/`fetch_integration_document`
+- **Enterprise only:** `versions`, `get_document`, `diff`/`get_diff_job`, `presign_upload`/`confirm_upload`, `usage`, `list_extraction_events`, `get_job_page` (raw `image/png` bytes), `submit_enrich`/`get_enrich_status`, `stream_crawl_events` (a generator of Server-Sent Events)
+
+### Deliberately not exposed
+
+Three documented routes have no client method, on purpose:
+
+- `GET /readyz` — an infrastructure readiness probe for orchestrators, not
+  caller-facing API surface. `GET /healthz` is exposed indirectly: it is the
+  tier probe behind `target=None`.
+- `GET /v1/oauth/callback` (Pro) — a browser redirect leg of the OIDC flow. The
+  provider calls it, not an API client.
+- `DELETE /auth/account` (Pro) — a session-cookie account-deletion flow, not
+  API-key surface. `POST /auth/login` is exposed because it mints the session
+  JWT this client can then send as a bearer token.
+
+Errors are raised as one of:
+`XbergError` (base), `AuthError` (401 **and** 403), `ValidationError`,
+`NotFoundError`, `RateLimitError` (carries `retry_after`), `ServerError`,
+`TimeoutError`.
+
+## Documentation
+
+- SDK docs: <https://docs.sdks.xberg.io>
+- Full reference and guides: <https://enterprise.xberg.io>
+
+## License
+
+MIT — © Kreuzberg, Inc.

xberg_io_sdk-0.4.0/pyproject.toml

@@ -0,0 +1,44 @@
+[build-system]
+build-backend = "hatchling.build"
+requires = ["hatchling>=1.27"]
+
+[project]
+name = "xberg-io-sdk"
+version = "0.4.0"
+description = "Official Python client for the Xberg Enterprise and Xberg Pro document-processing APIs."
+readme = "README.md"
+keywords = ["client", "cloud", "document-extraction", "openapi", "sdk", "xberg"]
+license = "MIT"
+license-files = ["LICENSE"]
+maintainers = [{ name = "Kreuzberg, Inc.", email = "contact@xberg.io" }]
+authors = [{ name = "Kreuzberg, Inc.", email = "contact@xberg.io" }]
+requires-python = ">=3.10"
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
+  "Topic :: Software Development :: Libraries :: Python Modules",
+  "Typing :: Typed",
+]
+dependencies = [
+  "attrs>=24.2",
+  "httpx>=0.28.1",
+  "python-dateutil>=2.9",
+  "typing-extensions>=4.12; python_version<'3.11'",
+]
+urls.Changelog = "https://github.com/xberg-io/sdks/blob/main/CHANGELOG.md"
+urls.Documentation = "https://enterprise.xberg.io"
+urls.Homepage = "https://enterprise.xberg.io"
+urls.Issues = "https://github.com/xberg-io/sdks/issues"
+urls.Repository = "https://github.com/xberg-io/sdks"
+
+[tool.hatch]
+build.targets.sdist.include = ["src/xberg_io_sdk/**", "README.md", "LICENSE", "pyproject.toml"]
+build.targets.wheel.packages = ["src/xberg_io_sdk"]

xberg_io_sdk-0.4.0/src/xberg_io_sdk/__init__.py

@@ -0,0 +1,48 @@
+"""Official Python client for the Xberg Enterprise and Xberg Pro APIs."""
+
+from __future__ import annotations
+
+from xberg_io_sdk._generated_api.models.extracted_document import ExtractedDocument
+from xberg_io_sdk._generated_api.models.extraction_options import ExtractionOptions
+from xberg_io_sdk._generated_api.models.file_extraction_config import FileExtractionConfig
+from xberg_io_sdk._generated_api.models.job_response import JobResponse
+from xberg_io_sdk._generated_api.models.job_result import JobResult
+from xberg_io_sdk._generated_api.models.job_result_error import JobResultError
+from xberg_io_sdk._generated_api.models.job_status import JobStatus
+from xberg_io_sdk.client import AsyncXbergClient, XbergClient
+from xberg_io_sdk.errors import (
+    AuthError,
+    NotFoundError,
+    RateLimitError,
+    ServerError,
+    TimeoutError,  # noqa: A004 — domain-specific timeout, intentionally shadows builtin in this namespace
+    ValidationError,
+    XbergError,
+)
+
+ExtractionResult = ExtractedDocument
+Job = JobResponse
+
+__all__ = [
+    "AsyncXbergClient",
+    "AuthError",
+    "ExtractedDocument",
+    "ExtractionOptions",
+    "ExtractionResult",
+    "FileExtractionConfig",
+    "Job",
+    "JobResponse",
+    "JobResult",
+    "JobResultError",
+    "JobStatus",
+    "NotFoundError",
+    "RateLimitError",
+    "ServerError",
+    "TimeoutError",
+    "ValidationError",
+    "XbergClient",
+    "XbergError",
+    "__version__",
+]
+
+__version__ = "0.4.0"

xberg_io_sdk-0.4.0/src/xberg_io_sdk/_generated_api/__init__.py

@@ -0,0 +1,8 @@
+"""A client library for accessing Xberg Enterprise API"""
+
+from .client import AuthenticatedClient, Client
+
+__all__ = (
+    "AuthenticatedClient",
+    "Client",
+)

xberg_io_sdk-0.4.0/src/xberg_io_sdk/_generated_api/api/__init__.py

@@ -0,0 +1 @@
+"""Contains methods for accessing the API"""

xberg_io_sdk-0.4.0/src/xberg_io_sdk/_generated_api/api/audit/__init__.py

@@ -0,0 +1 @@
+"""Contains endpoint functions for accessing the API"""