phystack-hub-client 0.2.3__tar.gz → 0.2.5__tar.gz

{phystack_hub_client-0.2.3 → phystack_hub_client-0.2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: phystack-hub-client
-Version: 0.2.3
+Version: 0.2.5
 Summary: Python client for PhyHub - events, actions, DataChannel, and MediaStream
 Project-URL: Homepage, https://github.com/phystack/phystack-pypi
 Project-URL: Documentation, https://docs.phystack.com

{phystack_hub_client-0.2.3 → phystack_hub_client-0.2.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "phystack-hub-client"
-version = "0.2.3"
+version = "0.2.5"
 description = "Python client for PhyHub - events, actions, DataChannel, and MediaStream"
 readme = "README.md"
 license = "MIT"

{phystack_hub_client-0.2.3 → phystack_hub_client-0.2.5}/src/phystack/hub_client/__init__.py

@@ -10,6 +10,12 @@ A Python client for PhyHub that provides:
 - Settings API
 
 Usage:
+    from phystack.hub_client import connect_phy_client
+
+    client = await connect_phy_client()
+    instance = await client.get_instance()
+
+Or with context manager:
     from phystack.hub_client import PhyHubClient
 
     async with PhyHubClient.from_env() as client:
@@ -38,7 +44,7 @@ Usage:
         stream = await instance.get_media_stream(peer_twin_id)
 """
 
-from phystack.hub_client.client import PhyHubClient
+from phystack.hub_client.client import PhyHubClient, connect_phy_client
 from phystack.hub_client.types.twin_types import (
     TwinMessageResult,
     TwinMessageResultStatus,
@@ -78,6 +84,7 @@ __version__ = "0.1.0"
 __all__ = [
     # Client
     "PhyHubClient",
+    "connect_phy_client",
     # Instances
     "BaseInstance",
     "EdgeInstance",

{phystack_hub_client-0.2.3 → phystack_hub_client-0.2.5}/src/phystack/hub_client/client.py

@@ -414,10 +414,10 @@ class PhyHubClient:
             "sourceDeviceId": self._connection.device_id,
         }
 
-        # Fire-and-forget subscription using unified emit
-        asyncio.create_task(self._emit_to_socket(self.EVENTS.TWIN_SUBSCRIBE, payload))
-
-        return {"status": "success", "message": "Subscribed"}
+        # Send subscription request with ack (matches Node.js behavior)
+        return await self._emit_to_socket(
+            self.EVENTS.TWIN_SUBSCRIBE, payload, callback=True
+        )
 
     async def get_twin_by_id(self, twin_id: str) -> Optional[dict[str, Any]]:
         """Get twin data by ID.
@@ -797,3 +797,16 @@ class PhyHubClient:
     async def __aexit__(self, exc_type: Any, exc_val: Any, exc_tb: Any) -> None:
         """Async context manager exit."""
         await self.disconnect()
+
+
+async def connect_phy_client() -> PhyHubClient:
+    """Connect to PhyHub in one call (matches Node.js connectPhyClient).
+
+    Reads connection config from environment variables and connects.
+
+    Returns:
+        Connected PhyHubClient instance.
+    """
+    client = PhyHubClient.from_env()
+    await client.connect()
+    return client

{phystack_hub_client-0.2.3 → phystack_hub_client-0.2.5}/src/phystack/hub_client/twin_messaging.py

@@ -12,6 +12,7 @@ API Design:
 """
 
 import asyncio
+import re
 import time
 import random
 import string
@@ -23,6 +24,15 @@ from phystack.hub_client.types.twin_types import TwinMessageResult, TwinMessageR
 
 REQUEST_TIMEOUT = 10.0  # seconds
 
+# Backward compatibility: strip known type prefixes to extract bare event type.
+# Matches Node.js hub-client behavior for cross-approach communication.
+_KNOWN_PREFIX_PATTERN = re.compile(r"^(edgeInstance|peripheralInstance:[^:]+):")
+
+
+def _strip_type_prefix(message_type: str) -> str:
+    """Strip known type prefix to get bare event type (matches Node.js)."""
+    return _KNOWN_PREFIX_PATTERN.sub("", message_type)
+
 
 @dataclass
 class PendingRequest:
@@ -177,7 +187,7 @@ class TwinMessaging:
 
         def handle_response(payload: dict[str, Any]) -> None:
             message_type = (payload.get("data") or {}).get("type") or payload.get("type")
-            if message_type == f"{self._context.type_prefix}:response":
+            if _strip_type_prefix(message_type) == "response":
                 response_data = (payload.get("data") or {}).get("data") or payload.get("data")
                 request_id = (response_data or {}).get("requestId")
 
@@ -220,12 +230,10 @@ class TwinMessaging:
             event_type: Type of event to listen for.
             callback: Handler function (data, respond?) => None
         """
-        expected_type = f"{self._context.type_prefix}:{event_type}"
-
         def handler(payload: dict[str, Any]) -> None:
             message_type = (payload.get("data") or {}).get("type") or payload.get("type")
 
-            if message_type == expected_type:
+            if _strip_type_prefix(message_type) == event_type:
                 message_data = (payload.get("data") or {}).get("data") or payload.get("data")
                 request_id = (message_data or {}).get("requestId") if message_data else None
                 source_twin_id = payload.get("sourceTwinId")