reconify-python 0.1.0__tar.gz

reconify_python-0.1.0/.bumpversion.cfg

@@ -0,0 +1,14 @@
+[bumpversion]
+current_version = 0.1.0
+commit = True
+tag = True
+tag_name = v{new_version}
+message = release: bump version {current_version} -> {new_version}
+
+[bumpversion:file:pyproject.toml]
+search = version = "{current_version}"
+replace = version = "{new_version}"
+
+[bumpversion:file:src/reconify/__init__.py]
+search = __version__ = "{current_version}"
+replace = __version__ = "{new_version}"

reconify_python-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,22 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: python -m pip install --upgrade pip
+      - run: pip install ".[dev]"
+      - run: ruff check .
+      - run: mypy src
+      - run: pytest -q
+      - run: python -m build
+      - run: python -m pip install --force-reinstall --no-deps dist/*.whl
+      - run: python -c "import reconify; print(reconify.Reconify.__name__)"

reconify_python-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,21 @@
+name: Release
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: python -m pip install --upgrade pip build
+      - run: python -m build
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}

reconify_python-0.1.0/.gitignore

@@ -0,0 +1,9 @@
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.venv/
+dist/
+build/
+*.egg-info/

reconify_python-0.1.0/CHANGELOG.md

@@ -0,0 +1,8 @@
+# Changelog
+
+## 0.1.0
+
+- Initial typed Reconify Python SDK.
+- Added sync and async clients for the retained 50-operation API surface.
+- Excluded deep reconciliation adjustment, evidence, lifecycle, report-item,
+  and signoff operations.

reconify_python-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Reconify
+
+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.

reconify_python-0.1.0/PKG-INFO

@@ -0,0 +1,125 @@
+Metadata-Version: 2.4
+Name: reconify-python
+Version: 0.1.0
+Summary: Typed Python client for the Reconify Public API
+License: MIT
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: httpx<1,>=0.27
+Requires-Dist: pydantic<3,>=2.7
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == 'dev'
+Requires-Dist: bump2version>=1.0; extra == 'dev'
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: ruff>=0.5; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Reconify Python SDK
+
+Typed synchronous and asynchronous clients for the Reconify Public API.
+
+## Installation
+
+```bash
+pip install reconify-python
+```
+
+## Quickstart
+
+```python
+from reconify import Reconify
+
+with Reconify(api_key="rk_...") as client:
+    sources = client.ledger.list_ledger_sources(limit=25)
+    for source in sources.sources or []:
+        print(source.id, source.name)
+```
+
+The key may also be supplied through `RECONIFY_API_KEY`. The default endpoint is
+`https://api.reconifyhq.com/v1`; pass `base_url="https://staging.example/v1"`
+for staging or self-hosted deployments. `/v1` is added when it is absent.
+
+## Async usage and pagination
+
+```python
+from reconify import AsyncReconify
+
+async with AsyncReconify() as client:
+    async for event in client.iter_events(limit=100):
+        print(event.id)
+```
+
+Cursor and offset iterators preserve opaque cursors and the server's page size.
+When an endpoint accepts both cursor and offset pagination, `after` takes
+precedence.
+
+Every list operation also has a natural iterator on the client, for example
+`client.iter_reconciliations(limit=100)` or
+`client.iter_wallet_transactions(after="cursor")`. The async equivalent is
+an async iterator. Iterators forward query parameters using keyword arguments,
+so they never expose transport details.
+
+## Errors and retries
+
+HTTP failures raise typed `ReconifyError` subclasses. Every HTTP error exposes
+`status_code`, `detail`, `code`, validation details, response headers, and the
+response `request_id` without including credentials or request bodies.
+
+429, 503, and transient HTTP transport failures such as timeouts are retried
+for safe methods with bounded exponential backoff and jitter. Mutating methods
+are not retried unless `RetryConfig(retry_unsafe_methods=True)` is supplied.
+Transaction ingestion retries must reuse each row's `idempotencyKey`.
+
+The client default timeout is 30 seconds. Individual operations can override
+it with `timeout=...`, including an `httpx.Timeout` object. Async operations
+also support normal `asyncio` cancellation, which is the Python equivalent of
+context cancellation in other SDKs.
+
+Use `raw=True` on any operation to receive status, headers, request ID, and raw
+body through `RawResponse`.
+
+## Test-session and ingestion headers
+
+Integrity ingestion and test-session submission accept
+`integrity_test_session=...`, which is sent as `X-Integrity-Test-Session`.
+Integrity batches support 1–500 events and ledger transaction batches support
+1–5000 transactions; the SDK does not truncate caller input.
+
+The SDK intentionally excludes reconciliation adjustment, evidence, lifecycle,
+report-item, and signoff operations. The retained reconciliation surface is
+integrity sources, reconciliation list/create/get, and all schedule operations.
+
+## API reference
+
+The public operation methods are grouped by API module. Request bodies use the
+typed Pydantic models exported from `reconify.models`; list query parameters use
+the OpenAPI names in snake_case. Every operation accepts `raw=True` and a
+per-request `timeout` override.
+
+| Module | Methods |
+| --- | --- |
+| Alerts | `list_alert_rules`, `put_alert_rule` |
+| Events | `list_events`, `get_event`, `reveal_event_field` |
+| Ingestion | `ingest_integrity_events`, `ingest_integrity_test_events` |
+| Issues | `list_issues`, `get_issue_summary`, `get_issue`, `update_issue`, `list_issue_deliveries`, `retry_issue_delivery`, `add_issue_note`, `resolve_issue` |
+| Ledger | `list_ledger_sources`, `create_ledger_source`, `delete_ledger_source`, `get_ledger_source`, `update_ledger_source`, `list_source_periods`, `list_transactions`, `ingest_transactions` |
+| Reconciliations | `list_integrity_sources_for_reconciliation`, `list_reconciliation_schedules`, `create_reconciliation_schedule`, `delete_reconciliation_schedule`, `get_reconciliation_schedule`, `update_reconciliation_schedule`, `list_reconciliations`, `create_reconciliation`, `get_reconciliation` |
+| Search | `search_integrity_resources` |
+| Setup | `list_setup_integrations`, `get_setup_integration`, `list_setup_sources`, `create_setup_source`, `get_setup_source`, `update_setup_source`, `disable_setup_source`, `create_test_session`, `get_test_session`, `get_test_session_result`, `retry_test_session`, `submit_test_session_events` |
+| Transactions | `list_wallet_transactions`, `get_wallet_transaction` |
+| Wallets | `list_wallets`, `get_wallet`, `get_wallet_balance` |
+
+## Build and deploy
+
+Build the distributable artifacts locally or in CI:
+
+```bash
+python -m pip install build
+python -m build
+```
+
+The resulting wheel and source archive in `dist/` are ready for publication to
+an internal or public Python package registry. CI builds both artifacts after
+running lint, type checking, and tests.

reconify_python-0.1.0/README.md

@@ -0,0 +1,107 @@
+# Reconify Python SDK
+
+Typed synchronous and asynchronous clients for the Reconify Public API.
+
+## Installation
+
+```bash
+pip install reconify-python
+```
+
+## Quickstart
+
+```python
+from reconify import Reconify
+
+with Reconify(api_key="rk_...") as client:
+    sources = client.ledger.list_ledger_sources(limit=25)
+    for source in sources.sources or []:
+        print(source.id, source.name)
+```
+
+The key may also be supplied through `RECONIFY_API_KEY`. The default endpoint is
+`https://api.reconifyhq.com/v1`; pass `base_url="https://staging.example/v1"`
+for staging or self-hosted deployments. `/v1` is added when it is absent.
+
+## Async usage and pagination
+
+```python
+from reconify import AsyncReconify
+
+async with AsyncReconify() as client:
+    async for event in client.iter_events(limit=100):
+        print(event.id)
+```
+
+Cursor and offset iterators preserve opaque cursors and the server's page size.
+When an endpoint accepts both cursor and offset pagination, `after` takes
+precedence.
+
+Every list operation also has a natural iterator on the client, for example
+`client.iter_reconciliations(limit=100)` or
+`client.iter_wallet_transactions(after="cursor")`. The async equivalent is
+an async iterator. Iterators forward query parameters using keyword arguments,
+so they never expose transport details.
+
+## Errors and retries
+
+HTTP failures raise typed `ReconifyError` subclasses. Every HTTP error exposes
+`status_code`, `detail`, `code`, validation details, response headers, and the
+response `request_id` without including credentials or request bodies.
+
+429, 503, and transient HTTP transport failures such as timeouts are retried
+for safe methods with bounded exponential backoff and jitter. Mutating methods
+are not retried unless `RetryConfig(retry_unsafe_methods=True)` is supplied.
+Transaction ingestion retries must reuse each row's `idempotencyKey`.
+
+The client default timeout is 30 seconds. Individual operations can override
+it with `timeout=...`, including an `httpx.Timeout` object. Async operations
+also support normal `asyncio` cancellation, which is the Python equivalent of
+context cancellation in other SDKs.
+
+Use `raw=True` on any operation to receive status, headers, request ID, and raw
+body through `RawResponse`.
+
+## Test-session and ingestion headers
+
+Integrity ingestion and test-session submission accept
+`integrity_test_session=...`, which is sent as `X-Integrity-Test-Session`.
+Integrity batches support 1–500 events and ledger transaction batches support
+1–5000 transactions; the SDK does not truncate caller input.
+
+The SDK intentionally excludes reconciliation adjustment, evidence, lifecycle,
+report-item, and signoff operations. The retained reconciliation surface is
+integrity sources, reconciliation list/create/get, and all schedule operations.
+
+## API reference
+
+The public operation methods are grouped by API module. Request bodies use the
+typed Pydantic models exported from `reconify.models`; list query parameters use
+the OpenAPI names in snake_case. Every operation accepts `raw=True` and a
+per-request `timeout` override.
+
+| Module | Methods |
+| --- | --- |
+| Alerts | `list_alert_rules`, `put_alert_rule` |
+| Events | `list_events`, `get_event`, `reveal_event_field` |
+| Ingestion | `ingest_integrity_events`, `ingest_integrity_test_events` |
+| Issues | `list_issues`, `get_issue_summary`, `get_issue`, `update_issue`, `list_issue_deliveries`, `retry_issue_delivery`, `add_issue_note`, `resolve_issue` |
+| Ledger | `list_ledger_sources`, `create_ledger_source`, `delete_ledger_source`, `get_ledger_source`, `update_ledger_source`, `list_source_periods`, `list_transactions`, `ingest_transactions` |
+| Reconciliations | `list_integrity_sources_for_reconciliation`, `list_reconciliation_schedules`, `create_reconciliation_schedule`, `delete_reconciliation_schedule`, `get_reconciliation_schedule`, `update_reconciliation_schedule`, `list_reconciliations`, `create_reconciliation`, `get_reconciliation` |
+| Search | `search_integrity_resources` |
+| Setup | `list_setup_integrations`, `get_setup_integration`, `list_setup_sources`, `create_setup_source`, `get_setup_source`, `update_setup_source`, `disable_setup_source`, `create_test_session`, `get_test_session`, `get_test_session_result`, `retry_test_session`, `submit_test_session_events` |
+| Transactions | `list_wallet_transactions`, `get_wallet_transaction` |
+| Wallets | `list_wallets`, `get_wallet`, `get_wallet_balance` |
+
+## Build and deploy
+
+Build the distributable artifacts locally or in CI:
+
+```bash
+python -m pip install build
+python -m build
+```
+
+The resulting wheel and source archive in `dist/` are ready for publication to
+an internal or public Python package registry. CI builds both artifacts after
+running lint, type checking, and tests.

reconify_python-0.1.0/pyproject.toml

@@ -0,0 +1,51 @@
+[build-system]
+requires = ["hatchling>=1.25"]
+build-backend = "hatchling.build"
+
+[project]
+name = "reconify-python"
+version = "0.1.0"
+description = "Typed Python client for the Reconify Public API"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+dependencies = [
+  "httpx>=0.27,<1",
+  "pydantic>=2.7,<3",
+]
+
+[project.optional-dependencies]
+dev = [
+  "build>=1.2",
+  "bump2version>=1.0",
+  "mypy>=1.10",
+  "pytest>=8",
+  "pytest-asyncio>=0.23",
+  "ruff>=0.5",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/reconify"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+pythonpath = ["src"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP"]
+
+[tool.mypy]
+python_version = "3.10"
+strict = true
+plugins = ["pydantic.mypy"]
+
+[tool.pydantic-mypy]
+init_forbid_extra = true
+init_typed = true
+warn_required_dynamic_aliases = true
+warn_untyped_fields = true

reconify_python-0.1.0/reports/api-error-data-report.md

@@ -0,0 +1,37 @@
+# Local API Error-Data Report
+
+Date: 2026-07-21  
+Environment: local Docker stack at `http://localhost:3002/v1`  
+Client: Reconify Python SDK  
+
+## Results
+
+- A mixed ledger batch with one valid `status: "failed"` row and one invalid
+  date returned HTTP 200 with `ingested: 1` and one per-row error. The failed
+  row was persisted and returned by the failed-transaction filter.
+- Replaying the valid row with the same `idempotencyKey` returned
+  `duplicates: 1`, confirming idempotent ingestion.
+- An integrity event missing the required `eventType` returned HTTP 422 and
+  was surfaced as `ReconifyRequestError` with the server request ID.
+- An alert rule using a valid-but-unknown UUID `controlId` returned HTTP 404
+  (`control not found`), as expected.
+
+## API issue found
+
+An alert rule using a syntactically invalid `controlId` such as
+`missing-control-format` returned HTTP 500 with `internal_error` instead of a
+client validation error. The public OpenAPI schema currently describes
+`controlId` as an unconstrained string, while the database query casts it to a
+UUID.
+
+Recommended API fix: validate `controlId` as a UUID before persistence and
+return HTTP 400 for malformed values. Keep HTTP 404 for syntactically valid
+UUIDs that do not identify a control in the organization.
+
+## Alert and issue state
+
+The clean local tenant had no seeded integrity controls, so no alert rule could
+be created and no alert or issue was generated by this scenario. The failed
+ledger transaction path is independent of integrity-control setup and worked
+as documented.
+

reconify_python-0.1.0/src/reconify/__init__.py

@@ -0,0 +1,36 @@
+"""Typed clients for the Reconify Public API."""
+
+__version__ = "0.1.0"
+
+from .client import AsyncReconify, Reconify
+from .errors import (
+    ReconifyAuthenticationError,
+    ReconifyConflictError,
+    ReconifyError,
+    ReconifyNotFoundError,
+    ReconifyPermissionError,
+    ReconifyRateLimitError,
+    ReconifyRequestError,
+    ReconifyServerError,
+    ReconifyServiceUnavailableError,
+    ReconifyValidationError,
+)
+from .transport import RawResponse, RetryConfig
+
+__all__ = [
+    "AsyncReconify",
+    "Reconify",
+    "__version__",
+    "RawResponse",
+    "RetryConfig",
+    "ReconifyError",
+    "ReconifyValidationError",
+    "ReconifyAuthenticationError",
+    "ReconifyPermissionError",
+    "ReconifyNotFoundError",
+    "ReconifyConflictError",
+    "ReconifyRequestError",
+    "ReconifyRateLimitError",
+    "ReconifyServiceUnavailableError",
+    "ReconifyServerError",
+]