espark-core 0.4.7__py3-none-any.whl → 0.4.9__py3-none-any.whl

{espark_core-0.4.7.dist-info → espark_core-0.4.9.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: espark-core
-Version: 0.4.7
+Version: 0.4.9
 Summary: The core module of the Espark ESP32-based IoT device management framework.
 License: MIT
 Requires-Python: >=3.8
@@ -8,13 +8,14 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: aiomqtt>=2.4.0
 Requires-Dist: apscheduler>=3.11.1
-Requires-Dist: fastapi>=0.124.2
+Requires-Dist: fastapi>=0.124.4
 Requires-Dist: packaging>=25.0
+Requires-Dist: slack-sdk==3.39.0
 Requires-Dist: sqlalchemy>=2.0.45
 Requires-Dist: sqlmodel>=0.0.27
 Requires-Dist: uvicorn[standard]>=0.38.0
 Provides-Extra: dev
-Requires-Dist: aiosqlite==0.21.0; extra == "dev"
+Requires-Dist: aiosqlite==0.22.0; extra == "dev"
 Requires-Dist: autopep8==2.3.2; extra == "dev"
 Requires-Dist: build==1.3.0; extra == "dev"
 Requires-Dist: fastapi-cli[standard-no-fastapi-cloud-cli]==0.0.16; extra == "dev"

{espark_core-0.4.7.dist-info → espark_core-0.4.9.dist-info}/RECORD

@@ -1,10 +1,10 @@
-espark_core-0.4.7.dist-info/licenses/LICENSE,sha256=wkIXJHYIspOGVvn_ajKyLucpIyw9_pO3QExFcNTCY78,1065
+espark_core-0.4.9.dist-info/licenses/LICENSE,sha256=wkIXJHYIspOGVvn_ajKyLucpIyw9_pO3QExFcNTCY78,1065
 esparkcore/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-esparkcore/constants.py,sha256=uI0bVa78CZa-ftlyTRMqWSBK275iDB1l8g1TmtJ1FGg,378
+esparkcore/constants.py,sha256=v5D_z1nST50FpA5FvpGYz9rk6wngQleCyFU1wtmk58I,417
 esparkcore/data/__init__.py,sha256=abMOPq6jC5qOQCl9j7iPDv8iyjzDF-oVd_gW0la5kL4,45
 esparkcore/data/database.py,sha256=OaJSBDW6Qge-rsKkSIksJXOg3xF_y6LuBew--6uFbG4,532
 esparkcore/data/models/__init__.py,sha256=9YBRwn7R_aovQjT-ZR64fBm7TPs0dsjoq3LzsUTaRtA,124
-esparkcore/data/models/device.py,sha256=HQr941uabovQpyGZ1fOnsBNSU_LVmB7JQIZuDkk1uis,1086
+esparkcore/data/models/device.py,sha256=a1Tfw8xHzDLEiVxANZ-lR2aVaWaWJFa8tZQwHBzDgu0,1135
 esparkcore/data/models/outbox.py,sha256=r5bgjIbj9H-OsGhE-CWKGRf4Tp88qMvmxPYHNGOApY4,1309
 esparkcore/data/models/telemetry.py,sha256=OfzGqGj2Y1sdK519sSOEXhfuErHoeEdpy5qmJMIc27A,652
 esparkcore/data/models/version.py,sha256=h2O_Owx-exx5tiQiiauCSELkUHDx-QZjiIGqFPybT4M,269
@@ -14,19 +14,22 @@ esparkcore/data/repositories/device_repository.py,sha256=P9KK-Ta9MgMdrnct5hbGEoi
 esparkcore/data/repositories/outbox_repository.py,sha256=PdPyKq2Km4_7732O6HhA4BlV_zBjYF91GkMltNKUovg,1015
 esparkcore/data/repositories/telemetry_repository.py,sha256=5UBBmY-ugcgP0Xji7cu58_nGt8MWKeHz9DHNVJxk0BY,1116
 esparkcore/data/repositories/version_repository.py,sha256=QZZX2BpFx1i0oeFJ6j0nZvlZH7cViKU8VERBE8AU3ZY,395
+esparkcore/notifications/__init__.py,sha256=WrdUPsRS0tg2rAhv4aj4eGDekkfAsKjcRPRlT6btzQs,77
+esparkcore/notifications/notifier.py,sha256=d4a8leU-oTwWe7ZTLw-vxfCrYlFnCIvbcXabiXkT6Lc,446
+esparkcore/notifications/slack_notifier.py,sha256=-H-3YYm0CRTV8pZgggrNPJKz6815HTumKvE7VsvvSAA,644
 esparkcore/routers/__init__.py,sha256=K8-S0hugkQT5DB8i8O5YqeRsu9fGfLep6UQzCIpdgGg,131
 esparkcore/routers/base_router.py,sha256=t-x8tYZVzBk9bD__9yaGYhm66glq_oM_lAHn0eplM2M,3902
 esparkcore/routers/device_router.py,sha256=mIBAyTyxl9AF8Os_Sms6Bb0vEvWfljyElbTWEGLo0iU,1172
 esparkcore/routers/telemetry_router.py,sha256=sLO5-oN73IjdGC_ASNif5xmVZHjka_iLv0BKZ_deZP0,1981
-esparkcore/routers/version_router.py,sha256=zoOteeK4Cs-OIk_k2v7vPwpR-OfLBwYhOUhNZjPYfHs,387
+esparkcore/routers/version_router.py,sha256=7HYD6sbGWow3DDvK62RXPZu5Qz8DCTTs7wkksQKBq9c,383
 esparkcore/schedules/__init__.py,sha256=v5Wy3Cbt2AnudGMGXv_Cyaa10s6NAmP66rDjcMSvf0o,74
 esparkcore/schedules/outbox.py,sha256=GGANvjkI7w1BdmmVRgKog498ASD_xRN0g8bG6yC_SN4,811
 esparkcore/schedules/scheduler.py,sha256=aYQXImLZ4tW-hRavn3ObuV3lYjmOZD813YkeG1NsYfY,170
 esparkcore/services/__init__.py,sha256=RIZOHBfkWn3HsApdA5rH9EZbbXGq0NfiGoOWDO_JX1k,30
-esparkcore/services/mqtt.py,sha256=Ey2pEkG8sTgX7MQqX1z3Y_5ATwBnacJuf18F_u59_lg,6575
+esparkcore/services/mqtt.py,sha256=EFRVT7QYEpWFhTopS2T6J5O69NWbxeuBQnytCjvd23k,6379
 esparkcore/utils/__init__.py,sha256=rzuCJUAaQl-yPhM1vcWB_1zVXqtA71ChYP2aM_3UfKk,42
 esparkcore/utils/logging.py,sha256=sRO8uOcPkFH-DwepqLOTS2qGaopXpMdVOjzZL6RpGs4,257
-espark_core-0.4.7.dist-info/METADATA,sha256=faFvfPL1qF0ika4MKD-VbLFL8ZTis3XAmk5zHr7HQeE,6296
-espark_core-0.4.7.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-espark_core-0.4.7.dist-info/top_level.txt,sha256=hXVyhIPB4aGskFm5queWALxDPhcDkrN7_8vcjwA1iE4,11
-espark_core-0.4.7.dist-info/RECORD,,
+espark_core-0.4.9.dist-info/METADATA,sha256=kCGaK8PkyR5DMoJCxhwk56RN4sz91l9lJS5CW-bB2xo,6329
+espark_core-0.4.9.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+espark_core-0.4.9.dist-info/top_level.txt,sha256=hXVyhIPB4aGskFm5queWALxDPhcDkrN7_8vcjwA1iE4,11
+espark_core-0.4.9.dist-info/RECORD,,

esparkcore/constants.py

@@ -1,6 +1,7 @@
 ENV_DATABASE_URL : str = 'DATABASE_URL'
 ENV_MQTT_HOST    : str = 'MQTT_HOST'
 ENV_MQTT_PORT    : str = 'MQTT_PORT'
+ENV_UPLOAD_PATH  : str = 'UPLOAD_PATH'
 
 TOPIC_ACTION       : str = 'espark/action'
 TOPIC_DEVICE       : str = 'espark/device'

esparkcore/data/models/device.py

@@ -8,7 +8,7 @@ from sqlmodel import SQLModel, Field, JSON
 class Device(SQLModel, table=True):
     id           : str                         = Field(primary_key=True, description='Unique identifier for the device')
     display_name : Optional[str]               = Field(default=None, description='Human-readable name of the device')
-    app_name     : Optional[str]               = Field(default=None, description='Name of the application running on the device')
+    app_name     : Optional[str]               = Field(default=None, foreign_key='appversion.id', ondelete='CASCADE', description='Name of the application running on the device')
     app_version  : Optional[str]               = Field(default=None, description='Version of the application running on the device')
     capabilities : Optional[str]               = Field(default=None, description='Comma separated capabilities of the device')
     parameters   : Dict[str, str | int | bool] = Field(default_factory=dict, sa_column=Column(JSON), description='JSON string of capability-specific parameters')

esparkcore/notifications/__init__.py

@@ -0,0 +1,2 @@
+from .notifier import BaseNotifier
+from .slack_notifier import SlackNotifier

esparkcore/notifications/notifier.py

@@ -0,0 +1,14 @@
+from abc import ABC, abstractmethod
+
+
+class BaseNotifier(ABC):
+    @abstractmethod
+    async def notify(self, device_id: str, event_type: str, value: int) -> None:
+        """
+        Send a notification for an event.
+
+        Args:
+            device_id: ID of the device generating the event.
+            event_type: Type of the event (human presence, door open, etc).
+            value: An integer value associated with the event.
+        """

esparkcore/notifications/slack_notifier.py

@@ -0,0 +1,17 @@
+from slack_sdk import WebClient
+
+from ..utils import log_debug
+from .notifier import BaseNotifier
+
+
+class SlackNotifier(BaseNotifier):
+    def __init__(self, slack_token: str, slack_channel: str) -> None:
+        self.slack_token   = slack_token
+        self.slack_channel = slack_channel
+
+    async def notify(self, device_id: str, event_type: str, value: int) -> None:
+        client = WebClient(token=self.slack_token)
+
+        log_debug(f'Posting {event_type} event to Slack for device {device_id}: {value}')
+
+        client.chat_postMessage(channel=self.slack_channel, text=f'Device {device_id} reported {event_type} with value {value}.')

esparkcore/routers/version_router.py

@@ -7,4 +7,4 @@ class AppVersionRouter(BaseRouter):
     def __init__(self, repo: AppVersionRepository = None) -> None:
         self.repo : AppVersionRepository = repo or AppVersionRepository()
 
-        super().__init__(AppVersion, self.repo, '/api/v1/versions', ['version'])
+        super().__init__(AppVersion, self.repo, '/api/v1/apps', ['version'])

esparkcore/services/mqtt.py

@@ -32,10 +32,7 @@ class MQTTManager:
             async with async_session() as session:
                 device = await self.device_repo.get(session, Device.id == device_id)
                 if device:
-                    device.app_name     = payload['app_name']
-                    device.app_version  = payload['app_version']
-                    device.capabilities = payload['capabilities']
-                    device.last_seen    = datetime.now(timezone.utc)
+                    device.last_seen = datetime.now(timezone.utc)
 
                     await self.device_repo.update(session, device, last_seen=datetime.now(timezone.utc))
                 else: