offering-protocol 0.1.1__tar.gz → 0.2.0__tar.gz

{offering_protocol-0.1.1 → offering_protocol-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: offering-protocol
-Version: 0.1.1
+Version: 0.2.0
 Summary: Official Python SDK for the Offering Discovery Protocol
 Project-URL: Documentation, https://www.offeringprotocol.org/
 Project-URL: Issues, https://github.com/offering-protocol/odp-python/issues
@@ -94,8 +94,9 @@ async def main() -> None:
 asyncio.run(main())
 ```
 
-Use `search_services()` when the application wants bounded automatic pagination. Use `suggest()` to
-discover keyword completions supported by the Directory.
+Use `search_services()` when the application wants bounded automatic pagination. Search responses
+provide facets for enrollment protocols, keywords, operations, payment protocols, payment options,
+and trust protocols. Use `suggest()` to discover keyword completions supported by the Directory.
 
 ## Inspect and navigate a Service
 
@@ -266,7 +267,9 @@ service = (
 Every Service integration must implement `list-offerings` and `get-offering`. `StaticCatalog` is the
 small-Service implementation: it adds Collection operations when Collections are provided and uses
 integrity-protected, stateless continuations that expire after one hour. Larger Services can
-implement the typed `Catalog` protocol over their existing indexed catalog and search infrastructure.
+subclass the typed `Catalog` protocol over their existing indexed catalog and search infrastructure.
+The protocol supplies rejecting defaults for optional operations; override an optional method and
+include its matching `Operation` only when the Service implements it.
 
 Service responses are validated against the bundled normative schemas before they are returned.
 The handler enforces fixed operation paths and methods, ODP media types, request and response byte

{offering_protocol-0.1.1 → offering_protocol-0.2.0}/README.md

@@ -65,8 +65,9 @@ async def main() -> None:
 asyncio.run(main())
 ```
 
-Use `search_services()` when the application wants bounded automatic pagination. Use `suggest()` to
-discover keyword completions supported by the Directory.
+Use `search_services()` when the application wants bounded automatic pagination. Search responses
+provide facets for enrollment protocols, keywords, operations, payment protocols, payment options,
+and trust protocols. Use `suggest()` to discover keyword completions supported by the Directory.
 
 ## Inspect and navigate a Service
 
@@ -237,7 +238,9 @@ service = (
 Every Service integration must implement `list-offerings` and `get-offering`. `StaticCatalog` is the
 small-Service implementation: it adds Collection operations when Collections are provided and uses
 integrity-protected, stateless continuations that expire after one hour. Larger Services can
-implement the typed `Catalog` protocol over their existing indexed catalog and search infrastructure.
+subclass the typed `Catalog` protocol over their existing indexed catalog and search infrastructure.
+The protocol supplies rejecting defaults for optional operations; override an optional method and
+include its matching `Operation` only when the Service implements it.
 
 Service responses are validated against the bundled normative schemas before they are returned.
 The handler enforces fixed operation paths and methods, ODP media types, request and response byte

{offering_protocol-0.1.1 → offering_protocol-0.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "offering-protocol"
-version = "0.1.1"
+version = "0.2.0"
 description = "Official Python SDK for the Offering Discovery Protocol"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -41,12 +41,12 @@ Repository = "https://github.com/offering-protocol/odp-python"
 
 [dependency-groups]
 dev = [
-  "build==1.5.0",
+  "build==1.6.1",
   "mypy==2.3.1",
   "pytest==9.1.1",
   "pytest-asyncio==1.4.0",
   "pytest-cov==7.1.0",
-  "ruff==0.16.4",
+  "ruff==0.16.7",
   "twine==7.0.0",
   "types-jsonschema==4.26.0.20260518",
 ]

{offering_protocol-0.1.1 → offering_protocol-0.2.0}/src/offering_protocol/directory/client.py

@@ -178,6 +178,10 @@ def _parse_search_page(body: bytes) -> SearchPage:
         raise DirectoryError(f"invalid Directory response: {error}") from error
     if len(page.items) > 100:
         raise DirectoryError("Directory search page exceeds 100 Services")
+    if page.facets is not None and any(
+        facet.value.name.value != "tap" for facet in page.facets.trust
+    ):
+        raise DirectoryError("Directory trust facets are invalid")
     for service in page.items:
         if derive_service_origin(service.service_origin) != service.service_origin:
             raise DirectoryError("Directory Service origin is not canonical")
@@ -217,6 +221,12 @@ def _validate_search_request(request: SearchRequest) -> None:
         or any(not keyword or len(keyword) > 64 for keyword in request.filters.keywords)
     ):
         raise DirectoryError("keywords must contain at most 32 values of at most 64 characters")
+    if (
+        request.filters is not None
+        and "trust" in request.filters.model_fields_set
+        and (len(request.filters.trust) != 1 or request.filters.trust[0].name.value != "tap")
+    ):
+        raise DirectoryError("trust must contain exactly one tap descriptor")
 
 
 def _consume_response(response: HttpResponse) -> HttpResponse:

{offering_protocol-0.1.1 → offering_protocol-0.2.0}/src/offering_protocol/directory/models.py

@@ -3,6 +3,7 @@
 from __future__ import annotations
 
 from enum import StrEnum
+from typing import Generic, TypeVar
 
 from pydantic import Field
 
@@ -13,10 +14,14 @@ from offering_protocol.core.models import (
     Operation,
     OperationDescriptor,
     PaymentOption,
+    PaymentProtocol,
     Protocol,
     ServiceProtocols,
+    TrustProtocol,
 )
 
+FacetValue = TypeVar("FacetValue")
+
 
 class Environment(StrEnum):
     PRODUCTION = "production"
@@ -45,6 +50,7 @@ class ServiceFilters(OdpModel):
     keywords: list[str] = Field(default_factory=list)
     operations: list[OperationFilter] = Field(default_factory=list)
     payments: list[PaymentFilter] = Field(default_factory=list)
+    trust: list[TrustProtocol] = Field(default_factory=list)
 
 
 class SearchRequest(OdpModel):
@@ -74,17 +80,18 @@ class PaymentOptionFacetValue(OdpModel):
     option: PaymentOption
 
 
-class Facet(OdpModel):
+class Facet(OdpModel, Generic[FacetValue]):
     count: int
-    value: object
+    value: FacetValue
 
 
 class Facets(OdpModel):
-    enrollment: list[Facet] = Field(default_factory=list)
-    keywords: list[Facet] = Field(default_factory=list)
-    operations: list[Facet] = Field(default_factory=list)
-    payment_options: list[Facet] = Field(default_factory=list)
-    payments: list[Facet] = Field(default_factory=list)
+    enrollment: list[Facet[EnrollmentProtocol]] = Field(default_factory=list)
+    keywords: list[Facet[str]] = Field(default_factory=list)
+    operations: list[Facet[OperationDescriptor]] = Field(default_factory=list)
+    payment_options: list[Facet[PaymentOptionFacetValue]] = Field(default_factory=list)
+    payments: list[Facet[PaymentProtocol]] = Field(default_factory=list)
+    trust: list[Facet[TrustProtocol]] = Field(default_factory=list)
 
 
 class SearchPage(OdpModel):

{offering_protocol-0.1.1 → offering_protocol-0.2.0}/src/offering_protocol/service/service.py

@@ -98,21 +98,29 @@ class Catalog(Protocol):
 
     async def search_offerings(
         self, query: OfferingSearchRequest, request: CatalogRequest
-    ) -> OfferingPage[Offering]: ...
+    ) -> OfferingPage[Offering]:
+        del query, request
+        raise CatalogError("Offering search is not supported")
 
-    async def list_collections(self, request: CatalogRequest) -> Page[Collection]: ...
+    async def list_collections(self, request: CatalogRequest) -> Page[Collection]:
+        del request
+        raise CatalogError("Collection listing is not supported")
 
-    async def get_collection(
-        self, identifier: str, request: CatalogRequest
-    ) -> Collection | None: ...
+    async def get_collection(self, identifier: str, request: CatalogRequest) -> Collection | None:
+        del identifier, request
+        raise CatalogError("Collection retrieval is not supported")
 
     async def search_collections(
         self, query: CollectionSearchRequest, request: CatalogRequest
-    ) -> Page[Collection]: ...
+    ) -> Page[Collection]:
+        del query, request
+        raise CatalogError("Collection search is not supported")
 
     async def list_collection_offerings(
         self, collection_id: str, request: CatalogRequest
-    ) -> OfferingPage[Offering]: ...
+    ) -> OfferingPage[Offering]:
+        del collection_id, request
+        raise CatalogError("Collection Offering listing is not supported")
 
 
 class ServiceBuilder: