ul-data-logger-api-sdk 3.3.1__tar.gz → 3.3.3__tar.gz

{ul_data_logger_api_sdk-3.3.1 → ul_data_logger_api_sdk-3.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: ul-data-logger-api-sdk
-Version: 3.3.1
+Version: 3.3.3
 Summary: Data logger API sdk
 Author: Unic-lab
 License-Expression: MIT

{ul_data_logger_api_sdk-3.3.1 → ul_data_logger_api_sdk-3.3.3}/data_logger_api_sdk.py

@@ -26,6 +26,10 @@ from data_logger_api_sdk.types.api_base_stations import (
     ApiBaseStationSystemLogsListResult,
 )
 from data_logger_api_sdk.types.api_bs_traffic_stats import ApiBsTrafficStatsResponse, ApiDeviceTrafficStatsQuery
+from data_logger_api_sdk.types.api_uplink_signal import (
+    ApiDeviceUplinkSignalLatestResponse,
+    ApiDeviceUplinkSignalsListResult,
+)
 from data_logger_api_sdk.types.api_device_data_history import ApiDeviceDataHistoryBody, ApiDeviceDataHistoryResponse
 from data_logger_api_sdk.types.api_last_bs_data_by_device_macs import ApiDeviceLastBsDataResponse, ApiDeviceMacsListBodyModel
 from data_logger_api_sdk.types.api_packet_types import ApiPacketTypesListResponse
@@ -191,6 +195,29 @@ class DataLoggerApiSdk:
         )
         return ApiBaseStationsListResult(items=items, total_count=total_count)
 
+    def get_uplink_signal_latest(
+        self,
+        limit: int,
+        offset: int = 0,
+        macs: List[int] | None = None,
+    ) -> ApiDeviceUplinkSignalsListResult:
+        """GET /uplink-signal-latest — последний uplink-сигнал каждого мака.
+
+        Последний по метеру, группировка по маку (один мак = одна строка);
+        macs — рантайм-фильтр по конкретным устройствам. bs_id —
+        идентификатор БС Data Logger (= external_bs_id потребителя).
+        """
+        query: Dict[str, Any] = {"limit": limit, "offset": offset}
+        if macs:
+            query["mac"] = macs
+        items, total_count = self._request_list_payload_once(
+            ApiMethod.GET,
+            "/uplink-signal-latest",
+            List[ApiDeviceUplinkSignalLatestResponse],  # type: ignore
+            query,
+        )
+        return ApiDeviceUplinkSignalsListResult(items=items, total_count=total_count)
+
     def get_base_station(
         self,
         base_station_id: UUID,

{ul_data_logger_api_sdk-3.3.1 → ul_data_logger_api_sdk-3.3.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "ul-data-logger-api-sdk"
-version = "3.3.1"
+version = "3.3.3"
 description = "Data logger API sdk"
 license = "MIT"
 requires-python = ">=3.14"

{ul_data_logger_api_sdk-3.3.1 → ul_data_logger_api_sdk-3.3.3}/types/api_base_stations.py

@@ -65,7 +65,12 @@ class ApiBaseStationDetailResponse(ApiBaseStationResponse):
 
 
 class ApiBaseStationLogResponse(JsonApiResponsePayload):
-    """Элемент ответа GET /base-stations/<uuid>/logs (ApiBsLogsResponse на стороне Data Logger)."""
+    """Элемент ответа GET /base-stations/<uuid>/logs (ApiBsLogsResponse на стороне Data Logger).
+
+    rssi/snr/protocol_type/packet_type_name/network_sys_type/error_* обогащаются
+    из сырого документа пакета (блок meta.bs_http / meta.nbfi_bs0); null, если
+    документа нет или в нём нет этих полей.
+    """
 
     id: UUID4
     date_created: datetime
@@ -83,6 +88,14 @@ class ApiBaseStationLogResponse(JsonApiResponsePayload):
 
     external_document_id: UUID4 | None = None
 
+    rssi: int | None = None
+    snr: int | None = None
+    protocol_type: str | None = None
+    packet_type_name: str | None = None
+    network_sys_type: str | None = None
+    error_message: str | None = None
+    error_type: str | None = None
+
 
 class ApiBaseStationLogDetailResponse(ApiBaseStationLogResponse):
     """Ответ GET /base-stations/<uuid>/logs/<uuid> — лог с сырым JSON пакета (ApiBsLogDetailResponse в DL)."""

ul_data_logger_api_sdk-3.3.3/types/api_uplink_signal.py

@@ -0,0 +1,29 @@
+from datetime import datetime
+from typing import List, NamedTuple
+
+from pydantic import UUID4
+from ul_api_utils.api_resource.api_response import JsonApiResponsePayload
+
+
+class ApiDeviceUplinkSignalLatestResponse(JsonApiResponsePayload):
+    """Последний uplink-сигнал мака: элемент ответа GET /uplink-signal-latest.
+
+    bs_id — идентификатор базовой станции Data Logger (у потребителя unified
+    API это external_bs_id, маппинг по серийнику не нужен); bs_identifier —
+    серийный номер БС. packet_date — время последнего пакета устройства.
+    """
+
+    mac: int
+    device_id: UUID4
+    bs_id: UUID4 | None = None
+    bs_identifier: str | None = None
+    rssi: int | None = None
+    snr: int | None = None
+    packet_date: datetime | None = None
+
+
+class ApiDeviceUplinkSignalsListResult(NamedTuple):
+    """Результат спискового вызова: страница элементов и total_count."""
+
+    items: List[ApiDeviceUplinkSignalLatestResponse]
+    total_count: int