omnidapter-sdk 0.3.2__tar.gz

omnidapter_sdk-0.3.2/.gitignore

@@ -0,0 +1,30 @@
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+.Python
+*.egg
+*.egg-info/
+dist/
+build/
+.eggs/
+.venv/
+venv/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+*.so
+.coverage
+htmlcov/
+.env
+.env.*
+!**/.env.example
+node_modules/
+
+# Generated SDK files — regenerated by scripts/generate_sdks.sh
+omnidapter-sdk/omnidapter_sdk/*
+!omnidapter-sdk/omnidapter_sdk/client.py
+!omnidapter-sdk/omnidapter_sdk/api_client.py
+client/packages/sdk/src/*
+!client/packages/sdk/src/OmnidapterClient.ts
+!client/packages/sdk/src/index.ts

omnidapter_sdk-0.3.2/PKG-INFO

@@ -0,0 +1,14 @@
+Metadata-Version: 2.4
+Name: omnidapter-sdk
+Version: 0.3.2
+Summary: Omnidapter API client SDK
+License: MIT
+Requires-Python: >=3.10
+Requires-Dist: pydantic>=2.0
+Requires-Dist: python-dateutil>=2.8.2
+Requires-Dist: urllib3>=1.25.3
+Provides-Extra: test
+Requires-Dist: omnidapter-server; extra == 'test'
+Requires-Dist: pytest>=8.0; extra == 'test'
+Requires-Dist: testcontainers[postgres]>=4.0; extra == 'test'
+Requires-Dist: uvicorn>=0.30; extra == 'test'

omnidapter_sdk-0.3.2/README.md

@@ -0,0 +1,134 @@
+# omnidapter-sdk
+
+Python client for the [Omnidapter](https://omnidapter.heckerlabs.ai) API.
+
+Omnidapter lets you connect to your users' calendars (and other services) through a single unified API. You create a link token, send the user through the Connect UI to authorise their account, and then read their data using the connection that comes back.
+
+## Installation
+
+```bash
+pip install omnidapter-sdk
+```
+
+Requires Python 3.10+.
+
+## Getting started
+
+Create a client with your API key and the base URL of your Omnidapter instance:
+
+```python
+from omnidapter_sdk import OmnidapterClient
+
+client = OmnidapterClient(
+    base_url="https://api.example.com",
+    api_key="omni_live_...",
+)
+```
+
+All methods are synchronous and return typed response objects. The actual payload is always on `.data`.
+
+---
+
+## Providers
+
+Providers are the services Omnidapter can connect to (e.g. Google, Microsoft). You typically list them once to populate a picker in your UI.
+
+```python
+providers = client.providers.list_providers()
+for provider in providers.data:
+    print(provider.key, provider.display_name)
+
+# Fetch a single provider by its key
+google = client.providers.get_provider(provider_key="google")
+print(google.data.display_name)
+```
+
+---
+
+## Connections
+
+A connection represents an authorised link between one of your end users and a provider. Once a user completes the Connect flow, their connection appears here.
+
+```python
+# List all connections, optionally filtering by status or provider
+connections = client.connections.list_connections(status="active", provider="google")
+for conn in connections.data:
+    print(conn.id, conn.provider_key, conn.status)
+
+# Fetch a single connection
+conn = client.connections.get_connection(connection_id="conn_...")
+print(conn.data.status)
+
+# Revoke a connection — this also invalidates any stored credentials
+client.connections.delete_connection(connection_id="conn_...")
+```
+
+---
+
+## Link tokens
+
+A link token is a short-lived, single-use token that grants an end user access to the Connect UI. Generate one server-side, pass it to your frontend, and redirect the user to `connect_url`. Omnidapter will handle the OAuth flow and create a connection on success.
+
+```python
+from omnidapter_sdk.models import CreateLinkTokenRequest
+
+result = client.link_tokens.create_link_token(
+    create_link_token_request=CreateLinkTokenRequest(
+        end_user_id="user_123",           # your internal user ID
+        allowed_providers=["google", "microsoft"],  # restrict which providers are shown
+    )
+)
+
+token = result.data
+print(token.token)       # lt_... — pass this to your frontend
+print(token.connect_url) # redirect the user here to start the Connect flow
+print(token.expires_at)  # datetime — tokens are short-lived, generate them on demand
+```
+
+---
+
+## Calendar
+
+Once a user has a connection, you can read their calendar data. All calendar operations require a `connection_id`.
+
+```python
+from datetime import datetime, timezone
+
+# List the calendars available on a connection
+calendars = client.calendar.list_calendars(connection_id="conn_...")
+for cal in calendars.data:
+    print(cal.id, cal.name)
+
+# List events within a time range across a specific calendar
+events = client.calendar.list_events(
+    connection_id="conn_...",
+    calendar_id="cal_...",
+    start=datetime(2026, 4, 1, tzinfo=timezone.utc),
+    end=datetime(2026, 4, 30, tzinfo=timezone.utc),
+)
+for event in events.data:
+    print(event.id, event.title, event.start)
+```
+
+---
+
+## Error handling
+
+The SDK raises `ApiException` for any non-2xx response. You can inspect the HTTP status code and the raw response body to handle errors appropriately.
+
+```python
+from omnidapter_sdk.exceptions import ApiException
+
+try:
+    conn = client.connections.get_connection(connection_id="conn_unknown")
+except ApiException as e:
+    print(e.status)  # e.g. 404
+    print(e.body)    # JSON error body from the server
+```
+
+---
+
+## Notes
+
+- The SDK is generated from the server's OpenAPI spec via `scripts/generate_sdks.sh`.
+  Run that script after pulling changes to regenerate the client code.

omnidapter_sdk-0.3.2/omnidapter_sdk/__init__.py

@@ -0,0 +1,94 @@
+# coding: utf-8
+
+# flake8: noqa
+
+"""
+    Omnidapter Server
+
+    Self-hosted REST API wrapping the Omnidapter calendar integration library
+
+    The version of the OpenAPI document: 0.3.2
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+__version__ = "1.0.0"
+
+# import apis into sdk package
+from omnidapter_sdk.api.calendar_api import CalendarApi
+from omnidapter_sdk.api.connections_api import ConnectionsApi
+from omnidapter_sdk.api.link_tokens_api import LinkTokensApi
+from omnidapter_sdk.api.providers_api import ProvidersApi
+
+# import ApiClient
+from omnidapter_sdk.api_response import ApiResponse
+from omnidapter_sdk.api_client import ApiClient
+from omnidapter_sdk.configuration import Configuration
+from omnidapter_sdk.exceptions import OpenApiException
+from omnidapter_sdk.exceptions import ApiTypeError
+from omnidapter_sdk.exceptions import ApiValueError
+from omnidapter_sdk.exceptions import ApiKeyError
+from omnidapter_sdk.exceptions import ApiAttributeError
+from omnidapter_sdk.exceptions import ApiException
+
+# import models into sdk package
+from omnidapter_sdk.models.api_response_availability_response import ApiResponseAvailabilityResponse
+from omnidapter_sdk.models.api_response_calendar import ApiResponseCalendar
+from omnidapter_sdk.models.api_response_calendar_event import ApiResponseCalendarEvent
+from omnidapter_sdk.models.api_response_connection_response import ApiResponseConnectionResponse
+from omnidapter_sdk.models.api_response_create_connection_response import ApiResponseCreateConnectionResponse
+from omnidapter_sdk.models.api_response_link_token_data import ApiResponseLinkTokenData
+from omnidapter_sdk.models.api_response_list_calendar import ApiResponseListCalendar
+from omnidapter_sdk.models.api_response_list_provider_metadata import ApiResponseListProviderMetadata
+from omnidapter_sdk.models.api_response_provider_metadata import ApiResponseProviderMetadata
+from omnidapter_sdk.models.api_response_reauthorize_connection_response import ApiResponseReauthorizeConnectionResponse
+from omnidapter_sdk.models.attendee import Attendee
+from omnidapter_sdk.models.attendee_status import AttendeeStatus
+from omnidapter_sdk.models.auth_kind import AuthKind
+from omnidapter_sdk.models.availability_response import AvailabilityResponse
+from omnidapter_sdk.models.calendar import Calendar
+from omnidapter_sdk.models.calendar_event import CalendarEvent
+from omnidapter_sdk.models.conference_data import ConferenceData
+from omnidapter_sdk.models.conference_entry_point import ConferenceEntryPoint
+from omnidapter_sdk.models.connect_create_connection_request import ConnectCreateConnectionRequest
+from omnidapter_sdk.models.connect_session_request import ConnectSessionRequest
+from omnidapter_sdk.models.connection_config_field import ConnectionConfigField
+from omnidapter_sdk.models.connection_response import ConnectionResponse
+from omnidapter_sdk.models.create_calendar_request import CreateCalendarRequest
+from omnidapter_sdk.models.create_connection_request import CreateConnectionRequest
+from omnidapter_sdk.models.create_connection_response import CreateConnectionResponse
+from omnidapter_sdk.models.create_event_request import CreateEventRequest
+from omnidapter_sdk.models.create_link_token_request import CreateLinkTokenRequest
+from omnidapter_sdk.models.end import End
+from omnidapter_sdk.models.end1 import End1
+from omnidapter_sdk.models.event_list_meta import EventListMeta
+from omnidapter_sdk.models.event_list_response_calendar_event import EventListResponseCalendarEvent
+from omnidapter_sdk.models.event_pagination_meta import EventPaginationMeta
+from omnidapter_sdk.models.event_status import EventStatus
+from omnidapter_sdk.models.event_visibility import EventVisibility
+from omnidapter_sdk.models.free_busy_interval import FreeBusyInterval
+from omnidapter_sdk.models.http_validation_error import HTTPValidationError
+from omnidapter_sdk.models.link_token_data import LinkTokenData
+from omnidapter_sdk.models.list_meta import ListMeta
+from omnidapter_sdk.models.list_response_connection_response import ListResponseConnectionResponse
+from omnidapter_sdk.models.o_auth_metadata import OAuthMetadata
+from omnidapter_sdk.models.o_auth_scope_group import OAuthScopeGroup
+from omnidapter_sdk.models.organizer import Organizer
+from omnidapter_sdk.models.original_start_time import OriginalStartTime
+from omnidapter_sdk.models.pagination_meta import PaginationMeta
+from omnidapter_sdk.models.provider_metadata import ProviderMetadata
+from omnidapter_sdk.models.reauthorize_connection_request import ReauthorizeConnectionRequest
+from omnidapter_sdk.models.reauthorize_connection_response import ReauthorizeConnectionResponse
+from omnidapter_sdk.models.recurrence import Recurrence
+from omnidapter_sdk.models.reminder import Reminder
+from omnidapter_sdk.models.reminder_override import ReminderOverride
+from omnidapter_sdk.models.request_meta import RequestMeta
+from omnidapter_sdk.models.service_kind import ServiceKind
+from omnidapter_sdk.models.start import Start
+from omnidapter_sdk.models.start1 import Start1
+from omnidapter_sdk.models.update_calendar_request import UpdateCalendarRequest
+from omnidapter_sdk.models.update_event_request import UpdateEventRequest
+from omnidapter_sdk.models.validation_error import ValidationError
+from omnidapter_sdk.models.validation_error_loc_inner import ValidationErrorLocInner

omnidapter_sdk-0.3.2/omnidapter_sdk/api/__init__.py

@@ -0,0 +1,8 @@
+# flake8: noqa
+
+# import apis into api package
+from omnidapter_sdk.api.calendar_api import CalendarApi
+from omnidapter_sdk.api.connections_api import ConnectionsApi
+from omnidapter_sdk.api.link_tokens_api import LinkTokensApi
+from omnidapter_sdk.api.providers_api import ProvidersApi
+