brivio 0.1.0__tar.gz

brivio-0.1.0/.gitignore

@@ -0,0 +1,263 @@
+# Dependencies
+node_modules
+.pnpm-store
+
+# Build outputs
+# .next* covers every ad-hoc build dir (.next-perf, .next-verify,
+# .next-audit, ...). Enumerating them had grown to 20+ entries below
+# and still kept missing new ones.
+.next*
+out
+dist
+build
+*.tsbuildinfo
+# ESLint's per-file result cache. Declared as a turbo `lint` output so it
+# survives cache hits; it is machine-local state, never source.
+.eslintcache
+.eslintcache-*
+
+# Scratch build/typecheck logs (agent artifacts)
+/tsc-*.txt
+/ws-*.txt
+/i18n-*.txt
+/acct-test*.txt
+/taxro-test*.txt
+/_*.txt
+/build-log.txt
+/build-prepush.txt
+/push-out*.txt
+/site-mid.txt
+/pe-head.txt
+/pe-tail.txt
+/audit-report.txt
+/outdated-report.txt
+/lh-*.json
+/*-test*.txt
+/mig-out.txt
+/*.wip-backup
+/dk-gen*.txt
+/.tmp_*
+/tc*.log
+/vitest-billing.txt
+/build-out.txt
+/outdated.txt
+/tmp-*.txt
+/*-out.txt
+/_*
+!/_*/
+
+# Environment
+.env
+.env.local
+.env.*.local
+!.env.example
+
+# Terraform — state contains the CRON_SECRET in plaintext; never commit
+**/.terraform/
+*.tfstate
+*.tfstate.backup
+# State migrated to gs://brivio-iac-state, kept locally only until a
+# GCS-backed apply has succeeded once. `*.tfstate` does not match a
+# `.migrated` suffix, so without this the retired state file - which names
+# every managed resource - would be committed.
+*.tfstate.migrated
+*.tfplan
+tfplan
+
+# transient secret material
+tmp-cron-secret.txt
+
+# Local company-data gather store (scripts/company-data)
+/data/companies/
+# SEAP/SICAP procurement CSVs cached by scripts/company-data/ingest-seap.mjs.
+# A single quarter is up to 140 MB and a full 2016-2024 pass is several GB.
+/data/seap/
+/data/sanctions/
+# Bulk ANAF/company datasets generated locally — hundreds of MB, never commit
+scripts/company-data/*.csv
+scripts/company-data/*.jsonl
+scripts/company-data/*.ndjson
+
+# IDE
+.idea
+.vscode/*
+!.vscode/tasks.json
+!.vscode/settings.json
+!.vscode/extensions.json
+!.vscode/mcp.json
+*.swp
+*.swo
+.DS_Store
+
+# Logs (anchored: a bare `logs` also hid the shipped route apps/web/src/app/(app)/developers/logs/ from git)
+/logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+# Testing
+coverage
+.nyc_output
+
+# Turbo
+.turbo
+
+# Vercel
+.vercel
+
+# Database
+*.db
+*.sqlite
+
+# Drizzle
+drizzle/meta
+
+# Serwist / generated service worker (built into public/ at build time)
+/apps/web/public/sw.js
+/apps/web/public/sw.js.map
+/apps/web/public/swe-worker-*.js
+
+# Misc
+*.pem
+.cache
+Thumbs.db
+
+# Local development
+*.local
+
+# Local object-storage driver root (dev/test uploads live here now that the
+# signed-URL flow works without GCS — these are real user files, never commit)
+**/.brivio-storage/
+
+# Playwright auth state (`.auth-<target>` = E2E_AUTH_DIR per deployed target)
+**/e2e/.auth/
+**/e2e/.auth-*/
+.pnpm-cache/
+**/playwright-report/
+**/test-results/
+
+# Temporary output files
+test-output*.txt
+test-output*.json
+tsc-output.txt
+errors*.txt
+.env*
+# `.env*` above re-ignores what line ~53 negated (git takes the LAST match),
+# so the committed templates must be re-allowed here, after it. `.env.qa`
+# itself (QA-0014, real values) stays ignored via `.env*`.
+!.env.example
+!.env.qa.example
+.next-prepush/
+.next-lh/
+/apps/web/.next-lh/
+/apps/web/.next-pwa-build/
+/apps/web/.next-pwa-build2/
+/apps/web/.next-verify-build/
+
+ts-out.txt
+typecheck-out.txt
+.private/
+/apps/web/.next-prodcheck/
+
+pw-list.txt
+
+# Company-data gather/seed logs
+scripts/company-data/*.log
+/apps/web/.next-vtest/
+/apps/web/.next-vercelsim/
+/apps/web/.next-nosw/
+/apps/web/.next-tbcmp/
+/apps/web/.next-swtest/
+/apps/web/.next-warncheck/
+/apps/web/.next-cpucheck/
+/apps/web/.next-debug/
+
+# Ad-hoc analysis scratch scripts
+_*.ps1
+
+# Sealed contract PDFs (kept local only)
+infra/certs/*.pdf
+
+# Typecheck scratch output (R4-CI-01)
+tsc-*.txt
+
+# Terraform stale lock files
+**/.terraform.tfstate.lock.info
+/apps/web/.next-verify/
+
+# tsc debug output dumps
+tsc-*.txt
+
+.playwright-mcp/
+
+/data/legislation/
+scripts/legislation-data/*.ndjson
+scripts/legislation-data/*.log
+/apps/web/.next-prepush2/
+
+# tsc scratch output (R7-ARC-06)
+tmp-tsc-*.txt
+tsc-*.txt
+tmp-libtest.txt
+
+# local https dev proxy binaries + certs
+.dev-proxy/bin/
+.dev-proxy/certs/
+
+# Cloudflare Workers local state
+.wrangler/
+**/.wrangler/
+
+# Python SDK build + tooling output. The generated/ tree IS committed on
+# purpose (it is the SDK's API surface and must be reviewable in diffs), but
+# nothing derived from it is.
+__pycache__/
+*.py[cod]
+*.egg-info/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.venv/
+**/.copilot-venv/
+**/.copilot-build/
+
+# .NET SDK build output. Scoped to the .NET package rather than global `bin/`,
+# which would swallow unrelated directories elsewhere in the monorepo.
+packages/sdk-dotnet/**/bin/
+packages/sdk-dotnet/**/obj/
+**/.copilot-nupkg/
+*.nupkg
+*.snupkg
+
+# Java SDK build output. Scoped to the package rather than a global `target/`,
+# which is a common source directory name elsewhere.
+packages/sdk-java/target/
+*.class
+
+# PHP SDK build output. composer.lock is intentionally ignored: this is a
+# library, so consumers resolve their own dependency versions and committing a
+# lock would only pin our dev tooling.
+packages/sdk-php/vendor/
+packages/sdk-php/composer.lock
+packages/sdk-php/.phpunit.cache/
+packages/sdk-php/.phpunit.result.cache
+
+# Storybook static build. Regenerated by `pnpm --filter @brivio/ui
+# storybook:build`; Chromatic uploads it from CI rather than from git.
+storybook-static/
+
+# The commit mutex belongs in .git/, but a hook invoked from another cwd
+# writes it here. It is runtime state, never source.
+brivio-commit.lock
+/data/asscon/
+
+# fumadocs-mdx macro cache (apps/docs, DS2-0076) - regenerated on every build
+**/.source/
+
+# AXIOM runtime state (profiles/gate-profile are tracked; everything else is per-machine)
+.axiom/*
+!.axiom/profiles/
+!.axiom/gate-profile.json
+

brivio-0.1.0/PKG-INFO

@@ -0,0 +1,146 @@
+Metadata-Version: 2.5
+Name: brivio
+Version: 0.1.0
+Summary: Official Brivio SDK — invoicing, e-Factura, contacts and more for the Romanian market
+Project-URL: Homepage, https://brivio.ro
+Project-URL: Documentation, https://brivio.ro/developers/docs
+Project-URL: Source, https://github.com/brivio-ro/brivio-sdk-python
+Project-URL: Issues, https://github.com/brivio-ro/brivio-sdk-python/issues
+Author-email: Brivio <dev@brivio.ro>
+License: MIT
+Keywords: anaf,brivio,e-factura,efactura,invoicing,romania
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+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: Topic :: Office/Business :: Financial :: Accounting
+Requires-Python: >=3.9
+Requires-Dist: pydantic<3,>=2
+Requires-Dist: python-dateutil>=2.8
+Requires-Dist: typing-extensions>=4.7
+Requires-Dist: urllib3<3,>=2.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.8; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Brivio SDK for Python
+
+Official Python client for the [Brivio](https://brivio.ro) API — invoicing,
+e-Factura, contacts, articles and more, for the Romanian market.
+
+```bash
+pip install brivio
+```
+
+## Quick start
+
+```python
+from brivio import Brivio
+
+client = Brivio(api_key="brivio_sk_live_…")
+
+# Verify the key and see which organization it belongs to.
+print(client.me())
+
+# One page, with pagination metadata.
+page = client.contacts.list(search="srl")
+print(f"{len(page)} of {page.total} contacts")
+
+# Or walk every page lazily — no manual page arithmetic.
+for contact in client.contacts.iterate(search="srl"):
+    print(contact["name"])
+```
+
+## Invoicing
+
+```python
+invoice = client.invoices.create(
+    {
+        "contactId": "ct_123",
+        "currency": "RON",
+        "lines": [{"description": "Consultanță", "quantity": 1, "unitPrice": 1000, "vatRate": 21}],
+    },
+    # Safe to retry: the same key never creates a second invoice.
+    idempotency_key="order-42",
+)
+
+client.invoices.send(invoice["id"])
+client.invoices.submit_efactura(invoice["id"])
+print(client.invoices.efactura_status(invoice["id"]))
+```
+
+## Errors
+
+Every failure raises `BrivioError`:
+
+```python
+from brivio import Brivio, BrivioError
+
+try:
+    client.contacts.create({})
+except BrivioError as err:
+    print(err.code)     # "VALIDATION_ERROR"
+    print(err.status)   # 422
+    print(err.details)  # {"name": ["required"]}
+```
+
+`status == 0` means the request never reached the API (DNS, connection reset,
+timeout) rather than the API rejecting it.
+
+## Retries and timeouts
+
+Transient failures (`429`, `502`, `503`, `504`, network errors) are retried
+automatically — twice by default — with exponential backoff plus jitter, and
+`Retry-After` is honoured on `429`. Other 4xx responses are **not** retried:
+they fail identically every time.
+
+```python
+client = Brivio(
+    api_key="…",
+    max_retries=5,   # 0 disables
+    timeout=10.0,    # seconds; 0 disables
+    base_url="https://api.brivio.ro/v1",
+)
+```
+
+## Endpoints without a helper
+
+The typed resources cover the common surface. Anything else is one call away
+and still gets retries, error mapping and envelope unwrapping:
+
+```python
+zones = client.request("GET", "/dns/zones")
+```
+
+## Typed models
+
+Generated Pydantic models for every schema in the API live under
+`brivio._generated.models`:
+
+```python
+from brivio._generated.models.contact import Contact
+
+contact = Contact.from_dict(client.contacts.get("ct_123"))
+print(contact.name)
+```
+
+## How this SDK is built
+
+Models and operation signatures are generated from the published OpenAPI
+spec; the transport (retries, errors, pagination, idempotency) is
+hand-written so every official Brivio SDK behaves identically. See
+[`SDK_CONTRACT.md`](https://github.com/dragoscv/brivio/blob/main/docs/SDK_CONTRACT.md).
+
+## Links
+
+- API reference — <https://brivio.ro/developers/docs>
+- Other SDKs — [TypeScript](https://www.npmjs.com/package/@brivio/sdk), [PHP](https://packagist.org/packages/brivio/sdk)
+
+MIT © Brivio

brivio-0.1.0/README.md

@@ -0,0 +1,114 @@
+# Brivio SDK for Python
+
+Official Python client for the [Brivio](https://brivio.ro) API — invoicing,
+e-Factura, contacts, articles and more, for the Romanian market.
+
+```bash
+pip install brivio
+```
+
+## Quick start
+
+```python
+from brivio import Brivio
+
+client = Brivio(api_key="brivio_sk_live_…")
+
+# Verify the key and see which organization it belongs to.
+print(client.me())
+
+# One page, with pagination metadata.
+page = client.contacts.list(search="srl")
+print(f"{len(page)} of {page.total} contacts")
+
+# Or walk every page lazily — no manual page arithmetic.
+for contact in client.contacts.iterate(search="srl"):
+    print(contact["name"])
+```
+
+## Invoicing
+
+```python
+invoice = client.invoices.create(
+    {
+        "contactId": "ct_123",
+        "currency": "RON",
+        "lines": [{"description": "Consultanță", "quantity": 1, "unitPrice": 1000, "vatRate": 21}],
+    },
+    # Safe to retry: the same key never creates a second invoice.
+    idempotency_key="order-42",
+)
+
+client.invoices.send(invoice["id"])
+client.invoices.submit_efactura(invoice["id"])
+print(client.invoices.efactura_status(invoice["id"]))
+```
+
+## Errors
+
+Every failure raises `BrivioError`:
+
+```python
+from brivio import Brivio, BrivioError
+
+try:
+    client.contacts.create({})
+except BrivioError as err:
+    print(err.code)     # "VALIDATION_ERROR"
+    print(err.status)   # 422
+    print(err.details)  # {"name": ["required"]}
+```
+
+`status == 0` means the request never reached the API (DNS, connection reset,
+timeout) rather than the API rejecting it.
+
+## Retries and timeouts
+
+Transient failures (`429`, `502`, `503`, `504`, network errors) are retried
+automatically — twice by default — with exponential backoff plus jitter, and
+`Retry-After` is honoured on `429`. Other 4xx responses are **not** retried:
+they fail identically every time.
+
+```python
+client = Brivio(
+    api_key="…",
+    max_retries=5,   # 0 disables
+    timeout=10.0,    # seconds; 0 disables
+    base_url="https://api.brivio.ro/v1",
+)
+```
+
+## Endpoints without a helper
+
+The typed resources cover the common surface. Anything else is one call away
+and still gets retries, error mapping and envelope unwrapping:
+
+```python
+zones = client.request("GET", "/dns/zones")
+```
+
+## Typed models
+
+Generated Pydantic models for every schema in the API live under
+`brivio._generated.models`:
+
+```python
+from brivio._generated.models.contact import Contact
+
+contact = Contact.from_dict(client.contacts.get("ct_123"))
+print(contact.name)
+```
+
+## How this SDK is built
+
+Models and operation signatures are generated from the published OpenAPI
+spec; the transport (retries, errors, pagination, idempotency) is
+hand-written so every official Brivio SDK behaves identically. See
+[`SDK_CONTRACT.md`](https://github.com/dragoscv/brivio/blob/main/docs/SDK_CONTRACT.md).
+
+## Links
+
+- API reference — <https://brivio.ro/developers/docs>
+- Other SDKs — [TypeScript](https://www.npmjs.com/package/@brivio/sdk), [PHP](https://packagist.org/packages/brivio/sdk)
+
+MIT © Brivio

brivio-0.1.0/brivio/__init__.py

@@ -0,0 +1,162 @@
+"""Official Brivio SDK for Python.
+
+    from brivio import Brivio
+
+    client = Brivio(api_key="brivio_sk_live_…")
+
+    for contact in client.contacts.iterate(search="srl"):
+        print(contact["name"])
+
+    invoice = client.invoices.create({...}, idempotency_key="order-42")
+
+Behaviour (retries, errors, pagination) follows ``docs/SDK_CONTRACT.md`` and is
+identical across every official Brivio SDK.
+"""
+
+from __future__ import annotations
+
+from typing import Any, Iterator, Mapping
+
+from ._transport import (
+    DEFAULT_BASE_URL,
+    DEFAULT_MAX_RETRIES,
+    DEFAULT_TIMEOUT_SECONDS,
+    BrivioError,
+    Page,
+    Transport,
+)
+
+__all__ = ["Brivio", "BrivioError", "Page", "__version__"]
+__version__ = "0.1.0"
+
+
+class _Resource:
+    """CRUD over one collection.
+
+    A thin, uniform wrapper rather than 139 generated methods: the generated
+    layer exists for models and exact operation signatures, but callers reach
+    for ``client.contacts.list()`` far more often than for a specific
+    operation id.
+    """
+
+    def __init__(self, transport: Transport, path: str) -> None:
+        self._transport = transport
+        self._path = path
+
+    def list(self, **query: Any) -> Page:
+        """One page. Use :meth:`iterate` to walk them all."""
+        return self._transport.get_page(self._path, query)
+
+    def iterate(self, **query: Any) -> Iterator[Any]:
+        """Lazily yield every item across all pages."""
+        return self._transport.paginate(self._path, query)
+
+    def get(self, resource_id: str) -> Any:
+        data, _ = self._transport.request("GET", f"{self._path}/{resource_id}")
+        return data
+
+    def create(self, payload: Mapping[str, Any], *, idempotency_key: str | None = None) -> Any:
+        data, _ = self._transport.request(
+            "POST", self._path, body=payload, idempotency_key=idempotency_key
+        )
+        return data
+
+    def update(self, resource_id: str, payload: Mapping[str, Any]) -> Any:
+        data, _ = self._transport.request("PATCH", f"{self._path}/{resource_id}", body=payload)
+        return data
+
+    def delete(self, resource_id: str) -> None:
+        self._transport.request("DELETE", f"{self._path}/{resource_id}")
+
+
+class _Invoices(_Resource):
+    """Invoices, plus the lifecycle actions the API exposes."""
+
+    def send(self, invoice_id: str) -> Any:
+        """Mark as sent (DRAFT → SENT). Idempotent server-side."""
+        data, _ = self._transport.request("POST", f"{self._path}/{invoice_id}/send")
+        return data
+
+    def submit_efactura(self, invoice_id: str) -> Any:
+        """Submit to ANAF e-Factura."""
+        data, _ = self._transport.request("POST", f"{self._path}/{invoice_id}/submit-efactura")
+        return data
+
+    def efactura_status(self, invoice_id: str) -> Any:
+        data, _ = self._transport.request("GET", f"{self._path}/{invoice_id}/efactura")
+        return data
+
+    def payments(self, invoice_id: str) -> Page:
+        return self._transport.get_page(f"{self._path}/{invoice_id}/payments")
+
+    def add_payment(
+        self,
+        invoice_id: str,
+        payload: Mapping[str, Any],
+        *,
+        idempotency_key: str | None = None,
+    ) -> Any:
+        data, _ = self._transport.request(
+            "POST",
+            f"{self._path}/{invoice_id}/payments",
+            body=payload,
+            idempotency_key=idempotency_key,
+        )
+        return data
+
+
+class Brivio:
+    """Entry point.
+
+    :param api_key: ``brivio_sk_live_…`` or ``brivio_sk_test_…``.
+    :param base_url: override for self-hosted or staging.
+    :param max_retries: transient-failure retries; ``0`` disables.
+    :param timeout: per-request seconds; ``0`` disables.
+    """
+
+    def __init__(
+        self,
+        api_key: str,
+        *,
+        base_url: str = DEFAULT_BASE_URL,
+        max_retries: int = DEFAULT_MAX_RETRIES,
+        timeout: float = DEFAULT_TIMEOUT_SECONDS,
+    ) -> None:
+        self._transport = Transport(
+            api_key=api_key, base_url=base_url, max_retries=max_retries, timeout=timeout
+        )
+
+        self.contacts = _Resource(self._transport, "/contacts")
+        self.articles = _Resource(self._transport, "/articles")
+        self.invoices = _Invoices(self._transport, "/invoices")
+        self.locations = _Resource(self._transport, "/locations")
+        self.projects = _Resource(self._transport, "/projects")
+        self.quotes = _Resource(self._transport, "/quotes")
+        self.expenses = _Resource(self._transport, "/expenses")
+        self.contracts = _Resource(self._transport, "/contracts")
+        self.documents = _Resource(self._transport, "/documents")
+        self.time_entries = _Resource(self._transport, "/time-entries")
+
+    def me(self) -> Any:
+        """Identify the authenticated organization. Cheapest way to verify a key."""
+        data, _ = self._transport.request("GET", "/me")
+        return data
+
+    def request(
+        self,
+        method: str,
+        path: str,
+        *,
+        query: Mapping[str, Any] | None = None,
+        body: Any | None = None,
+        idempotency_key: str | None = None,
+    ) -> Any:
+        """Escape hatch for endpoints without a typed helper yet.
+
+        Still gets retries, error mapping and envelope unwrapping — reaching
+        for ``requests`` directly would lose all three.
+        """
+        data, _ = self._transport.request(
+            method, path, query=query, body=body, idempotency_key=idempotency_key
+        )
+        return data