ul-data-logger-api-sdk 3.3.2__tar.gz → 3.3.4__tar.gz

{ul_data_logger_api_sdk-3.3.2 → ul_data_logger_api_sdk-3.3.4}/PKG-INFO

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

{ul_data_logger_api_sdk-3.3.2 → ul_data_logger_api_sdk-3.3.4}/data_logger_api_sdk.py

@@ -25,7 +25,12 @@ from data_logger_api_sdk.types.api_base_stations import (
     ApiBaseStationSystemLogResponse,
     ApiBaseStationSystemLogsListResult,
 )
+from data_logger_api_sdk.types.api_bs_device_links import ApiBsDeviceLinkResponse, ApiBsDeviceLinksListResult
 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 +196,52 @@ 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_bs_device_links(
+        self,
+        start_at: datetime,
+        end_at: datetime | None = None,
+        limit: int = 500,
+        offset: int = 0,
+    ) -> ApiBsDeviceLinksListResult:
+        """GET /bs-device-links — связи «мак ↔ БС» за период («когда-либо» при start_at из далёкого прошлого).
+
+        Один запрос по журналу device_log (дистинкт по паре мак+БС) вместо
+        обхода всех БС; для ночного синка слоя «Объекты и устройства».
+        """
+        query: Dict[str, Any] = {"start_at": start_at.isoformat(), "limit": limit, "offset": offset}
+        if end_at is not None:
+            query["end_at"] = end_at.isoformat()
+        items, total_count = self._request_list_payload_once(
+            ApiMethod.GET,
+            "/bs-device-links",
+            List[ApiBsDeviceLinkResponse],  # type: ignore
+            query,
+        )
+        return ApiBsDeviceLinksListResult(items=items, total_count=total_count)
+
     def get_base_station(
         self,
         base_station_id: UUID,

{ul_data_logger_api_sdk-3.3.2 → ul_data_logger_api_sdk-3.3.4}/pyproject.toml

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

ul_data_logger_api_sdk-3.3.4/types/api_bs_device_links.py

@@ -0,0 +1,25 @@
+from typing import List, NamedTuple
+
+from pydantic import UUID4
+from ul_api_utils.api_resource.api_response import JsonApiResponsePayload
+
+
+class ApiBsDeviceLinkResponse(JsonApiResponsePayload):
+    """Связь «мак ↔ БС» за период: элемент ответа GET /bs-device-links.
+
+    Пара существует, если БС когда-либо получала пакет устройства в
+    запрошенном окне (дистинкт по журналу device_log). bs_id — идентификатор
+    БС Data Logger (у потребителя unified API это external_bs_id);
+    bs_identifier — её серийный номер.
+    """
+
+    device_network_mac: int
+    bs_id: UUID4
+    bs_identifier: str
+
+
+class ApiBsDeviceLinksListResult(NamedTuple):
+    """Результат спискового вызова: страница элементов и total_count."""
+
+    items: List[ApiBsDeviceLinkResponse]
+    total_count: int

ul_data_logger_api_sdk-3.3.4/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