noxhere 0.1.0__tar.gz

noxhere-0.1.0/.gitignore

@@ -0,0 +1,5 @@
+__pycache__/
+*.py[cod]
+dist/
+build/
+*.egg-info/

noxhere-0.1.0/PKG-INFO

@@ -0,0 +1,32 @@
+Metadata-Version: 2.5
+Name: noxhere
+Version: 0.1.0
+Summary: Unified Python SDK for every NoxHere resource
+Project-URL: Homepage, https://app.noxhere.com
+Project-URL: Repository, https://github.com/No-Box-Dev/NoxHere
+Author: No Box Dev
+License: PolyForm-Noncommercial-1.0.0
+Keywords: activity,feedback,incidents,noxhere,planning
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# `noxhere`
+
+The unified Python client for every NoxHere resource. Its 149-operation
+catalog is generated from the same OpenAPI contract as `@noxhere/sdk`.
+
+```python
+from noxhere import NoxHereClient
+
+nox = NoxHereClient(token="nox_sk_...")
+projects = nox.workspace.list_projects()
+incidents = nox.incidents.get_project_incidents(path={"projectId": "project-1"})
+```
+
+Namespaces are `workspace`, `activity`, `planning`, `feedback`, and
+`incidents`; `connect`, `feed`, `ticket`, `spot`, and `cue` are compatibility
+aliases. Use `noxhere.incidents.create_incident_client` or
+`noxhere.feedback.create_feedback_client` for focused clients.

noxhere-0.1.0/README.md

@@ -0,0 +1,17 @@
+# `noxhere`
+
+The unified Python client for every NoxHere resource. Its 149-operation
+catalog is generated from the same OpenAPI contract as `@noxhere/sdk`.
+
+```python
+from noxhere import NoxHereClient
+
+nox = NoxHereClient(token="nox_sk_...")
+projects = nox.workspace.list_projects()
+incidents = nox.incidents.get_project_incidents(path={"projectId": "project-1"})
+```
+
+Namespaces are `workspace`, `activity`, `planning`, `feedback`, and
+`incidents`; `connect`, `feed`, `ticket`, `spot`, and `cue` are compatibility
+aliases. Use `noxhere.incidents.create_incident_client` or
+`noxhere.feedback.create_feedback_client` for focused clients.

noxhere-0.1.0/pyproject.toml

@@ -0,0 +1,33 @@
+[build-system]
+requires = ["hatchling>=1.27"]
+build-backend = "hatchling.build"
+
+[project]
+name = "noxhere"
+version = "0.1.0"
+description = "Unified Python SDK for every NoxHere resource"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "PolyForm-Noncommercial-1.0.0" }
+authors = [{ name = "No Box Dev" }]
+keywords = ["noxhere", "activity", "planning", "feedback", "incidents"]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Typing :: Typed",
+]
+
+[project.urls]
+Homepage = "https://app.noxhere.com"
+Repository = "https://github.com/No-Box-Dev/NoxHere"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/noxhere"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/noxhere", "tests", "scripts", "README.md", "pyproject.toml"]
+
+[tool.pyright]
+include = ["src", "tests"]
+pythonVersion = "3.10"
+typeCheckingMode = "strict"

noxhere-0.1.0/scripts/generate_operations.py

@@ -0,0 +1,44 @@
+from __future__ import annotations
+
+import json
+import sys
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parents[3]
+OPENAPI = ROOT / "public" / "openapi.json"
+OUTPUT = Path(__file__).resolve().parents[1] / "src" / "noxhere" / "_operations.py"
+METHODS = {"get", "post", "put", "patch", "delete"}
+NAMESPACES = {
+    "NoxConnect": "workspace",
+    "Activity": "activity",
+    "NoxTicket": "planning",
+    "NoxSpot": "feedback",
+    "NoxCue": "incidents",
+}
+
+document = json.loads(OPENAPI.read_text())
+operations: list[tuple[str, str, str, str]] = []
+for path, path_item in document["paths"].items():
+    for method, operation in path_item.items():
+        if method not in METHODS or "operationId" not in operation:
+            continue
+        tag = operation.get("tags", [None])[0]
+        namespace = NAMESPACES.get(tag)
+        if namespace is None:
+            raise RuntimeError(f"No SDK namespace for {operation['operationId']} tag {tag}")
+        operations.append((operation["operationId"], method.upper(), path, namespace))
+operations.sort()
+if len({operation[0] for operation in operations}) != len(operations):
+    raise RuntimeError("OpenAPI operationId values must be unique")
+
+content = (
+    "# Generated from public/openapi.json. Do not edit by hand.\n"
+    "from typing import Final\n\n"
+    f"OPERATIONS: Final = {operations!r}\n"
+)
+if "--check" in sys.argv:
+    if not OUTPUT.exists() or OUTPUT.read_text() != content:
+        raise SystemExit(f"{OUTPUT} is stale; run python scripts/generate_operations.py")
+else:
+    OUTPUT.write_text(content)
+    print(f"Generated {len(operations)} operations in {OUTPUT}")

noxhere-0.1.0/src/noxhere/__init__.py

@@ -0,0 +1,3 @@
+from .client import NoxHereApiError, NoxHereClient, ResourceClient, create_noxhere
+
+__all__ = ["NoxHereApiError", "NoxHereClient", "ResourceClient", "create_noxhere"]

noxhere-0.1.0/src/noxhere/_operations.py

@@ -0,0 +1,4 @@
+# Generated from public/openapi.json. Do not edit by hand.
+from typing import Final
+
+OPERATIONS: Final = [('acknowledgeRepositories', 'POST', '/api/v1/repos/acknowledge', 'workspace'), ('archiveProject', 'POST', '/api/v1/projects/{projectId}/archive', 'workspace'), ('archiveSpec', 'POST', '/api/v1/specs/{specId}/archive', 'planning'), ('assignIssue', 'POST', '/api/v1/assign', 'planning'), ('assignSlackConnectionProject', 'PATCH', '/api/v1/slack/connections/{connectionId}', 'workspace'), ('backfillProjectPullRequests', 'POST', '/api/v1/projects/{projectId}/backfill-prs', 'workspace'), ('closeFeature', 'DELETE', '/api/v1/features/{number}', 'planning'), ('closePullRequest', 'POST', '/api/v1/prs/close', 'activity'), ('createApiToken', 'POST', '/api/v1/api-tokens', 'workspace'), ('createFeature', 'POST', '/api/v1/features', 'planning'), ('createGuestInvitation', 'POST', '/api/v1/guests/invites', 'workspace'), ('createNoxCueCustomFeature', 'POST', '/api/v1/cues/sources/{sourceId}/features', 'incidents'), ('createNoxCueCustomMetric', 'POST', '/api/v1/cues/sources/{sourceId}/custom-metrics', 'incidents'), ('createNoxCueKey', 'POST', '/api/v1/cues/sources/{sourceId}/keys', 'incidents'), ('createNoxCueSource', 'POST', '/api/v1/cues/sources', 'incidents'), ('createNoxSpotSite', 'POST', '/api/v1/spots/sites', 'feedback'), ('createProject', 'POST', '/api/v1/projects', 'workspace'), ('createSpec', 'POST', '/api/v1/specs', 'planning'), ('deleteFeatureAttachment', 'DELETE', '/api/v1/features/{number}/attachments/{attachmentId}', 'planning'), ('deleteNoxCueCustomFeature', 'DELETE', '/api/v1/cues/sources/{sourceId}/features/{featureKey}', 'incidents'), ('deleteNoxCueCustomMetric', 'DELETE', '/api/v1/cues/sources/{sourceId}/custom-metrics/{metricKey}', 'incidents'), ('deleteNoxCueSource', 'DELETE', '/api/v1/cues/sources/{sourceId}', 'incidents'), ('deleteNoxSpotSite', 'DELETE', '/api/v1/spots/sites/{siteId}', 'feedback'), ('deleteSpecAttachment', 'DELETE', '/api/v1/specs/{specId}/attachments/{attachmentId}', 'planning'), ('disconnectConnection', 'POST', '/api/v1/integrations/connections/{provider}/disconnect', 'workspace'), ('disconnectSlackWorkspace', 'POST', '/api/v1/slack/disconnect', 'workspace'), ('downloadFeatureAttachment', 'GET', '/api/v1/features/{number}/attachments/{attachmentId}', 'planning'), ('downloadSpecAttachment', 'GET', '/api/v1/specs/{specId}/attachments/{attachmentId}', 'planning'), ('exchangeLegacyNativeCredential', 'POST', '/api/v1/auth/native/exchange', 'workspace'), ('getActor', 'GET', '/api/v1/actors/{actorId}', 'workspace'), ('getAiSettings', 'GET', '/api/v1/llm-settings', 'activity'), ('getBootstrapStatus', 'GET', '/api/v1/bootstrap-status', 'workspace'), ('getCueProjectActions', 'GET', '/api/v1/projects/{projectId}/cue/actions', 'incidents'), ('getCueProjectAlertRules', 'GET', '/api/v1/projects/{projectId}/cue/alert-rules', 'incidents'), ('getCueProjectAlerts', 'GET', '/api/v1/projects/{projectId}/cue/alerts', 'incidents'), ('getCueProjectDashboard', 'GET', '/api/v1/projects/{projectId}/cue/dashboard', 'incidents'), ('getCueProjectStatEvents', 'GET', '/api/v1/projects/{projectId}/cue/stat-events', 'incidents'), ('getCurrentMember', 'GET', '/api/v1/me', 'workspace'), ('getCurrentWorkSummary', 'GET', '/api/v1/feed/current-summary', 'activity'), ('getEngineerActivity', 'GET', '/api/v1/engineer-activity', 'activity'), ('getEngineerStats', 'GET', '/api/v1/engineer-stats', 'activity'), ('getFeedEvent', 'GET', '/api/v1/events/{id}', 'activity'), ('getGitHubComments', 'GET', '/api/v1/github/comments', 'activity'), ('getGitHubDetails', 'GET', '/api/v1/github/details', 'activity'), ('getGitHubRateLimit', 'GET', '/api/v1/github/rate-limit', 'workspace'), ('getIdentityProfile', 'GET', '/api/v1/auth/profile', 'workspace'), ('getIntegrationStatus', 'GET', '/api/v1/integrations/status', 'workspace'), ('getIssue', 'GET', '/api/v1/issues/{repo}/{number}', 'activity'), ('getNoxCueDailyHealth', 'GET', '/api/v1/cues/metrics', 'incidents'), ('getNoxCueGitHubIssueSettings', 'GET', '/api/v1/cues/github-issues', 'incidents'), ('getNoxCueProjectMetrics', 'GET', '/api/v1/cues/projects/{projectId}/metrics', 'incidents'), ('getNoxCueProjectOverview', 'GET', '/api/v1/cues/project-overview', 'incidents'), ('getNoxFeed', 'GET', '/api/v1/feed', 'activity'), ('getNoxFeedDefaultPrompt', 'GET', '/api/v1/noxfeed/release-notes-prompt', 'activity'), ('getNoxService', 'GET', '/api/v1/services/{service}', 'workspace'), ('getNoxServiceConfig', 'GET', '/api/v1/services/{service}/config', 'workspace'), ('getNoxServiceHealth', 'GET', '/api/v1/services/{service}/health', 'workspace'), ('getNoxServiceSetup', 'GET', '/api/v1/services/{service}/setup', 'workspace'), ('getNoxSpotProjectOverview', 'GET', '/api/v1/spots/project-overview', 'feedback'), ('getNoxSpotResolutionTemplate', 'GET', '/api/v1/spots/sites/{siteId}/resolution-template', 'feedback'), ('getOperatorUsage', 'GET', '/api/v1/operator/usage', 'workspace'), ('getProjectActivity', 'GET', '/api/v1/projects/{projectId}/activity', 'workspace'), ('getProjectFeedback', 'GET', '/api/v1/projects/{projectId}/feedback', 'workspace'), ('getProjectIncident', 'GET', '/api/v1/projects/{projectId}/incidents/{incidentId}', 'workspace'), ('getProjectIncidents', 'GET', '/api/v1/projects/{projectId}/incidents', 'workspace'), ('getProjectIssues', 'GET', '/api/v1/projects/{projectId}/issues', 'workspace'), ('getProjectRouting', 'GET', '/api/v1/projects/routing', 'workspace'), ('getPublicNoxSpotConfig', 'GET', '/api/spots/public/v1/sites/{siteId}/config', 'feedback'), ('getPullRequest', 'GET', '/api/v1/prs/{repo}/{number}', 'activity'), ('getSetupPlan', 'GET', '/api/v1/integrations/setup', 'workspace'), ('getSlackRouting', 'GET', '/api/v1/integrations/slack/routing', 'workspace'), ('getSlackStatus', 'GET', '/api/v1/slack/status', 'workspace'), ('getSpec', 'GET', '/api/v1/specs/{specId}', 'planning'), ('getSyncStatus', 'GET', '/api/v1/sync', 'workspace'), ('getWorkspaceConfig', 'GET', '/api/v1/config/{key}', 'workspace'), ('ingestNoxCueEvent', 'POST', '/api/v1/cues/public/events', 'incidents'), ('listActors', 'GET', '/api/v1/actors', 'workspace'), ('listApiTokens', 'GET', '/api/v1/api-tokens', 'workspace'), ('listConnections', 'GET', '/api/v1/integrations/connections', 'workspace'), ('listFeatureAttachments', 'GET', '/api/v1/features/{number}/attachments', 'planning'), ('listFeatures', 'GET', '/api/v1/features', 'planning'), ('listFeedEvents', 'GET', '/api/v1/events', 'activity'), ('listGitHubTeams', 'GET', '/api/v1/teams', 'workspace'), ('listGuestAccess', 'GET', '/api/v1/guests', 'workspace'), ('listIssues', 'GET', '/api/v1/issues', 'activity'), ('listMembers', 'GET', '/api/v1/members', 'workspace'), ('listNoxCueCustomMetrics', 'GET', '/api/v1/cues/sources/{sourceId}/custom-metrics', 'incidents'), ('listNoxCueEvents', 'GET', '/api/v1/cues/events', 'incidents'), ('listNoxCueFeatures', 'GET', '/api/v1/cues/sources/{sourceId}/features', 'incidents'), ('listNoxCueSources', 'GET', '/api/v1/cues/sources', 'incidents'), ('listNoxServices', 'GET', '/api/v1/services', 'workspace'), ('listNoxSpotSites', 'GET', '/api/v1/spots/sites', 'feedback'), ('listOperationFailures', 'GET', '/api/v1/op-failures', 'workspace'), ('listProjects', 'GET', '/api/v1/projects', 'workspace'), ('listPullRequests', 'GET', '/api/v1/prs', 'activity'), ('listRepositories', 'GET', '/api/v1/repos', 'workspace'), ('listSlackChannels', 'GET', '/api/v1/slack/channels', 'workspace'), ('listSpecAttachments', 'GET', '/api/v1/specs/{specId}/attachments', 'planning'), ('listSpecs', 'GET', '/api/v1/specs', 'planning'), ('patchNoxServiceConfig', 'PATCH', '/api/v1/services/{service}/config', 'workspace'), ('patchSlackRouting', 'PATCH', '/api/v1/integrations/slack/routing', 'workspace'), ('pollNativeDeviceAuthorization', 'POST', '/api/v1/auth/native/device/poll', 'workspace'), ('previewNoxSpotResolutionTemplate', 'POST', '/api/v1/spots/sites/{siteId}/resolution-template/preview', 'feedback'), ('putAiSettings', 'PUT', '/api/v1/llm-settings', 'activity'), ('putNoxCueGitHubIssueSettings', 'PUT', '/api/v1/cues/github-issues', 'incidents'), ('putWorkspaceConfig', 'PUT', '/api/v1/config/{key}', 'workspace'), ('recordAppActivity', 'POST', '/api/v1/app-activity', 'workspace'), ('recoverRepositoryHistory', 'POST', '/api/v1/recover-repo-history', 'workspace'), ('refreshNativeSession', 'POST', '/api/v1/auth/native/refresh', 'workspace'), ('reopenResolvedNoxSpotReport', 'POST', '/api/spots/public/v1/resolution-responses/{token}', 'feedback'), ('restoreProject', 'DELETE', '/api/v1/projects/{projectId}/archive', 'workspace'), ('restoreSpec', 'DELETE', '/api/v1/specs/{specId}/archive', 'planning'), ('retrieveProject', 'GET', '/api/v1/projects/{projectId}/retrieval', 'workspace'), ('retryNoxSpotDeliveries', 'POST', '/api/v1/spots/sites/{siteId}/retry-deliveries', 'feedback'), ('revokeApiToken', 'DELETE', '/api/v1/api-tokens/{id}', 'workspace'), ('revokeBrowserSession', 'POST', '/api/v1/auth/logout', 'workspace'), ('revokeGuestGrant', 'DELETE', '/api/v1/guests/grants/{grantId}', 'workspace'), ('revokeGuestInvitation', 'DELETE', '/api/v1/guests/invites/{inviteId}', 'workspace'), ('revokeNativeSession', 'POST', '/api/v1/auth/native/revoke', 'workspace'), ('revokeNoxCueKey', 'DELETE', '/api/v1/cues/sources/{sourceId}/keys/{keyId}', 'incidents'), ('rotateApiToken', 'POST', '/api/v1/api-tokens/{id}/rotate', 'workspace'), ('searchWorkspace', 'GET', '/api/v1/search', 'activity'), ('setIssueState', 'POST', '/api/v1/issue-state', 'planning'), ('startConnection', 'POST', '/api/v1/integrations/connections/{provider}/start', 'workspace'), ('startNativeDeviceAuthorization', 'POST', '/api/v1/auth/native/device/start', 'workspace'), ('submitPublicNoxSpotErrors', 'POST', '/api/spots/public/v1/errors', 'feedback'), ('submitPublicNoxSpotReport', 'POST', '/api/spots/public/v1/reports', 'feedback'), ('syncGitHubData', 'POST', '/api/v1/sync', 'workspace'), ('syncGitHubEvents', 'POST', '/api/v1/sync-events', 'workspace'), ('testNoxCueSource', 'POST', '/api/v1/cues/sources/{sourceId}/health/test', 'incidents'), ('testNoxSpotResolutionTemplate', 'POST', '/api/v1/spots/sites/{siteId}/resolution-template/test', 'feedback'), ('testSlackDestination', 'POST', '/api/v1/slack/test', 'workspace'), ('testSlackRoute', 'POST', '/api/v1/integrations/slack/test', 'workspace'), ('updateActor', 'PATCH', '/api/v1/actors/{actorId}', 'workspace'), ('updateCueProjectActions', 'PUT', '/api/v1/projects/{projectId}/cue/actions', 'incidents'), ('updateFeature', 'PATCH', '/api/v1/features/{number}', 'planning'), ('updateNoxCueCustomFeature', 'PUT', '/api/v1/cues/sources/{sourceId}/features/{featureKey}', 'incidents'), ('updateNoxCueCustomMetric', 'PUT', '/api/v1/cues/sources/{sourceId}/custom-metrics/{metricKey}', 'incidents'), ('updateNoxCueErrorStatus', 'PUT', '/api/v1/cues/errors/{sourceId}/{fingerprint}', 'incidents'), ('updateNoxCueProjectMetrics', 'PUT', '/api/v1/cues/projects/{projectId}/metrics', 'incidents'), ('updateNoxCueSource', 'PUT', '/api/v1/cues/sources/{sourceId}', 'incidents'), ('updateNoxSpotReport', 'PATCH', '/api/v1/spots/reports/{reportId}', 'feedback'), ('updateNoxSpotResolutionTemplate', 'PATCH', '/api/v1/spots/sites/{siteId}/resolution-template', 'feedback'), ('updateNoxSpotSite', 'PATCH', '/api/v1/spots/sites/{siteId}', 'feedback'), ('updateProjectIncident', 'PATCH', '/api/v1/projects/{projectId}/incidents/{incidentId}', 'workspace'), ('updateProjectRouting', 'PUT', '/api/v1/projects/{projectId}/routing', 'workspace'), ('updateSpec', 'PATCH', '/api/v1/specs/{specId}', 'planning'), ('uploadFeatureAttachment', 'POST', '/api/v1/features/{number}/attachments', 'planning'), ('uploadSpecAttachment', 'POST', '/api/v1/specs/{specId}/attachments', 'planning')]

