dimo-python-sdk 1.4.0__tar.gz → 1.6.0__tar.gz

{dimo_python_sdk-1.4.0 → dimo_python_sdk-1.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: dimo-python-sdk
-Version: 1.4.0
+Version: 1.6.0
 Summary: DIMO SDK in Python
 Author-email: Barrett Kowalsky <barrettkowalsky@gmail.com>
 Project-URL: Homepage, https://github.com/DIMO-Network/dimo-python-sdk

dimo_python_sdk-1.6.0/dimo/api/attestation.py

@@ -0,0 +1,138 @@
+from dimo.errors import check_type, check_optional_type
+from typing import Optional
+
+
+class Attestation:
+    def __init__(self, request_method, get_auth_headers):
+        self._request = request_method
+        self._get_auth_headers = get_auth_headers
+
+    def create_vin_vc(self, vehicle_jwt: str, token_id: int) -> dict:
+        """
+        Generate cryptographic proof of a vehicle's VIN or retrieve existing unexpired attestation.
+
+        Args:
+            vehicle_jwt (str): Authentication JWT token
+            token_id (int): Vehicle token identifier
+
+        Returns:
+            dict: Response containing vcUrl, vcQuery, and confirmation message
+        """
+        check_type("vehicle_jwt", vehicle_jwt, str)
+        check_type("token_id", token_id, int)
+        url = f"/v2/attestation/vin/{token_id}"
+        return self._request(
+            "POST",
+            "Attestation",
+            url,
+            headers=self._get_auth_headers(vehicle_jwt),
+        )
+
+    def create_pom_vc(self, vehicle_jwt: str, token_id: int) -> dict:
+        """
+        Create proof of movement verifiable credential (v1 API).
+
+        Args:
+            vehicle_jwt (str): Authentication JWT token
+            token_id (int): Vehicle token identifier
+
+        Returns:
+            dict: Response from the API
+        """
+        check_type("vehicle_jwt", vehicle_jwt, str)
+        check_type("token_id", token_id, int)
+        url = f"/v1/vc/pom/{token_id}"
+        return self._request(
+            "POST", "Attestation", url, headers=self._get_auth_headers(vehicle_jwt)
+        )
+
+    def create_odometer_statement(
+        self, vehicle_jwt: str, token_id: int, timestamp: Optional[str] = None
+    ) -> dict:
+        """
+        Produce verifiable odometer reading attestation.
+
+        Args:
+            vehicle_jwt (str): Authentication JWT token
+            token_id (int): Vehicle token identifier
+            timestamp (str, optional): Specific moment for reading (ISO 8601 format)
+
+        Returns:
+            dict: Success message directing to telemetry-api retrieval
+        """
+        check_type("vehicle_jwt", vehicle_jwt, str)
+        check_type("token_id", token_id, int)
+        check_optional_type("timestamp", timestamp, str)
+
+        url = f"/v2/attestation/odometer-statement/{token_id}"
+        data = {}
+        if timestamp:
+            data["timestamp"] = timestamp
+
+        return self._request(
+            "POST",
+            "Attestation",
+            url,
+            headers=self._get_auth_headers(vehicle_jwt),
+            data=data if data else None,
+        )
+
+    def create_vehicle_health(
+        self, vehicle_jwt: str, token_id: int, start_time: str, end_time: str
+    ) -> dict:
+        """
+        Generate health status verification for specified timeframe.
+
+        Args:
+            vehicle_jwt (str): Authentication JWT token
+            token_id (int): Vehicle token identifier
+            start_time (str): Report beginning (ISO 8601 format)
+            end_time (str): Report conclusion (ISO 8601 format)
+
+        Returns:
+            dict: Success message with telemetry-api retrieval instructions
+        """
+        check_type("vehicle_jwt", vehicle_jwt, str)
+        check_type("token_id", token_id, int)
+        check_type("start_time", start_time, str)
+        check_type("end_time", end_time, str)
+
+        url = f"/v2/attestation/vehicle-health/{token_id}"
+        data = {"startTime": start_time, "endTime": end_time}
+
+        return self._request(
+            "POST",
+            "Attestation",
+            url,
+            headers=self._get_auth_headers(vehicle_jwt),
+            data=data,
+        )
+
+    def create_vehicle_position(
+        self, vehicle_jwt: str, token_id: int, timestamp: str
+    ) -> dict:
+        """
+        Produce location verification at specified moment.
+
+        Args:
+            vehicle_jwt (str): Authentication JWT token
+            token_id (int): Vehicle token identifier
+            timestamp (str): Location snapshot timing (ISO 8601 format)
+
+        Returns:
+            dict: Success message with telemetry-api retrieval instructions
+        """
+        check_type("vehicle_jwt", vehicle_jwt, str)
+        check_type("token_id", token_id, int)
+        check_type("timestamp", timestamp, str)
+
+        url = f"/v2/attestation/vehicle-position/{token_id}"
+        data = {"timestamp": timestamp}
+
+        return self._request(
+            "POST",
+            "Attestation",
+            url,
+            headers=self._get_auth_headers(vehicle_jwt),
+            data=data,
+        )

dimo_python_sdk-1.4.0/dimo/api/vehicle_events.py → dimo_python_sdk-1.6.0/dimo/api/vehicle_triggers.py

@@ -1,7 +1,7 @@
 from dimo.errors import check_type
 
 
-class VehicleEvents:
+class VehicleTriggers:
 
     def __init__(self, request_method, get_auth_headers):
         self._request = request_method
@@ -14,7 +14,7 @@ class VehicleEvents:
         check_type("developer_jwt", developer_jwt, str)
         url = f"/v1/webhooks"
         return self._request(
-            "GET", "VehicleEvents", url, headers=self._get_auth_headers(developer_jwt)
+            "GET", "VehicleTriggers", url, headers=self._get_auth_headers(developer_jwt)
         )
 
     def register_webhook(self, developer_jwt: str, request: object):
@@ -26,7 +26,7 @@ class VehicleEvents:
         url = f"/v1/webhooks"
         return self._request(
             "POST",
-            "VehicleEvents",
+            "VehicleTriggers",
             url,
             headers=self._get_auth_headers(developer_jwt),
             data=request,
@@ -39,21 +39,21 @@ class VehicleEvents:
         check_type("developer_jwt", developer_jwt, str)
         url = f"/v1/webhooks/signals"
         return self._request(
-            "GET", "VehicleEvents", url, headers=self._get_auth_headers(developer_jwt)
+            "GET", "VehicleTriggers", url, headers=self._get_auth_headers(developer_jwt)
         )
 
-    def list_vehicle_subscriptions(self, developer_jwt: str, token_id: str):
+    def list_vehicle_subscriptions(self, developer_jwt: str, token_did: str):
         """
         Lists all webhooks that a specified vehicle token id is subscribed to
         """
         check_type("developer_jwt", developer_jwt, str)
-        check_type("token_id", token_id, str)
-        url = f"/v1/webhooks/vehicles/{token_id}"
+        check_type("token_id", token_did, str)
+        url = f"/v1/webhooks/vehicles/{token_did}"
         return self._request(
-            "GET", "VehicleEvents", url, headers=self._get_auth_headers(developer_jwt)
+            "GET", "VehicleTriggers", url, headers=self._get_auth_headers(developer_jwt)
         )
 
-    def list_vehicle_subscriptions_by_event(self, developer_jwt: str, webhook_id: str):
+    def list_vehicle_subscriptions_by_trigger(self, developer_jwt: str, webhook_id: str):
         """
         Lists all vehicle subscriptions for a given webhook id
         """
@@ -61,7 +61,7 @@ class VehicleEvents:
         check_type("webhook_id", webhook_id, str)
         url = f"/v1/webhooks/{webhook_id}"
         return self._request(
-            "GET", "VehicleEvents", url, headers=self._get_auth_headers(developer_jwt)
+            "GET", "VehicleTriggers", url, headers=self._get_auth_headers(developer_jwt)
         )
 
     def update_webhook(self, developer_jwt: str, webhook_id: str, request: object):
@@ -74,7 +74,7 @@ class VehicleEvents:
         url = f"/v1/webhooks/{webhook_id}"
         return self._request(
             "PUT",
-            "VehicleEvents",
+            "VehicleTriggers",
             url,
             headers=self._get_auth_headers(developer_jwt),
             data=request,
@@ -89,7 +89,7 @@ class VehicleEvents:
         url = f"/v1/webhooks/{webhook_id}"
         return self._request(
             "DELETE",
-            "VehicleEvents",
+            "VehicleTriggers",
             url,
             headers=self._get_auth_headers(developer_jwt),
         )
@@ -102,19 +102,19 @@ class VehicleEvents:
         check_type("webhook_id", webhook_id, str)
         url = f"/v1/webhooks/{webhook_id}/subscribe/all"
         return self._request(
-            "POST", "VehicleEvents", url, headers=self._get_auth_headers(developer_jwt)
+            "POST", "VehicleTriggers", url, headers=self._get_auth_headers(developer_jwt)
         )
 
-    def subscribe_vehicle(self, developer_jwt: str, token_id: str, webhook_id: str):
+    def subscribe_vehicle(self, developer_jwt: str, token_did: str, webhook_id: str):
         """
         Subscribes a single vehicle to a specified webhook
         """
         check_type("developer_jwt", developer_jwt, str)
-        check_type("token_id", token_id, str)
+        check_type("token_id", token_did, str)
         check_type("webhook_id", webhook_id, str)
-        url = f"/v1/webhooks/{webhook_id}/subscribe/{token_id}"
+        url = f"/v1/webhooks/{webhook_id}/subscribe/{token_did}"
         return self._request(
-            "POST", "VehicleEvents", url, headers=self._get_auth_headers(developer_jwt)
+            "POST", "VehicleTriggers", url, headers=self._get_auth_headers(developer_jwt)
         )
 
     def unsubscribe_all_vehicles(self, developer_jwt: str, webhook_id: str):
@@ -126,22 +126,22 @@ class VehicleEvents:
         url = f"/v1/webhooks/{webhook_id}/unsubscribe/all"
         return self._request(
             "DELETE",
-            "VehicleEvents",
+            "VehicleTriggers",
             url,
             headers=self._get_auth_headers(developer_jwt),
         )
 
-    def unsubscribe_vehicle(self, developer_jwt: str, token_id: str, webhook_id: str):
+    def unsubscribe_vehicle(self, developer_jwt: str, token_did: str, webhook_id: str):
         """
         Unsubscribes a single vehicle from a specified webhook
         """
         check_type("developer_jwt", developer_jwt, str)
-        check_type("token_id", token_id, str)
+        check_type("token_id", token_did, str)
         check_type("webhook_id", webhook_id, str)
-        url = f"/v1/webhooks/{webhook_id}/unsubscribe/{token_id}"
+        url = f"/v1/webhooks/{webhook_id}/unsubscribe/{token_did}"
         return self._request(
             "DELETE",
-            "VehicleEvents",
+            "VehicleTriggers",
             url,
             headers=self._get_auth_headers(developer_jwt),
         )

{dimo_python_sdk-1.4.0 → dimo_python_sdk-1.6.0}/dimo/dimo.py

@@ -6,7 +6,7 @@ from .api.device_definitions import DeviceDefinitions
 from .api.token_exchange import TokenExchange
 from .api.trips import Trips
 from .api.valuations import Valuations
-from .api.vehicle_events import VehicleEvents
+from .api.vehicle_triggers import VehicleTriggers
 
 from .graphql.identity import Identity
 from .graphql.telemetry import Telemetry
@@ -84,7 +84,7 @@ class DIMO:
             "valuations": (Valuations, ("request", "_get_auth_headers")),
             "identity": (Identity, ("self",)),
             "telemetry": (Telemetry, ("self",)),
-            "vehicle_events": (VehicleEvents, ("request", "_get_auth_headers")),
+            "vehicle_triggers": (VehicleTriggers, ("request", "_get_auth_headers")),
         }
         if name in mapping:
             cls, deps = mapping[name]

{dimo_python_sdk-1.4.0 → dimo_python_sdk-1.6.0}/dimo/environments.py

@@ -9,7 +9,7 @@ dimo_environment = {
         "Trips": "https://trips-api.dimo.zone",
         "User": "https://users-api.dimo.zone",
         "Valuations": "https://valuations-api.dimo.zone",
-        "VehicleEvents": "https://vehicle-events-api.dimo.zone",
+        "VehicleTriggers": "https://vehicle-triggers-api.dimo.zone",
     },
     "Dev": {
         "Attestation": "https://attestation-api.dev.dimo.zone",
@@ -21,6 +21,6 @@ dimo_environment = {
         "Trips": "https://trips-api.dev.dimo.zone",
         "User": "https://users-api.dev.dimo.zone",
         "Valuations": "https://valuations-api.dev.dimo.zone",
-        "VehicleEvents": "https://vehicle-events-api.dev.dimo.zone",
+        "VehicleTriggers": "https://vehicle-triggers-api.dev.dimo.zone",
     },
 }

{dimo_python_sdk-1.4.0 → dimo_python_sdk-1.6.0}/dimo_python_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: dimo-python-sdk
-Version: 1.4.0
+Version: 1.6.0
 Summary: DIMO SDK in Python
 Author-email: Barrett Kowalsky <barrettkowalsky@gmail.com>
 Project-URL: Homepage, https://github.com/DIMO-Network/dimo-python-sdk

{dimo_python_sdk-1.4.0 → dimo_python_sdk-1.6.0}/dimo_python_sdk.egg-info/SOURCES.txt

@@ -16,7 +16,7 @@ dimo/api/device_definitions.py
 dimo/api/token_exchange.py
 dimo/api/trips.py
 dimo/api/valuations.py
-dimo/api/vehicle_events.py
+dimo/api/vehicle_triggers.py
 dimo/graphql/__init__.py
 dimo/graphql/identity.py
 dimo/graphql/telemetry.py

{dimo_python_sdk-1.4.0 → dimo_python_sdk-1.6.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "dimo-python-sdk"
-version = "1.4.0"
+version = "1.6.0"
 authors = [
   { name="Barrett Kowalsky", email="barrettkowalsky@gmail.com" },
 ]

dimo_python_sdk-1.4.0/dimo/api/attestation.py

@@ -1,28 +0,0 @@
-from dimo.errors import check_type
-
-
-class Attestation:
-    def __init__(self, request_method, get_auth_headers):
-        self._request = request_method
-        self._get_auth_headers = get_auth_headers
-
-    def create_vin_vc(self, vehicle_jwt: str, token_id: int) -> dict:
-        check_type("vehicle_jwt", vehicle_jwt, str)
-        check_type("token_id", token_id, int)
-        params = {"force": True}
-        url = f"/v1/vc/vin/{token_id}"
-        return self._request(
-            "POST",
-            "Attestation",
-            url,
-            params=params,
-            headers=self._get_auth_headers(vehicle_jwt),
-        )
-
-    def create_pom_vc(self, vehicle_jwt: str, token_id: int) -> dict:
-        check_type("vehicle_jwt", vehicle_jwt, str)
-        check_type("token_id", token_id, int)
-        url = f"/v1/vc/pom/{token_id}"
-        return self._request(
-            "POST", "Attestation", url, headers=self._get_auth_headers(vehicle_jwt)
-        )