teamver-sdk-core 0.1.0

Shared core for Teamver SDKs: async transport, unified errors, retry, context, pagination, masking

teamver-sdk-core

Shared async HTTP core for Teamver Python SDKs: transport, unified errors, retry, request context, pagination, and secret masking.

Used by teamver-mail-agent, teamver-agent-sdk, and other Teamver packages.

Install

pip install teamver-sdk-core

Python ≥ 3.11.

Quick start

import asyncio
from teamver_sdk_core import (
    TeamverAsyncTransport,
    TransportConfig,
    RequestContext,
    TeamverSDKError,
)

async def main():
    config = TransportConfig(base_url="https://api.teamver.com", token="tv_ak_…")
    async with TeamverAsyncTransport(config) as transport:
        ctx = RequestContext(workspace_id="WS-…")
        try:
            resp = await transport.request("GET", "/api/v2/collab/channels", context=ctx)
            print(resp.json)
        except TeamverSDKError as exc:
            print(exc.code, exc.status_code, exc.request_id)

asyncio.run(main())

Features

Module	Role
transport	TeamverAsyncTransport — httpx async requests, retry, error normalization
errors	TeamverSDKError tree + error_for_status / parse_error_body
retry	RetryPolicy — safe retries (non-idempotent POST needs idempotency_key)
context	RequestContext — request_id / correlation_id
pagination	cursor iterate_pages
masking	mask tokens / Bearer / internal keys in logs

Error tree

TeamverSDKError
├─ ConfigurationError
├─ AuthenticationError        (401)
├─ AuthorizationError         (403)
├─ NotFoundError              (404)
├─ ConflictError              (409)
│  ├─ IdempotencyConflictError
│  └─ VersionConflictError
├─ RateLimitError             (429)
├─ TemporaryUnavailableError  (502/503/504)
└─ TransportError

Retry rules

• Retried: transport failure, 429, 502, 503, 504
• GET/HEAD/PUT/DELETE — treated as idempotent
• POST/PATCH — retried only when idempotency_key is set

Development

pip install -e ".[dev]"
pytest

License

MIT — see LICENSE.