noxhere-0.1.0/src/noxhere/client.py

@@ -0,0 +1,175 @@
+from __future__ import annotations
+
+import json
+import re
+from dataclasses import dataclass
+from typing import Any, Callable, Mapping, Protocol, Sequence
+from urllib.error import HTTPError
+from urllib.parse import quote, urlencode, urljoin
+from urllib.request import Request, urlopen
+
+from ._operations import OPERATIONS
+
+JsonValue = None | bool | int | float | str | list["JsonValue"] | dict[str, "JsonValue"]
+TransportResult = tuple[int, Mapping[str, str], bytes]
+
+
+class Transport(Protocol):
+    def __call__(self, method: str, url: str, headers: Mapping[str, str], body: bytes | None) -> TransportResult: ...
+
+
+class NoxHereApiError(RuntimeError):
+    def __init__(self, status: int, operation_id: str, details: Any) -> None:
+        super().__init__(f"NoxHere {operation_id} failed with HTTP {status}")
+        self.status = status
+        self.operation_id = operation_id
+        self.details = details
+
+
+@dataclass(frozen=True)
+class Operation:
+    operation_id: str
+    method: str
+    path: str
+    namespace: str
+
+
+def _snake(value: str) -> str:
+    return re.sub(r"(?<!^)(?=[A-Z])", "_", value).lower()
+
+
+def _default_transport(method: str, url: str, headers: Mapping[str, str], body: bytes | None) -> TransportResult:
+    request = Request(url, data=body, headers=dict(headers), method=method)
+    try:
+        with urlopen(request, timeout=30) as response:  # noqa: S310 - URL is bound to configured NoxHere origin
+            return response.status, dict(response.headers.items()), response.read()
+    except HTTPError as error:
+        return error.code, dict(error.headers.items()), error.read()
+
+
+def _payload(headers: Mapping[str, str], body: bytes) -> Any:
+    if not body:
+        return None
+    content_type = next((value for key, value in headers.items() if key.lower() == "content-type"), "")
+    if "json" in content_type.lower():
+        return json.loads(body)
+    if content_type.lower().startswith("text/"):
+        return body.decode()
+    return body
+
+
+class ResourceClient:
+    def __init__(self, client: "NoxHereClient", operations: Sequence[Operation]) -> None:
+        self._client = client
+        self._operations = {_snake(operation.operation_id): operation.operation_id for operation in operations}
+        self._operations.update({operation.operation_id: operation.operation_id for operation in operations})
+
+    def __getattr__(self, name: str) -> Callable[..., Any]:
+        operation_id = self._operations.get(name)
+        if operation_id is None:
+            raise AttributeError(name)
+
+        def invoke(**kwargs: Any) -> Any:
+            return self._client.request(operation_id, **kwargs)
+
+        return invoke
+
+    def operation_ids(self) -> tuple[str, ...]:
+        return tuple(sorted(set(self._operations.values())))
+
+
+class NoxHereClient:
+    def __init__(
+        self,
+        *,
+        base_url: str = "https://app.noxhere.com",
+        token: str | None = None,
+        organization: str | None = None,
+        project_id: str | None = None,
+        csrf_token: str | None = None,
+        headers: Mapping[str, str] | None = None,
+        transport: Transport = _default_transport,
+    ) -> None:
+        self.base_url = base_url.rstrip("/") + "/"
+        self._transport = transport
+        self._headers = dict(headers or {})
+        if token:
+            self._headers["Authorization"] = f"Bearer {token}"
+        if organization:
+            self._headers["X-Org"] = organization
+        if project_id:
+            self._headers["X-Project-ID"] = project_id
+        if csrf_token:
+            self._headers["X-CSRF-Token"] = csrf_token
+        self._operations = {
+            item[0]: Operation(operation_id=item[0], method=item[1], path=item[2], namespace=item[3])
+            for item in OPERATIONS
+        }
+        resources = {
+            namespace: ResourceClient(self, [operation for operation in self._operations.values() if operation.namespace == namespace])
+            for namespace in ("workspace", "activity", "planning", "feedback", "incidents")
+        }
+        self.workspace = resources["workspace"]
+        self.activity = resources["activity"]
+        self.planning = resources["planning"]
+        self.feedback = resources["feedback"]
+        self.incidents = resources["incidents"]
+        self.connect = self.workspace
+        self.feed = self.activity
+        self.ticket = self.planning
+        self.spot = self.feedback
+        self.cue = self.incidents
+
+    def request(
+        self,
+        operation_id: str,
+        *,
+        path: Mapping[str, str | int] | None = None,
+        query: Mapping[str, str | int | float | bool | Sequence[str | int | float | bool] | None] | None = None,
+        body: JsonValue | str | bytes | None = None,
+        headers: Mapping[str, str] | None = None,
+    ) -> Any:
+        operation = self._operations.get(operation_id)
+        if operation is None:
+            raise ValueError(f"Unknown NoxHere operation: {operation_id}")
+        values = dict(path or {})
+
+        def replace(match: re.Match[str]) -> str:
+            key = match.group(1)
+            if key not in values or values[key] == "":
+                raise ValueError(f"Missing path parameter: {key}")
+            return quote(str(values[key]), safe="")
+
+        operation_path = re.sub(r"\{([^}]+)\}", replace, operation.path)
+        pairs: list[tuple[str, str]] = []
+        for key, value in (query or {}).items():
+            if value is None:
+                continue
+            items = value if isinstance(value, (list, tuple)) else [value]
+            pairs.extend((key, str(item).lower() if isinstance(item, bool) else str(item)) for item in items)
+        url = urljoin(self.base_url, operation_path)
+        if pairs:
+            url += "?" + urlencode(pairs)
+        request_headers = {**self._headers, **dict(headers or {})}
+        encoded: bytes | None
+        if body is None:
+            encoded = None
+        elif isinstance(body, bytes):
+            encoded = body
+        elif isinstance(body, str):
+            encoded = body.encode()
+        else:
+            request_headers["Content-Type"] = "application/json"
+            encoded = json.dumps(body, separators=(",", ":")).encode()
+        status, response_headers, response_body = self._transport(operation.method, url, request_headers, encoded)
+        result = _payload(response_headers, response_body)
+        if not 200 <= status < 300:
+            raise NoxHereApiError(status, operation_id, result)
+        return result
+
+    def operation_ids(self) -> tuple[str, ...]:
+        return tuple(sorted(self._operations))
+
+
+def create_noxhere(**options: Any) -> NoxHereClient:
+    return NoxHereClient(**options)

