canvas 0.53.2__py3-none-any.whl → 0.55.0__py3-none-any.whl

canvas_sdk/templates/utils.py

@@ -3,12 +3,14 @@ from typing import Any
 
 from django.template import Context, Template
 
-from canvas_sdk.utils.plugins import plugin_only
+from canvas_sdk.utils.plugins import plugin_context
 
 
-@plugin_only
+@plugin_context
 def render_to_string(
-    template_name: str, context: dict[str, Any] | None = None, **kwargs: Any
+    template_name: str,
+    context: dict[str, Any] | None = None,
+    **kwargs: Any,
 ) -> str | None:
     """Load a template and render it with the given context.
 

canvas_sdk/utils/plugins.py

@@ -8,19 +8,39 @@ from canvas_sdk.utils.metrics import measured
 from settings import PLUGIN_DIRECTORY
 
 
+def find_plugin_ancestor(frame: FrameType | None, max_depth: int = 10) -> FrameType | None:
+    """
+    Recurse backwards to find any plugin ancestor of this frame.
+    """
+    parent_frame = frame.f_back if frame else None
+
+    if not parent_frame:
+        return None
+
+    if max_depth == 0:
+        return None
+
+    if "__is_plugin__" in parent_frame.f_globals:
+        return parent_frame
+
+    return find_plugin_ancestor(frame=parent_frame, max_depth=max_depth - 1)
+
+
 @measured
-def plugin_only(func: Callable[..., Any]) -> Callable[..., Any]:
+def plugin_context(func: Callable[..., Any]) -> Callable[..., Any]:
     """Decorator to restrict a function's execution to plugins only."""
 
     def wrapper(*args: Any, **kwargs: Any) -> Any:
-        current_frame = inspect.currentframe()
-        caller = current_frame.f_back if current_frame else None
+        plugin_frame = find_plugin_ancestor(inspect.currentframe())
 
-        if not caller or "__is_plugin__" not in caller.f_globals:
-            return None
+        if not plugin_frame:
+            raise RuntimeError(
+                "Method that expected plugin context was called from outside a plugin."
+            )
 
-        plugin_name = caller.f_globals["__name__"].split(".")[0]
+        plugin_name = plugin_frame.f_globals["__name__"].split(".")[0]
         plugin_dir = Path(PLUGIN_DIRECTORY) / plugin_name
+
         kwargs["plugin_name"] = plugin_name
         kwargs["plugin_dir"] = plugin_dir.resolve()
 
@@ -30,24 +50,17 @@ def plugin_only(func: Callable[..., Any]) -> Callable[..., Any]:
 
 
 @measured
-def is_plugin_caller(depth: int = 10, frame: FrameType | None = None) -> tuple[bool, str | None]:
+def is_plugin_caller() -> tuple[bool, str | None]:
     """Check if a function is called from a plugin."""
-    current_frame = frame or inspect.currentframe()
-    caller = current_frame.f_back if current_frame else None
-
-    if not caller:
-        return False, None
+    plugin_frame = find_plugin_ancestor(inspect.currentframe())
 
-    if "__is_plugin__" not in caller.f_globals:
-        if depth > 0:
-            return is_plugin_caller(frame=caller, depth=depth - 1)
-        else:
-            return False, None
+    if plugin_frame:
+        module = plugin_frame.f_globals.get("__name__")
+        qualname = plugin_frame.f_code.co_qualname
 
-    module = caller.f_globals.get("__name__")
-    qualname = caller.f_code.co_qualname
+        return True, f"{module}.{qualname}"
 
-    return True, f"{module}.{qualname}"
+    return False, None
 
 
 __exports__ = ()

canvas_sdk/v1/data/patient.py

@@ -99,6 +99,13 @@ class Patient(Model):
     def __str__(self) -> str:
         return f"{self.first_name} {self.last_name}"
 
+    @property
+    def full_name(self) -> str:
+        """Returns the patient's full name."""
+        return " ".join(
+            n for n in (self.first_name, self.middle_name, self.last_name, self.suffix) if n
+        )
+
     def age_at(self, time: arrow.Arrow) -> float:
         """Given a datetime, returns what the patient's age would be at that datetime."""
         age = float(0)

plugin_runner/allowed-module-imports.json

@@ -212,6 +212,9 @@
   "canvas_sdk.effects.compound_medications.compound_medication": [
     "CompoundMedication"
   ],
+  "canvas_sdk.effects.group": [
+    "Group"
+  ],
   "canvas_sdk.effects.launch_modal": [
     "LaunchModalEffect"
   ],
@@ -236,6 +239,9 @@
   "canvas_sdk.effects.note.note": [
     "Note"
   ],
