meetreeve 0.1.0__tar.gz

meetreeve-0.1.0/.gitignore

@@ -0,0 +1,28 @@
+# Node
+node_modules/
+dist/
+*.tsbuildinfo
+.pnpm-store/
+# Generated from specs/ at build time — see node/scripts/generate-types.mjs.
+# Not committed: CI regenerates on every run so codegen drift is caught, not papered over.
+node/src/generated/
+
+# Python
+.venv/
+__pycache__/
+*.pyc
+*.egg-info/
+build/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+# Generated from specs/ at build time — see python/scripts/generate_models.sh.
+python/meetreeve/_generated/*/
+!python/meetreeve/_generated/__init__.py
+
+# OS
+.DS_Store
+
+# Editors
+.vscode/
+.idea/

meetreeve-0.1.0/LICENSE

@@ -0,0 +1,64 @@
+Reeve SDK License
+
+Copyright (c) MindFortress Inc. All rights reserved.
+
+This software is proprietary. It is NOT open source. No open-source license
+(MIT, Apache-2.0, BSD, or any other) is granted, and none should be inferred
+from the fact that these packages are distributed through public package
+registries.
+
+1. GRANT
+
+   Subject to these terms, MindFortress Inc. grants you a non-exclusive,
+   non-transferable, revocable license to download, install, and use this
+   software solely to access and interact with the Reeve API and related
+   MindFortress services, in accordance with any separate agreement governing
+   your use of those services.
+
+2. RESTRICTIONS
+
+   You may not:
+
+   (a) redistribute, sublicense, sell, rent, or lease this software, or
+       incorporate it into a product distributed to third parties, except as
+       necessary to operate your own application against the Reeve API;
+   (b) modify or create derivative works of this software, except that you may
+       make local modifications required to integrate it into your own
+       application;
+   (c) reverse engineer, decompile, or disassemble this software, except to the
+       extent that applicable law expressly permits it despite this limitation;
+   (d) remove or obscure any copyright, trademark, or other proprietary notice;
+   (e) use this software to build or assist in building a competing product or
+       service.
+
+3. NO SERVICE RIGHTS
+
+   This license covers the client software only. It grants no right to access
+   the Reeve API itself. Access requires valid credentials issued by
+   MindFortress Inc. and is governed separately.
+
+4. OWNERSHIP
+
+   MindFortress Inc. retains all right, title, and interest in this software.
+   This is a license, not a sale. All rights not expressly granted are
+   reserved.
+
+5. TERMINATION
+
+   This license terminates automatically if you breach it, and may be revoked
+   at any time. On termination you must stop using and destroy all copies of
+   the software.
+
+6. NO WARRANTY
+
+   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.
+
+7. LIMITATION OF LIABILITY
+
+   IN NO EVENT SHALL MINDFORTRESS INC. 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 ITS USE.
+
+For licensing enquiries: legal@mindfortress.com

meetreeve-0.1.0/PKG-INFO

@@ -0,0 +1,73 @@
+Metadata-Version: 2.4
+Name: meetreeve
+Version: 0.1.0
+Summary: Official server-side Python SDK for the Reeve API.
+License-Expression: LicenseRef-Proprietary
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27
+Provides-Extra: dev
+Requires-Dist: openapi-python-client==0.29.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# meetreeve (Python)
+
+Server-side Python SDK for the [Reeve](https://meetreeve.com) API.
+
+**Status:** not yet released. `meetreeve` is free on PyPI with a pending
+trusted publisher already registered, and the package is staged at `0.1.0`
+awaiting its first tag (DEV-4920). Deliberately **not** `reeve-sdk`, which is
+taken on PyPI by an unrelated project that also calls itself Reeve.
+
+**Licence:** proprietary, not open source — see [`LICENSE`](LICENSE).
+
+## Install (from git — no PyPI yet)
+
+```bash
+pip install "meetreeve @ git+https://github.com/MindFortressInc/reeve-sdks.git@main#subdirectory=python"
+```
+
+## Quickstart
+
+```python
+from meetreeve import ReeveClient, ReeveError
+
+client = ReeveClient(api_key="your-host-key")  # sent as X-Reeve-Host-Key
+
+try:
+    stats = client.crm.get("/api/crm/v1/stats")
+    print(stats)
+except ReeveError as e:
+    print(e.status, e.code, e.message, e.retryable)
+
+client.close()
+```
+
+Or as a context manager:
+
+```python
+with ReeveClient(api_key="your-host-key") as client:
+    namespaces = client.memory.get("/api/memory/v1/namespaces")
+```
+
+## What's generated vs. hand-written
+
+- `meetreeve/client.py`, `errors.py`, `retry.py` — hand-written. Auth header
+  injection, retry/backoff on 429/5xx, and error normalization across both
+  the migrated `{"error": {...}}` envelope and legacy `{"detail": ...}`
+  shapes.
+- `meetreeve/_generated/<product>/` — generated per catalog group via
+  [openapi-python-client](https://github.com/openapi-generators/openapi-python-client)
+  from `specs/<product>-v1.json`. Typed models + per-operation call functions
+  for callers who want full typing instead of the raw-JSON `client.<product>.get(...)`
+  facade. Regenerate with `scripts/generate_models.sh`.
+
+## Development
+
+```bash
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -e '.[dev]'
+pytest
+```

meetreeve-0.1.0/README.md

@@ -0,0 +1,60 @@
+# meetreeve (Python)
+
+Server-side Python SDK for the [Reeve](https://meetreeve.com) API.
+
+**Status:** not yet released. `meetreeve` is free on PyPI with a pending
+trusted publisher already registered, and the package is staged at `0.1.0`
+awaiting its first tag (DEV-4920). Deliberately **not** `reeve-sdk`, which is
+taken on PyPI by an unrelated project that also calls itself Reeve.
+
+**Licence:** proprietary, not open source — see [`LICENSE`](LICENSE).
+
+## Install (from git — no PyPI yet)
+
+```bash
+pip install "meetreeve @ git+https://github.com/MindFortressInc/reeve-sdks.git@main#subdirectory=python"
+```
+
+## Quickstart
+
+```python
+from meetreeve import ReeveClient, ReeveError
+
+client = ReeveClient(api_key="your-host-key")  # sent as X-Reeve-Host-Key
+
+try:
+    stats = client.crm.get("/api/crm/v1/stats")
+    print(stats)
+except ReeveError as e:
+    print(e.status, e.code, e.message, e.retryable)
+
+client.close()
+```
+
+Or as a context manager:
+
+```python
+with ReeveClient(api_key="your-host-key") as client:
+    namespaces = client.memory.get("/api/memory/v1/namespaces")
+```
+
+## What's generated vs. hand-written
+
+- `meetreeve/client.py`, `errors.py`, `retry.py` — hand-written. Auth header
+  injection, retry/backoff on 429/5xx, and error normalization across both
+  the migrated `{"error": {...}}` envelope and legacy `{"detail": ...}`
+  shapes.
+- `meetreeve/_generated/<product>/` — generated per catalog group via
+  [openapi-python-client](https://github.com/openapi-generators/openapi-python-client)
+  from `specs/<product>-v1.json`. Typed models + per-operation call functions
+  for callers who want full typing instead of the raw-JSON `client.<product>.get(...)`
+  facade. Regenerate with `scripts/generate_models.sh`.
+
+## Development
+
+```bash
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -e '.[dev]'
+pytest
+```

meetreeve-0.1.0/meetreeve/__init__.py

@@ -0,0 +1,15 @@
+from .client import DEFAULT_BASE_URL, PRODUCT_NAMES, SDK_VERSION, ProductClient, ReeveClient
+from .errors import ReeveError, normalize_error
+from .retry import DEFAULT_RETRY_OPTIONS, RetryOptions
+
+__all__ = [
+    "DEFAULT_BASE_URL",
+    "DEFAULT_RETRY_OPTIONS",
+    "PRODUCT_NAMES",
+    "ProductClient",
+    "ReeveClient",
+    "ReeveError",
+    "RetryOptions",
+    "SDK_VERSION",
+    "normalize_error",
+]

meetreeve-0.1.0/meetreeve/_generated/ads/__init__.py

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

meetreeve-0.1.0/meetreeve/_generated/ads/api/__init__.py

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

meetreeve-0.1.0/meetreeve/_generated/ads/api/ads_v1/__init__.py

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

meetreeve-0.1.0/meetreeve/_generated/ads/api/ads_v1/get_insights_api_ads_v1_insights_get.py

@@ -0,0 +1,324 @@
+from http import HTTPStatus
+from typing import Any
+
+import httpx
+
+from ... import errors
+from ...client import AuthenticatedClient, Client
+from ...models.http_validation_error import HTTPValidationError
+from ...types import UNSET, Response, Unset
+
+
+def _get_kwargs(
+    *,
+    provider: str,
+    campaign_id: None | str | Unset = UNSET,
+    advertiser_id: None | str | Unset = UNSET,
+    level: None | str | Unset = UNSET,
+    date_preset: None | str | Unset = UNSET,
+    since: None | str | Unset = UNSET,
+    until: None | str | Unset = UNSET,
+) -> dict[str, Any]:
+
+    params: dict[str, Any] = {}
+
+    params["provider"] = provider
+
+    json_campaign_id: None | str | Unset
+    if isinstance(campaign_id, Unset):
+        json_campaign_id = UNSET
+    else:
+        json_campaign_id = campaign_id
+    params["campaign_id"] = json_campaign_id
+
+    json_advertiser_id: None | str | Unset
+    if isinstance(advertiser_id, Unset):
+        json_advertiser_id = UNSET
+    else:
+        json_advertiser_id = advertiser_id
+    params["advertiser_id"] = json_advertiser_id
+
+    json_level: None | str | Unset
+    if isinstance(level, Unset):
+        json_level = UNSET
+    else:
+        json_level = level
+    params["level"] = json_level
+
+    json_date_preset: None | str | Unset
+    if isinstance(date_preset, Unset):
+        json_date_preset = UNSET
+    else:
+        json_date_preset = date_preset
+    params["date_preset"] = json_date_preset
+
+    json_since: None | str | Unset
+    if isinstance(since, Unset):
+        json_since = UNSET
+    else:
+        json_since = since
+    params["since"] = json_since
+
+    json_until: None | str | Unset
+    if isinstance(until, Unset):
+        json_until = UNSET
+    else:
+        json_until = until
+    params["until"] = json_until
+
+    params = {k: v for k, v in params.items() if v is not UNSET and v is not None}
+
+    _kwargs: dict[str, Any] = {
+        "method": "get",
+        "url": "/api/ads/v1/insights",
+        "params": params,
+    }
+
+    return _kwargs
+
+
+def _parse_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> Any | HTTPValidationError | None:
+    if response.status_code == 200:
+        response_200 = response.json()
+        return response_200
+
+    if response.status_code == 422:
+        response_422 = HTTPValidationError.from_dict(response.json())
+
+        return response_422
+
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> Response[Any | HTTPValidationError]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    *,
+    client: AuthenticatedClient | Client,
+    provider: str,
+    campaign_id: None | str | Unset = UNSET,
+    advertiser_id: None | str | Unset = UNSET,
+    level: None | str | Unset = UNSET,
+    date_preset: None | str | Unset = UNSET,
+    since: None | str | Unset = UNSET,
+    until: None | str | Unset = UNSET,
+) -> Response[Any | HTTPValidationError]:
+    """Get Insights
+
+     Campaign performance metrics for ``provider``, optionally narrowed to one
+    campaign and/or a date window.
+
+    Read-only: dispatches the provider adapter's insights read through the same
+    in-process Connects seam, scoped to the caller's org. For TikTok, an insights
+    read without an ``advertiser_id`` fans out over all the org's advertisers.
+    An unsupported provider returns a 400; a provider with no connection returns
+    a 404 in the connects error envelope.
+
+    Args:
+        provider (str): Ad provider: meta_ads | google_ads | tiktok_ads
+        campaign_id (None | str | Unset): Restrict to a single campaign (where the adapter
+            supports it)
+        advertiser_id (None | str | Unset): TikTok advertiser id (single-advertiser insights)
+        level (None | str | Unset): Aggregation level, e.g. account | campaign | adset | ad
+        date_preset (None | str | Unset): Relative window, e.g. last_7d, last_30d, this_month
+        since (None | str | Unset): Start date YYYY-MM-DD (with until, a custom window)
+        until (None | str | Unset): End date YYYY-MM-DD (with since, a custom window)
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[Any | HTTPValidationError]
+    """
+
+    kwargs = _get_kwargs(
+        provider=provider,
+        campaign_id=campaign_id,
+        advertiser_id=advertiser_id,
+        level=level,
+        date_preset=date_preset,
+        since=since,
+        until=until,
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    *,
+    client: AuthenticatedClient | Client,
+    provider: str,
+    campaign_id: None | str | Unset = UNSET,
+    advertiser_id: None | str | Unset = UNSET,
+    level: None | str | Unset = UNSET,
+    date_preset: None | str | Unset = UNSET,
+    since: None | str | Unset = UNSET,
+    until: None | str | Unset = UNSET,
+) -> Any | HTTPValidationError | None:
+    """Get Insights
+
+     Campaign performance metrics for ``provider``, optionally narrowed to one
+    campaign and/or a date window.
+
+    Read-only: dispatches the provider adapter's insights read through the same
+    in-process Connects seam, scoped to the caller's org. For TikTok, an insights
+    read without an ``advertiser_id`` fans out over all the org's advertisers.
+    An unsupported provider returns a 400; a provider with no connection returns
+    a 404 in the connects error envelope.
+
+    Args:
+        provider (str): Ad provider: meta_ads | google_ads | tiktok_ads
+        campaign_id (None | str | Unset): Restrict to a single campaign (where the adapter
+            supports it)
+        advertiser_id (None | str | Unset): TikTok advertiser id (single-advertiser insights)
+        level (None | str | Unset): Aggregation level, e.g. account | campaign | adset | ad
+        date_preset (None | str | Unset): Relative window, e.g. last_7d, last_30d, this_month
+        since (None | str | Unset): Start date YYYY-MM-DD (with until, a custom window)
+        until (None | str | Unset): End date YYYY-MM-DD (with since, a custom window)
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Any | HTTPValidationError
+    """
+
+    return sync_detailed(
+        client=client,
+        provider=provider,
+        campaign_id=campaign_id,
+        advertiser_id=advertiser_id,
+        level=level,
+        date_preset=date_preset,
+        since=since,
+        until=until,
+    ).parsed
+
+
+async def asyncio_detailed(
+    *,
+    client: AuthenticatedClient | Client,
+    provider: str,
+    campaign_id: None | str | Unset = UNSET,
+    advertiser_id: None | str | Unset = UNSET,
+    level: None | str | Unset = UNSET,
+    date_preset: None | str | Unset = UNSET,
+    since: None | str | Unset = UNSET,
+    until: None | str | Unset = UNSET,
+) -> Response[Any | HTTPValidationError]:
+    """Get Insights
+
+     Campaign performance metrics for ``provider``, optionally narrowed to one
+    campaign and/or a date window.
+
+    Read-only: dispatches the provider adapter's insights read through the same
+    in-process Connects seam, scoped to the caller's org. For TikTok, an insights
+    read without an ``advertiser_id`` fans out over all the org's advertisers.
+    An unsupported provider returns a 400; a provider with no connection returns
+    a 404 in the connects error envelope.
+
+    Args:
+        provider (str): Ad provider: meta_ads | google_ads | tiktok_ads
+        campaign_id (None | str | Unset): Restrict to a single campaign (where the adapter
+            supports it)
+        advertiser_id (None | str | Unset): TikTok advertiser id (single-advertiser insights)
+        level (None | str | Unset): Aggregation level, e.g. account | campaign | adset | ad
+        date_preset (None | str | Unset): Relative window, e.g. last_7d, last_30d, this_month
+        since (None | str | Unset): Start date YYYY-MM-DD (with until, a custom window)
+        until (None | str | Unset): End date YYYY-MM-DD (with since, a custom window)
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[Any | HTTPValidationError]
+    """
+
+    kwargs = _get_kwargs(
+        provider=provider,
+        campaign_id=campaign_id,
+        advertiser_id=advertiser_id,
+        level=level,
+        date_preset=date_preset,
+        since=since,
+        until=until,
+    )
+
+    response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    *,
+    client: AuthenticatedClient | Client,
+    provider: str,
+    campaign_id: None | str | Unset = UNSET,
+    advertiser_id: None | str | Unset = UNSET,
+    level: None | str | Unset = UNSET,
+    date_preset: None | str | Unset = UNSET,
+    since: None | str | Unset = UNSET,
+    until: None | str | Unset = UNSET,
+) -> Any | HTTPValidationError | None:
+    """Get Insights
+
+     Campaign performance metrics for ``provider``, optionally narrowed to one
+    campaign and/or a date window.
+
+    Read-only: dispatches the provider adapter's insights read through the same
+    in-process Connects seam, scoped to the caller's org. For TikTok, an insights
+    read without an ``advertiser_id`` fans out over all the org's advertisers.
+    An unsupported provider returns a 400; a provider with no connection returns
+    a 404 in the connects error envelope.
+
+    Args:
+        provider (str): Ad provider: meta_ads | google_ads | tiktok_ads
+        campaign_id (None | str | Unset): Restrict to a single campaign (where the adapter
+            supports it)
+        advertiser_id (None | str | Unset): TikTok advertiser id (single-advertiser insights)
+        level (None | str | Unset): Aggregation level, e.g. account | campaign | adset | ad
+        date_preset (None | str | Unset): Relative window, e.g. last_7d, last_30d, this_month
+        since (None | str | Unset): Start date YYYY-MM-DD (with until, a custom window)
+        until (None | str | Unset): End date YYYY-MM-DD (with since, a custom window)
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Any | HTTPValidationError
+    """
+
+    return (
+        await asyncio_detailed(
+            client=client,
+            provider=provider,
+            campaign_id=campaign_id,
+            advertiser_id=advertiser_id,
+            level=level,
+            date_preset=date_preset,
+            since=since,
+            until=until,
+        )
+    ).parsed