noxhere-0.1.0/src/noxhere/feedback.py

@@ -0,0 +1,7 @@
+from typing import Any
+
+from .client import NoxHereClient, ResourceClient
+
+
+def create_feedback_client(**options: Any) -> ResourceClient:
+    return NoxHereClient(**options).feedback

noxhere-0.1.0/src/noxhere/incidents.py

@@ -0,0 +1,7 @@
+from typing import Any
+
+from .client import NoxHereClient, ResourceClient
+
+
+def create_incident_client(**options: Any) -> ResourceClient:
+    return NoxHereClient(**options).incidents

noxhere-0.1.0/src/noxhere/py.typed

@@ -0,0 +1 @@
+

noxhere-0.1.0/tests/test_client.py

@@ -0,0 +1,55 @@
+from __future__ import annotations
+
+import json
+import unittest
+from typing import Mapping
+
+from noxhere import NoxHereApiError, NoxHereClient
+
+
+class Recorder:
+    def __init__(self, status: int = 200, response: object = None) -> None:
+        self.calls: list[tuple[str, str, Mapping[str, str], bytes | None]] = []
+        self.status = status
+        self.response = response
+
+    def __call__(self, method: str, url: str, headers: Mapping[str, str], body: bytes | None):
+        self.calls.append((method, url, headers, body))
+        return self.status, {"Content-Type": "application/json"}, json.dumps(self.response).encode()
+
+
+class ClientTest(unittest.TestCase):
+    def test_maps_every_operation_and_alias(self) -> None:
+        client = NoxHereClient(transport=Recorder())
+        self.assertEqual(len(client.operation_ids()), 149)
+        self.assertIs(client.cue, client.incidents)
+        self.assertIs(client.spot, client.feedback)
+
+    def test_encodes_path_query_and_auth(self) -> None:
+        recorder = Recorder(response={"ok": True})
+        client = NoxHereClient(
+            base_url="https://example.test/base/",
+            token="nox_sk_test_secret",
+            organization="no-box-dev",
+            project_id="project-1",
+            transport=recorder,
+        )
+        result = client.activity.get_issue(path={"repo": "owner/repo", "number": 42}, query={"include": ["body", "labels"]})
+        self.assertEqual(result, {"ok": True})
+        _, url, headers, _ = recorder.calls[0]
+        self.assertEqual(url, "https://example.test/api/v1/issues/owner%2Frepo/42?include=body&include=labels")
+        self.assertEqual(headers["Authorization"], "Bearer nox_sk_test_secret")
+        self.assertEqual(headers["X-Project-ID"], "project-1")
+
+    def test_json_body_and_error(self) -> None:
+        recorder = Recorder(status=403, response={"error": "denied"})
+        client = NoxHereClient(transport=recorder)
+        with self.assertRaises(NoxHereApiError) as raised:
+            client.workspace.create_project(body={"name": "Demo"})
+        self.assertEqual(raised.exception.status, 403)
+        self.assertEqual(raised.exception.details, {"error": "denied"})
+        self.assertEqual(recorder.calls[0][2]["Content-Type"], "application/json")
+
+
+if __name__ == "__main__":
+    unittest.main()