phactor 0.3.1__tar.gz → 0.3.2__tar.gz

{phactor-0.3.1 → phactor-0.3.2}/CHANGELOG.md

@@ -6,6 +6,28 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 While the SDK is pre-1.0 (`0.x`), breaking changes may accompany a minor version bump.
 
+## [0.3.2] - 2026-09-24
+
+### Fixed
+
+- `client.cohorts.analyze` no longer fails when a provider reports a criterion
+  error reason other than `NO_TRANSLATION` / `NO_PATH`. 0.3.1 raised a pydantic
+  `ValidationError` for `UNSUPPORTED_SEMANTICS` (returned today, for example,
+  for exact product codes a provider cannot match), so one unevaluated criterion
+  made the whole result unreadable.
+
+### Added
+
+- `CriterionErrorReason.UNSUPPORTED_SEMANTICS`, `INSUFFICIENT_DATA`,
+  `MATERIALIZATION_NOT_READY` and `CriterionErrorDomain.AGE`, `MEASUREMENT`,
+  `ENCOUNTER`, matching the API.
+
+### Changed
+
+- Response values this SDK version does not know yet (`CriterionError.reason`,
+  `CriterionError.domain`, `Site.access`) are kept as plain strings instead of
+  failing validation, so a value the API adds later cannot break parsing.
+
 ## [0.3.1] - 2026-09-24
 
 ### Fixed

{phactor-0.3.1 → phactor-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: phactor
-Version: 0.3.1
+Version: 0.3.2
 Summary: Python SDK for the Phactor clinical trial feasibility platform
 Project-URL: Homepage, https://phactor.ai
 Project-URL: Documentation, https://docs.phactor.ai

phactor-0.3.2/src/phactor/_version.py

@@ -0,0 +1 @@
+__version__ = "0.3.2"

{phactor-0.3.1 → phactor-0.3.2}/src/phactor/cohorts/models.py

@@ -233,11 +233,23 @@ class CohortGroupOperator(str, Enum):
 
 
 class CriterionErrorReason(str, Enum):
-    NO_TRANSLATION = "NO_TRANSLATION"
-    NO_PATH = "NO_PATH"
+    """Why a provider could not evaluate a criterion. Values the server adds
+    later reach ``CriterionError.reason`` as plain strings instead of failing."""
+
+    UNSUPPORTED_SEMANTICS = "UNSUPPORTED_SEMANTICS"
+    INSUFFICIENT_DATA = "INSUFFICIENT_DATA"
+    MATERIALIZATION_NOT_READY = "MATERIALIZATION_NOT_READY"
+    NO_TRANSLATION = "NO_TRANSLATION"  # a crosswalk route exists but this code has no entry
+    NO_PATH = "NO_PATH"  # no translation route from the source system to the provider's
 
 
 class CriterionErrorDomain(str, Enum):
+    """The criterion type a ``CriterionError`` is about. Values the server adds
+    later reach ``CriterionError.domain`` as plain strings instead of failing."""
+
+    AGE = "AGE"
+    MEASUREMENT = "MEASUREMENT"
+    ENCOUNTER = "ENCOUNTER"
     CONDITION = "CONDITION"
     PROCEDURE = "PROCEDURE"
     ALLERGY = "ALLERGY"
@@ -677,10 +689,12 @@ class DemographicBreakdown(BaseModel):
 class CriterionError(BaseModel):
     model_config = _MODEL_CONFIG
 
-    domain: CriterionErrorDomain
+    # Response enums fall back to the raw string for values this SDK version
+    # does not know yet, so a new server value never breaks parsing a result.
+    domain: CriterionErrorDomain | str = Field(union_mode="left_to_right")
     source_type: str
     source_value: str
-    reason: CriterionErrorReason
+    reason: CriterionErrorReason | str = Field(union_mode="left_to_right")
     message: str | None = None
 
 

{phactor-0.3.1 → phactor-0.3.2}/src/phactor/sites/models.py

@@ -4,7 +4,7 @@ from __future__ import annotations
 
 from enum import Enum
 
-from pydantic import BaseModel, ConfigDict
+from pydantic import BaseModel, ConfigDict, Field
 from pydantic.alias_generators import to_camel
 
 from phactor.cohorts.models import LocationTypeEnum, LocationValueInput
@@ -34,7 +34,8 @@ class Site(BaseModel):
     country: str | None = None
     latitude: float
     longitude: float
-    access: SiteAccess
+    # A value this SDK version does not know yet stays a plain string.
+    access: SiteAccess | str = Field(union_mode="left_to_right")
 
     def as_location(self, *, radius: int = 10) -> LocationValueInput:
         """A SITE location value matching patients within ``radius`` miles of this site.

phactor-0.3.1/src/phactor/_version.py

@@ -1 +0,0 @@
-__version__ = "0.3.1"