ul-data-logger-api-sdk 3.3.5__tar.gz → 3.4.0__tar.gz

{ul_data_logger_api_sdk-3.3.5 → ul_data_logger_api_sdk-3.4.0}/PKG-INFO

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

{ul_data_logger_api_sdk-3.3.5 → ul_data_logger_api_sdk-3.4.0}/data_logger_api_sdk.py

@@ -25,7 +25,7 @@ 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_device_links import ApiBsDeviceLinkResponse
 from data_logger_api_sdk.types.api_bs_traffic_stats import ApiBsTrafficStatsResponse, ApiDeviceTrafficStatsQuery
 from data_logger_api_sdk.types.api_uplink_signal import (
     ApiDeviceUplinkSignalLatestResponse,
@@ -213,34 +213,27 @@ class DataLoggerApiSdk:
         )
         return ApiDeviceUplinkSignalsListResult(items=items, total_count=total_count)
 
-    def get_bs_device_links(
+    def get_bs_device_links_for_bs(
         self,
+        bs_id: UUID,
         start_at: datetime,
         end_at: datetime | None = None,
-        limit: int = 500,
-        after_bs_id: UUID | None = None,
-        after_device_id: UUID | None = None,
-    ) -> ApiBsDeviceLinksListResult:
-        """GET /bs-device-links — связи «мак ↔ БС» за период («когда-либо» при start_at из далёкого прошлого).
+    ) -> List[ApiBsDeviceLinkResponse]:
+        """GET /bs-device-links?bs_id=… — связи «мак ↔ БС» одной БС за окно (~90 дней ночного синка).
 
-        Keyset-пагинация по (bs_id, device_id): курсор — последняя пара
-        предыдущей страницы; без курсора (первая страница) приходит и
-        total_count. Обход до пустой страницы — для ночного синка слоя
-        «Объекты и устройства».
+        Ответ капится сервером (DL_BS_LINKS_PER_BS_LIMIT, при переполнении
+        дробится окно); дедуп между под-окнами — на потребителе.
         """
-        query: Dict[str, Any] = {"start_at": start_at.isoformat(), "limit": limit}
+        query: Dict[str, Any] = {"bs_id": str(bs_id), "start_at": start_at.isoformat()}
         if end_at is not None:
             query["end_at"] = end_at.isoformat()
-        if after_bs_id is not None and after_device_id is not None:
-            query["after_bs_id"] = str(after_bs_id)
-            query["after_device_id"] = str(after_device_id)
         response = self._api.request(
             method=ApiMethod.GET,
             path="/bs-device-links",
             json=None,
             q=query,
         ).typed(List[ApiBsDeviceLinkResponse]).check()
-        return ApiBsDeviceLinksListResult(items=response.payload, total_count=response.total_count)
+        return response.payload
 
     def get_base_station(
         self,

{ul_data_logger_api_sdk-3.3.5 → ul_data_logger_api_sdk-3.4.0}/pyproject.toml

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

ul_data_logger_api_sdk-3.4.0/types/api_bs_device_links.py

@@ -0,0 +1,15 @@
+from pydantic import UUID4
+from ul_api_utils.api_resource.api_response import JsonApiResponsePayload
+
+
+class ApiBsDeviceLinkResponse(JsonApiResponsePayload):
+    """Связь «мак ↔ БС» за период: элемент ответа GET /bs-device-links.
+
+    bs_id — идентификатор БС Data Logger (у потребителя unified API —
+    external_bs_id); bs_identifier — серийный номер БС.
+    """
+
+    device_network_mac: int
+    bs_id: UUID4
+    device_id: UUID4
+    bs_identifier: str

ul_data_logger_api_sdk-3.3.5/types/api_bs_device_links.py

@@ -1,30 +0,0 @@
-from typing import List, NamedTuple, Optional
-
-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
-    device_id: UUID4
-    bs_identifier: str
-
-
-class ApiBsDeviceLinksListResult(NamedTuple):
-    """Результат спискового вызова: страница элементов и total_count.
-
-    total_count приходит только на первой странице (без курсора); дальше —
-    None, обход идёт до пустой страницы.
-    """
-
-    items: List[ApiBsDeviceLinkResponse]
-    total_count: Optional[int]