+  "canvas_sdk.effects.panel_configuration": [
+    "PanelConfiguration"
+  ],
   "canvas_sdk.effects.patient": [
     "CreatePatientExternalIdentifier",
     "Patient",
@@ -250,6 +256,9 @@
   "canvas_sdk.effects.patient.create_patient_external_identifier": [
     "CreatePatientExternalIdentifier"
   ],
+  "canvas_sdk.effects.patient_chart_group": [
+    "PatientChartGroup"
+  ],
   "canvas_sdk.effects.patient_chart_summary_configuration": [
     "PatientChartSummaryConfiguration"
   ],
@@ -279,6 +288,14 @@
   "canvas_sdk.effects.patient_profile_configuration": [
     "PatientProfileConfiguration"
   ],
+  "canvas_sdk.effects.payment_processor": [
+    "AddPaymentMethodResponse",
+    "CardTransaction",
+    "PaymentMethod",
+    "PaymentProcessorForm",
+    "PaymentProcessorMetadata",
+    "RemovePaymentMethodResponse"
+  ],
   "canvas_sdk.effects.protocol_card": [
     "ProtocolCard",
     "Recommendation"
@@ -364,6 +381,12 @@
   "canvas_sdk.handlers.cron_task": [
     "CronTask"
   ],
+  "canvas_sdk.handlers.payment_processors.base": [
+    "PaymentProcessor"
+  ],
+  "canvas_sdk.handlers.payment_processors.card": [
+    "CardPaymentProcessor"
+  ],
   "canvas_sdk.handlers.simple_api": [
     "APIKeyAuthMixin",
     "APIKeyCredentials",

plugin_runner/installation.py

@@ -147,6 +147,8 @@ def download_plugin(plugin_package: str) -> Generator[Path, None, None]:
 
         with open(download_path, "wb") as download_file:
             response = requests.request(method=method, url=f"https://{host}{path}", headers=headers)
+            response.raise_for_status()
+
             download_file.write(response.content)
 
         yield download_path
@@ -168,7 +170,8 @@ def install_plugin(plugin_name: str, attributes: PluginAttributes) -> None:
 
         install_plugin_secrets(plugin_name=plugin_name, secrets=attributes["secrets"])
     except Exception as e:
-        log.error(f'Failed to install plugin "{plugin_name}", version {attributes["version"]}')
+        log.error(f'Failed to install plugin "{plugin_name}", version {attributes["version"]}: {e}')
+
         sentry_sdk.capture_exception(e)
 
         raise PluginInstallationError() from e

plugin_runner/plugin_runner.py

@@ -1,3 +1,4 @@
+import base64
 import json
 import os
 import pathlib
@@ -213,6 +214,28 @@ class PluginRunner(PluginRunnerServicer):
                 # respond to SimpleAPI request events are not relevant
                 plugin_name = event.context["plugin_name"]
                 relevant_plugins = [p for p in relevant_plugins if p.startswith(f"{plugin_name}:")]
+            elif event_type in {
+                EventType.REVENUE__PAYMENT_PROCESSOR__CHARGE,
+                EventType.REVENUE__PAYMENT_PROCESSOR__SELECTED,
+                EventType.REVENUE__PAYMENT_PROCESSOR__PAYMENT_METHODS__LIST,
+                EventType.REVENUE__PAYMENT_PROCESSOR__PAYMENT_METHODS__ADD,
+                EventType.REVENUE__PAYMENT_PROCESSOR__PAYMENT_METHODS__REMOVE,
+            }:
+                # The target plugin's name will be part of the payment processor identifier, so other plugins that
+                # respond to payment processor charge events are not relevant
+                try:
+                    plugin_name = (
+                        base64.b64decode(event.context["identifier"]).decode("utf-8").split(".")[0]
+                    )
+                    relevant_plugins = [
+                        p for p in relevant_plugins if p.startswith(f"{plugin_name}:")
+                    ]
+                except Exception as ex:
+                    log.error(
+                        f"Failed to decode identifier for event {event_name} with context {event.context}"
+                    )
+                    sentry_sdk.capture_exception(ex)
+                    relevant_plugins = []
 
             effect_list = []
 

plugin_runner/sandbox.py

@@ -225,6 +225,7 @@ THIRD_PARTY_MODULES = {
     },
     "pydantic": {
         "BaseModel",
+        "ConfigDict",
         "conint",
         "constr",
         "Field",

protobufs/canvas_generated/messages/effects.proto

@@ -303,6 +303,17 @@ enum EffectType {
 
   CREATE_COMPOUND_MEDICATION = 6020;
   UPDATE_COMPOUND_MEDICATION = 6021;
+
+  PATIENT_CHART__GROUP_ITEMS = 6030;
+
+  SHOW_PANEL_SECTIONS = 6100;
+
+  REVENUE__PAYMENT_PROCESSOR__METADATA = 7001;
+  REVENUE__PAYMENT_PROCESSOR__FORM = 7002;
+  REVENUE__PAYMENT_PROCESSOR__CREDIT_CARD_TRANSACTION = 7003;
+  REVENUE__PAYMENT_PROCESSOR__PAYMENT_METHOD = 7004;
+  REVENUE__PAYMENT_PROCESSOR__PAYMENT_METHOD__ADD_RESPONSE = 7005;
+  REVENUE__PAYMENT_PROCESSOR__PAYMENT_METHOD__REMOVE_RESPONSE = 7006;
 }
 
 message Effect {

protobufs/canvas_generated/messages/events.proto

@@ -1108,6 +1108,7 @@ enum EventType {
   PATIENT_PROFILE__SECTION_CONFIGURATION = 100002;
   PATIENT_PROFILE__ADD_PHARMACY__POST_SEARCH = 100003;
 
+  PATIENT_CHART__MEDICATIONS = 100004;
   CLAIM__CONDITIONS = 101000;
 
   PLUGIN_CREATED = 102000;
@@ -1160,6 +1161,15 @@ enum EventType {
   DOCUMENT_REFERENCE_CREATED = 150000;
   DOCUMENT_REFERENCE_UPDATED = 150001;
   DOCUMENT_REFERENCE_DELETED = 150002;
+
+  PANEL_SECTIONS_CONFIGURATION = 15100;
+
+  REVENUE__PAYMENT_PROCESSOR__LIST = 160001;
+  REVENUE__PAYMENT_PROCESSOR__CHARGE = 160003;
+  REVENUE__PAYMENT_PROCESSOR__SELECTED = 160002;
+  REVENUE__PAYMENT_PROCESSOR__PAYMENT_METHODS__LIST = 160004;
+  REVENUE__PAYMENT_PROCESSOR__PAYMENT_METHODS__ADD = 160005;
+  REVENUE__PAYMENT_PROCESSOR__PAYMENT_METHODS__REMOVE = 160006;
 }
 
 message Event {