hevn-cli 0.1.0__tar.gz

hevn_cli-0.1.0/LICENSE

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

hevn_cli-0.1.0/PKG-INFO

@@ -0,0 +1,189 @@
+Metadata-Version: 2.4
+Name: hevn-cli
+Version: 0.1.0
+Summary: Command-line client for the HEVN backend API and MCP transfers.
+License: MIT
+License-File: LICENSE
+Keywords: hevn,cli,fintech,payments,invoicing,mcp,stablecoin
+Author: HEVN Team
+Author-email: team@hevn.finance
+Requires-Python: >=3.11,<4.0
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+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 :: Office/Business :: Financial
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Dist: click (>=8.1.8,<8.2)
+Requires-Dist: httpx (==0.28.1)
+Requires-Dist: prompt-toolkit (==3.0.36)
+Requires-Dist: python-dotenv (==1.2.2)
+Requires-Dist: pyyaml (==6.0.3)
+Requires-Dist: qrcode (==8.2)
+Requires-Dist: questionary (==2.1.0)
+Requires-Dist: rich (==13.9.4)
+Requires-Dist: typer[all] (==0.15.1)
+Project-URL: Homepage, https://github.com/hevn/hevn-cli
+Project-URL: Repository, https://github.com/hevn/hevn-cli
+Description-Content-Type: text/markdown
+
+# HEVN CLI
+
+Standalone command-line wrapper for the [HEVN](https://app.gethevn.com) backend API and MCP transfers.
+
+> Requires an active HEVN account. Sign up at [app.gethevn.com](https://app.gethevn.com) before installing.
+
+## Install
+
+For end users:
+
+```bash
+pipx install hevn-cli
+hevn login
+hevn --help
+```
+
+Before the package is published to PyPI, install from GitHub so `pipx upgrade`
+can fetch newer commits:
+
+```bash
+pipx install "git+https://github.com/hevn/hevn-cli.git"
+pipx upgrade hevn-cli
+```
+
+For local development:
+
+```bash
+poetry install
+poetry run hevn --help
+```
+
+For local wheel smoke testing only:
+
+```bash
+poetry build
+pipx install dist/hevn_cli-0.1.0-py3-none-any.whl
+```
+
+Local wheel installs are not a good long-term `pipx` install source because
+`pipx upgrade hevn-cli` can only reinstall from that same local artifact.
+
+## Publish
+
+PyPI publishing is handled by the `Publish to PyPI` GitHub Actions workflow.
+Run it manually from the `main` branch. The workflow runs lint, tests, and
+`hevn --help` on Ubuntu, macOS, and Windows, then builds and publishes the
+package once from Ubuntu.
+
+The workflow uses PyPI trusted publishing. In the PyPI project `hevn-cli`,
+configure a trusted publisher with GitHub owner `hevn`, repository `hevn-cli`,
+workflow `.github/workflows/publish-pypi.yml`, and environment `pypi`.
+
+## Environment
+
+```bash
+export HEVN_ENV="prod" # prod (default), dev, or local
+export HEVN_API_KEY="<app bearer token or app api key>"
+export HEVN_MCP_KEY="mcp_..."
+```
+
+Optional:
+
+```bash
+export HEVN_BASE_URL="https://api.hevn.finance/api/v1"
+export HEVN_SITE_URL="https://app.gethevn.com"
+export HEVN_API_KEY_HEADER="Authorization"
+```
+
+`Authorization` is the default app header and is sent as `Bearer <HEVN_API_KEY>`.
+Use `HEVN_API_KEY_HEADER=X-API-Key` if a deployment exposes app endpoints by API key.
+Use `HEVN_*` environment variables for CLI configuration.
+
+Built-in environments:
+
+| Env | Site URL | API URL |
+| --- | --- | --- |
+| `prod` | `https://app.gethevn.com` | `https://api.hevn.finance/api/v1` |
+| `dev` | `https://app-beta.hevn.finance` | `https://dev-api.hevn.finance/api/v1` |
+| `local` | `http://localhost:8081` | `http://localhost:8000/api/v1` |
+
+You can also select the environment per command:
+
+```bash
+hevn --env dev account get
+hevn --env local login
+```
+
+Clear saved CLI credentials:
+
+```bash
+hevn logout
+```
+
+## Examples
+
+```bash
+hevn contacts list
+hevn contacts list --yaml
+hevn login
+hevn account list --yaml
+hevn banks list --all
+hevn contacts new
+hevn contacts new --type email --name "Vendor" --email vendor@example.com
+hevn transfer contact <contact-id> 25 --memo "Thanks"
+hevn transfer contact --contact-id <contact-id> --amount 25 --memo "Thanks"
+hevn transfer contact --contact-id <contact-id> --amount 25 --yes --memo "Bank payout"
+hevn transfer contact --contact-id <contact-id> --amount 25 --bank-account-id <bank-account-id> --yes --memo "Bank payout"
+hevn transfer contact --contact-id <contact-id> --quote-id <quote-id> --memo "Bank payout"
+hevn invoice list
+hevn bills --yaml
+hevn invoice get <invoice-id>
+hevn invoice decline --invoice-id <invoice-id> --yes --yaml
+hevn invoice new
+hevn invoice new --contractor-email vendor@example.com --contractor-name Vendor --item "Consulting:1:100" --due-date 2026-06-01
+hevn invoice upload-incoming --path ./invoice.pdf --contractor-email vendor@example.com --items '[{"name":"Consulting","quantity":1,"price":"100"}]'
+hevn invoice batch --contract '{"contractId":"<contract-id>","period":0,"memo":"May payroll","items":[{"name":"Monthly services","quantity":1,"price":"5000"}]}' --yaml
+hevn contracts list --yaml
+hevn contractors list --yaml
+hevn contracts preview --id <contract-id> --yaml
+hevn contracts new --contractor-email contractor@example.com --type default_contractor --amount 1000 --currency USD --period monthly --activation-at 2026-05-01 --yaml
+hevn contracts new --contractor-email contractor@example.com --type custom --document-id <document-id> --item '{"name":"Design","quantity":2,"price":"100"}' --yaml
+hevn contracts payment-methods --id <contract-id> --payment-method '{"accountType":"email","email":"contractor@example.com"}' --yaml
+hevn contracts --id <contract-id> approve --yaml
+hevn hire --contractor-email contractor@example.com --job-title "Engineer" --scope-description "Full-time engineering work" --amount 5000 --currency USD --period monthly --start-date 2026-05-01 --yaml
+hevn transfer --invoice-id <invoice-id> --memo "Invoice payment"
+hevn deposit 100 usdc base
+hevn deposit --amount 100 --currency usdc --chain base
+hevn rate EUR
+hevn rate --currency AED --yaml
+```
+
+Contract statuses:
+
+```text
+pending_approval_by_contractor
+pending_approval_by_client
+active
+completed
+cancelled
+paused
+```
+
+`hevn hire` is a convenience alias for creating a `contractor` contract.
+Preview it with `hevn contracts preview --id <contract-id> --yaml`, then approve
+with `hevn contracts --id <contract-id> approve --yaml`.
+
+## Contract migration guidance
+
+When a user asks to move or import contracts or contractors into HEVN, load them
+by creating a new active contract from the contract file rather than only adding
+contractor records. For Deel migrations, first suggest that the user create a
+Deel API token at
+[app.deel.com/settings/developer/tokens/create](https://app.deel.com/settings/developer/tokens/create).
+

hevn_cli-0.1.0/README.md

@@ -0,0 +1,153 @@
+# HEVN CLI
+
+Standalone command-line wrapper for the [HEVN](https://app.gethevn.com) backend API and MCP transfers.
+
+> Requires an active HEVN account. Sign up at [app.gethevn.com](https://app.gethevn.com) before installing.
+
+## Install
+
+For end users:
+
+```bash
+pipx install hevn-cli
+hevn login
+hevn --help
+```
+
+Before the package is published to PyPI, install from GitHub so `pipx upgrade`
+can fetch newer commits:
+
+```bash
+pipx install "git+https://github.com/hevn/hevn-cli.git"
+pipx upgrade hevn-cli
+```
+
+For local development:
+
+```bash
+poetry install
+poetry run hevn --help
+```
+
+For local wheel smoke testing only:
+
+```bash
+poetry build
+pipx install dist/hevn_cli-0.1.0-py3-none-any.whl
+```
+
+Local wheel installs are not a good long-term `pipx` install source because
+`pipx upgrade hevn-cli` can only reinstall from that same local artifact.
+
+## Publish
+
+PyPI publishing is handled by the `Publish to PyPI` GitHub Actions workflow.
+Run it manually from the `main` branch. The workflow runs lint, tests, and
+`hevn --help` on Ubuntu, macOS, and Windows, then builds and publishes the
+package once from Ubuntu.
+
+The workflow uses PyPI trusted publishing. In the PyPI project `hevn-cli`,
+configure a trusted publisher with GitHub owner `hevn`, repository `hevn-cli`,
+workflow `.github/workflows/publish-pypi.yml`, and environment `pypi`.
+
+## Environment
+
+```bash
+export HEVN_ENV="prod" # prod (default), dev, or local
+export HEVN_API_KEY="<app bearer token or app api key>"
+export HEVN_MCP_KEY="mcp_..."
+```
+
+Optional:
+
+```bash
+export HEVN_BASE_URL="https://api.hevn.finance/api/v1"
+export HEVN_SITE_URL="https://app.gethevn.com"
+export HEVN_API_KEY_HEADER="Authorization"
+```
+
+`Authorization` is the default app header and is sent as `Bearer <HEVN_API_KEY>`.
+Use `HEVN_API_KEY_HEADER=X-API-Key` if a deployment exposes app endpoints by API key.
+Use `HEVN_*` environment variables for CLI configuration.
+
+Built-in environments:
+
+| Env | Site URL | API URL |
+| --- | --- | --- |
+| `prod` | `https://app.gethevn.com` | `https://api.hevn.finance/api/v1` |
+| `dev` | `https://app-beta.hevn.finance` | `https://dev-api.hevn.finance/api/v1` |
+| `local` | `http://localhost:8081` | `http://localhost:8000/api/v1` |
+
+You can also select the environment per command:
+
+```bash
+hevn --env dev account get
+hevn --env local login
+```
+
+Clear saved CLI credentials:
+
+```bash
+hevn logout
+```
+
+## Examples
+
+```bash
+hevn contacts list
+hevn contacts list --yaml
+hevn login
+hevn account list --yaml
+hevn banks list --all
+hevn contacts new
+hevn contacts new --type email --name "Vendor" --email vendor@example.com
+hevn transfer contact <contact-id> 25 --memo "Thanks"
+hevn transfer contact --contact-id <contact-id> --amount 25 --memo "Thanks"
+hevn transfer contact --contact-id <contact-id> --amount 25 --yes --memo "Bank payout"
+hevn transfer contact --contact-id <contact-id> --amount 25 --bank-account-id <bank-account-id> --yes --memo "Bank payout"
+hevn transfer contact --contact-id <contact-id> --quote-id <quote-id> --memo "Bank payout"
+hevn invoice list
+hevn bills --yaml
+hevn invoice get <invoice-id>
+hevn invoice decline --invoice-id <invoice-id> --yes --yaml
+hevn invoice new
+hevn invoice new --contractor-email vendor@example.com --contractor-name Vendor --item "Consulting:1:100" --due-date 2026-06-01
+hevn invoice upload-incoming --path ./invoice.pdf --contractor-email vendor@example.com --items '[{"name":"Consulting","quantity":1,"price":"100"}]'
+hevn invoice batch --contract '{"contractId":"<contract-id>","period":0,"memo":"May payroll","items":[{"name":"Monthly services","quantity":1,"price":"5000"}]}' --yaml
+hevn contracts list --yaml
+hevn contractors list --yaml
+hevn contracts preview --id <contract-id> --yaml
+hevn contracts new --contractor-email contractor@example.com --type default_contractor --amount 1000 --currency USD --period monthly --activation-at 2026-05-01 --yaml
+hevn contracts new --contractor-email contractor@example.com --type custom --document-id <document-id> --item '{"name":"Design","quantity":2,"price":"100"}' --yaml
+hevn contracts payment-methods --id <contract-id> --payment-method '{"accountType":"email","email":"contractor@example.com"}' --yaml
+hevn contracts --id <contract-id> approve --yaml
+hevn hire --contractor-email contractor@example.com --job-title "Engineer" --scope-description "Full-time engineering work" --amount 5000 --currency USD --period monthly --start-date 2026-05-01 --yaml
+hevn transfer --invoice-id <invoice-id> --memo "Invoice payment"
+hevn deposit 100 usdc base
+hevn deposit --amount 100 --currency usdc --chain base
+hevn rate EUR
+hevn rate --currency AED --yaml
+```
+
+Contract statuses:
+
+```text
+pending_approval_by_contractor
+pending_approval_by_client
+active
+completed
+cancelled
+paused
+```
+
+`hevn hire` is a convenience alias for creating a `contractor` contract.
+Preview it with `hevn contracts preview --id <contract-id> --yaml`, then approve
+with `hevn contracts --id <contract-id> approve --yaml`.
+
+## Contract migration guidance
+
+When a user asks to move or import contracts or contractors into HEVN, load them
+by creating a new active contract from the contract file rather than only adding
+contractor records. For Deel migrations, first suggest that the user create a
+Deel API token at
+[app.deel.com/settings/developer/tokens/create](https://app.deel.com/settings/developer/tokens/create).

hevn_cli-0.1.0/pyproject.toml

@@ -0,0 +1,56 @@
+[tool.poetry]
+name = "hevn-cli"
+version = "0.1.0"
+description = "Command-line client for the HEVN backend API and MCP transfers."
+authors = ["HEVN Team <team@hevn.finance>"]
+license = "MIT"
+readme = "README.md"
+homepage = "https://github.com/hevn/hevn-cli"
+repository = "https://github.com/hevn/hevn-cli"
+keywords = ["hevn", "cli", "fintech", "payments", "invoicing", "mcp", "stablecoin"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Office/Business :: Financial",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+packages = [{ include = "hevn_cli", from = "src" }]
+include = [{ path = "src/hevn_cli/res/*", format = ["sdist", "wheel"] }]
+
+[tool.poetry.dependencies]
+python = "^3.11"
+httpx = "0.28.1"
+click = ">=8.1.8,<8.2"
+python-dotenv = "1.2.2"
+qrcode = "8.2"
+rich = "13.9.4"
+typer = { extras = ["all"], version = "0.15.1" }
+questionary = "2.1.0"
+prompt-toolkit = "3.0.36"
+pyyaml = "6.0.3"
+
+[tool.poetry.group.dev.dependencies]
+pytest = "8.4.2"
+ruff = "0.7.4"
+twine = "6.1.0"
+
+[tool.poetry.scripts]
+hevn = "hevn_cli.main:run"
+
+[tool.ruff]
+line-length = 120
+target-version = "py311"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "W", "UP", "B"]
+ignore = ["E501", "B008"]
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"

hevn_cli-0.1.0/src/hevn_cli/__init__.py

@@ -0,0 +1,8 @@
+"""HEVN CLI package."""
+
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("hevn-cli")
+except PackageNotFoundError:
+    __version__ = "0.0.0"

hevn_cli-0.1.0/src/hevn_cli/api/__init__.py

@@ -0,0 +1,6 @@
+from hevn_cli.api.app import AppApi
+from hevn_cli.api.base import ApiClient, AuthMode
+from hevn_cli.api.mcp import McpApi
+from hevn_cli.api.public import PublicApi
+
+__all__ = ["ApiClient", "AppApi", "AuthMode", "McpApi", "PublicApi"]

hevn_cli-0.1.0/src/hevn_cli/api/app.py

@@ -0,0 +1,163 @@
+from __future__ import annotations
+
+from typing import Any
+
+from hevn_cli.api.base import ApiClient, AuthMode
+
+
+class AppApi:
+    def __init__(self, client: ApiClient | None = None) -> None:
+        self.client = client or ApiClient(AuthMode.APP)
+
+    def current_user(self) -> dict[str, Any]:
+        return self.client.get("/user")
+
+    def update_profile(self, payload: dict[str, Any]) -> dict[str, Any]:
+        return self.client.put("/user/kyc", json=payload)
+
+    def kyc_link(self) -> dict[str, Any]:
+        return self.client.post("/user/kyc_link")
+
+    def kyc_status(self, *, provider: str = "swipelux") -> dict[str, Any]:
+        return self.client.get("/user/kyc/status", params={"provider": provider})
+
+    def balance(self) -> dict[str, Any]:
+        return self.client.get("/balance")
+
+    def list_contacts(self, *, limit: int = 100, offset: int = 0) -> dict[str, Any]:
+        return self.client.get("/user/contacts", params={"limit": limit, "offset": offset})
+
+    def list_transactions(
+        self,
+        *,
+        limit: int = 50,
+        offset: int = 0,
+        transaction_type: str | None = None,
+        status: str | None = None,
+        income_only: bool | None = None,
+        bank_account_id: str | None = None,
+    ) -> dict[str, Any]:
+        return self.client.get(
+            "/transactions",
+            params={
+                "limit": limit,
+                "offset": offset,
+                "type": transaction_type,
+                "status": status,
+                "incomeOnly": income_only,
+                "bankAccountId": bank_account_id,
+            },
+        )
+
+    def create_contact(self, payload: dict[str, Any]) -> dict[str, Any]:
+        return self.client.post("/user/contact", json=payload)
+
+    def update_contact(self, contact_id: str, payload: dict[str, Any]) -> dict[str, Any]:
+        return self.client.patch(f"/user/contacts/{contact_id}", json=payload)
+
+    def delete_contact(self, contact_id: str) -> Any:
+        return self.client.delete(f"/user/contacts/{contact_id}")
+
+    def upload_document(self, payload: dict[str, Any]) -> dict[str, Any]:
+        return self.client.post("/documents/upload", json=payload)
+
+    def list_invoices(self) -> dict[str, Any]:
+        return self.client.get("/documents/contracts/invoices")
+
+    def get_invoice(self, invoice_id: str) -> dict[str, Any]:
+        return self.client.get(f"/documents/contracts/invoices/{invoice_id}")
+
+    def create_invoice(self, payload: dict[str, Any]) -> dict[str, Any]:
+        return self.client.post("/documents/contracts/invoices", json=payload)
+
+    def create_uploaded_invoice(self, payload: dict[str, Any]) -> dict[str, Any]:
+        return self.client.post("/documents/contracts/invoices/uploaded", json=payload)
+
+    def update_invoice(self, invoice_id: str, payload: dict[str, Any]) -> dict[str, Any]:
+        return self.client.put(f"/documents/contracts/invoices/{invoice_id}", json=payload)
+
+    def create_invoice_from_contract(self, contract_id: str, payload: dict[str, Any]) -> dict[str, Any]:
+        return self.client.post(f"/documents/contracts/{contract_id}/create-invoice", json=payload)
+
+    def batch_invoicing(self, payload: list[dict[str, Any]]) -> dict[str, Any]:
+        return self.client.post("/documents/contracts/invoices/batch_invoicing", json=payload)
+
+    def list_contracts(self) -> dict[str, Any]:
+        return self.client.get("/documents/contracts")
+
+    def get_contract(self, contract_id: str) -> dict[str, Any]:
+        return self.client.get(f"/documents/contracts/{contract_id}")
+
+    def preview_contract(self, contract_id: str) -> dict[str, Any]:
+        return self.client.get(f"/documents/contracts/{contract_id}/preview")
+
+    def create_contract(self, payload: dict[str, Any]) -> dict[str, Any]:
+        return self.client.post("/documents/contracts", json=payload)
+
+    def pause_contract(self, contract_id: str) -> dict[str, Any]:
+        return self.client.post(f"/documents/contracts/{contract_id}/pause")
+
+    def approve_contract(self, contract_id: str) -> dict[str, Any]:
+        return self.client.post(f"/documents/contracts/{contract_id}/approve")
+
+    def update_contract_payment_methods(
+        self, contract_id: str, payment_methods: list[dict[str, Any]]
+    ) -> dict[str, Any]:
+        return self.client.put(
+            f"/documents/contracts/{contract_id}/payment_methods",
+            json={"paymentMethods": payment_methods},
+        )
+
+    def delete_contract(self, contract_id: str) -> dict[str, Any]:
+        return self.client.delete(f"/documents/contracts/{contract_id}")
+
+    def list_banks(self) -> dict[str, Any]:
+        return self.client.get("/banks")
+
+    def activate_banks(self, rails: list[str]) -> dict[str, Any]:
+        return self.client.post("/banks/activate", json={"rails": rails})
+
+    def validate_bank(self, payload: dict[str, Any]) -> dict[str, Any]:
+        return self.client.post("/user/contact/bank/validate", json=payload)
+
+    def payin_quote(self, payload: dict[str, Any]) -> dict[str, Any]:
+        return self.client.post("/balance/payin/quote", json=payload)
+
+    def bank_payin_quote(self, payload: dict[str, Any]) -> dict[str, Any]:
+        return self.client.post("/banks/payin/quote", json=payload)
+
+    def submit_bank_payin_quote(self, payload: dict[str, Any]) -> dict[str, Any]:
+        return self.client.post("/banks/payin/quote/submit", json=payload)
+
+    def payout_quote(self, payload: dict[str, Any]) -> dict[str, Any]:
+        return self.client.post("/balance/payout/quote", json=payload)
+
+    def list_cards(self) -> dict[str, Any]:
+        return self.client.get("/cards")
+
+    def create_card(self, payload: dict[str, Any]) -> dict[str, Any]:
+        return self.client.post("/cards", json=payload)
+
+    def get_card(self, card_id: str) -> dict[str, Any]:
+        return self.client.get(f"/cards/{card_id}")
+
+    def card_details(self, card_id: str, payload: dict[str, Any]) -> dict[str, Any]:
+        return self.client.post(f"/cards/{card_id}/details", json=payload)
+
+    def update_card_label(self, card_id: str, label: str) -> dict[str, Any]:
+        return self.client.put(f"/cards/{card_id}/label", json={"label": label})
+
+    def update_card_limit(self, card_id: str, payload: dict[str, Any]) -> dict[str, Any]:
+        return self.client.put(f"/cards/{card_id}/limit", json=payload)
+
+    def freeze_card(self, card_id: str) -> Any:
+        return self.client.post(f"/cards/{card_id}/freeze")
+
+    def unfreeze_card(self, card_id: str) -> Any:
+        return self.client.post(f"/cards/{card_id}/unfreeze")
+
+    def card_kyc_link(self) -> dict[str, Any]:
+        return self.client.post("/cards/kyc/link")
+
+    def pre_approve_cards(self) -> dict[str, Any]:
+        return self.client.post("/cards/pre-approve")

hevn_cli-0.1.0/src/hevn_cli/api/base.py

@@ -0,0 +1,40 @@
+from __future__ import annotations
+
+from enum import Enum
+from typing import Any
+
+from hevn_cli.client import app_headers, mcp_headers, request
+
+
+class AuthMode(str, Enum):
+    APP = "app"
+    MCP = "mcp"
+    PUBLIC = "public"
+
+
+class ApiClient:
+    def __init__(self, auth_mode: AuthMode, *, idempotency_key: str | None = None) -> None:
+        self.auth_mode = auth_mode
+        self.idempotency_key = idempotency_key
+
+    def _headers(self) -> dict[str, str]:
+        if self.auth_mode == AuthMode.APP:
+            return app_headers()
+        if self.auth_mode == AuthMode.MCP:
+            return mcp_headers(self.idempotency_key)
+        return {"Accept": "application/json"}
+
+    def get(self, path: str, *, params: dict[str, Any] | None = None) -> Any:
+        return request("GET", path, headers=self._headers(), params=params)
+
+    def post(self, path: str, *, json: dict[str, Any] | None = None) -> Any:
+        return request("POST", path, headers=self._headers(), json_body=json)
+
+    def put(self, path: str, *, json: dict[str, Any] | None = None) -> Any:
+        return request("PUT", path, headers=self._headers(), json_body=json)
+
+    def patch(self, path: str, *, json: dict[str, Any] | None = None) -> Any:
+        return request("PATCH", path, headers=self._headers(), json_body=json)
+
+    def delete(self, path: str) -> Any:
+        return request("DELETE", path, headers=self._headers())