Fix mistyped ID parameters on Templates.load and Hoppers.position

Templates.load(template_id, hopper_id): hopper_id was annotated as
TemplateId, which is structurally identical to HopperId but misleading
in IDE hints — readers might assume the second argument should be a
template ID. Introduce HopperId in the same module and use it.

Hoppers.position(hopper_id, position_id): same flavour of bug —
position_id was annotated as HopperId. Add a PositionId alias and use
it for the second parameter.

Both are docs-only (no runtime change) but matter for static analysis
and developer-experience accuracy.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: pimfeltkamp

src/cryptohopper/resources/hoppers.py

@@ -9,6 +9,7 @@
     from .._client import CryptohopperClient
 
 HopperId = int | str
+PositionId = int | str
 
 
 class Hoppers:
@@ -49,7 +50,7 @@ def positions(self, hopper_id: HopperId) -> Sequence[dict[str, Any]]:
             "GET", "/hopper/positions", params={"hopper_id": hopper_id}
         )
 
-    def position(self, hopper_id: HopperId, position_id: HopperId) -> dict[str, Any]:
+    def position(self, hopper_id: HopperId, position_id: PositionId) -> dict[str, Any]:
         """Fetch a single position. Requires ``read``."""
         return self._client._request(
             "GET",

src/cryptohopper/resources/template.py

@@ -9,6 +9,7 @@
     from .._client import CryptohopperClient
 
 TemplateId = int | str
+HopperId = int | str
 
 
 class Templates:
@@ -44,7 +45,7 @@ def update(
         )
 
     def load(
-        self, template_id: TemplateId, hopper_id: TemplateId
+        self, template_id: TemplateId, hopper_id: HopperId
     ) -> dict[str, Any]:
         """Apply a template to a hopper. Requires ``manage``."""
         return self._client._request(