first pass at implementation of hits

Author: toph-allen

src/posit/connect/metrics/hits.py

@@ -0,0 +1,27 @@
+from typing_extensions import (
+    Iterable,
+    List,
+    Literal,
+    Protocol,
+    overload,
+)
+
+from ..context import requires
+from ..resources import Resource, ResourceSequence
+
+
+class Hit(Resource, Protocol):
+    pass
+
+
+class Hits(ResourceSequence[Hit], Protocol):
+    pass
+
+
+# TODO:
+# fetch, find_by documentation
+# - fetch function args are gonna be the query params
+# - find_by is the object props
+#   if the server fails with extra query params that'd be bad.
+# tests
+# - reference packages_test file

src/posit/connect/metrics/metrics.py

@@ -1,6 +1,10 @@
 """Metric resources."""
 
+import posixpath
+
 from .. import resources
+from ..context import requires
+from .hits import Hits
 from .usage import Usage
 
 
@@ -16,3 +20,8 @@ class Metrics(resources.Resources):
     @property
     def usage(self) -> Usage:
         return Usage(self._ctx)
+
+    @property
+    @requires(version="2025.04.0")
+    def hits(self) -> Hits:
+        return resources._ResourceSequence(self._ctx, "v1/instrumentation/content/hits", uid="id")