add dynamic application

Author: ruipbatista

canvas_generated/messages/effects_pb2.py

@@ -229,6 +229,7 @@ class EffectType(int, metaclass=_enum_type_wrapper.EnumTypeWrapper):
     COMMAND_AVAILABLE_ACTIONS_RESULTS: _ClassVar[EffectType]
     COMMAND_VALIDATION_ERRORS: _ClassVar[EffectType]
     SHOW_ACTION_BUTTON: _ClassVar[EffectType]
+    SHOW_APPLICATION: _ClassVar[EffectType]
     PATIENT_PORTAL__FORM_RESULT: _ClassVar[EffectType]
     PATIENT_PORTAL__APPOINTMENT_IS_CANCELABLE: _ClassVar[EffectType]
     PATIENT_PORTAL__APPOINTMENT_IS_RESCHEDULABLE: _ClassVar[EffectType]
@@ -558,6 +559,7 @@ ENTER_IN_ERROR_UNCATEGORIZED_DOCUMENT_REVIEW_COMMAND: EffectType
 COMMAND_AVAILABLE_ACTIONS_RESULTS: EffectType
 COMMAND_VALIDATION_ERRORS: EffectType
 SHOW_ACTION_BUTTON: EffectType
+SHOW_APPLICATION: EffectType
 PATIENT_PORTAL__FORM_RESULT: EffectType
 PATIENT_PORTAL__APPOINTMENT_IS_CANCELABLE: EffectType
 PATIENT_PORTAL__APPOINTMENT_IS_RESCHEDULABLE: EffectType

canvas_generated/messages/effects_pb2.pyi

@@ -1017,6 +1017,7 @@ class EventType(int, metaclass=_enum_type_wrapper.EnumTypeWrapper):
     PLUGIN_UPDATED: _ClassVar[EventType]
     APPLICATION__ON_OPEN: _ClassVar[EventType]
     APPLICATION__ON_CONTEXT_CHANGE: _ClassVar[EventType]
+    APPLICATION__ON_GET: _ClassVar[EventType]
     PATIENT_PORTAL__GET_FORMS: _ClassVar[EventType]
     PATIENT_PORTAL__APPOINTMENT_CANCELED: _ClassVar[EventType]
     PATIENT_PORTAL__APPOINTMENT_RESCHEDULED: _ClassVar[EventType]
@@ -2095,6 +2096,7 @@ PLUGIN_CREATED: EventType
 PLUGIN_UPDATED: EventType
 APPLICATION__ON_OPEN: EventType
 APPLICATION__ON_CONTEXT_CHANGE: EventType
+APPLICATION__ON_GET: EventType
 PATIENT_PORTAL__GET_FORMS: EventType
 PATIENT_PORTAL__APPOINTMENT_CANCELED: EventType
 PATIENT_PORTAL__APPOINTMENT_RESCHEDULED: EventType

canvas_generated/messages/events_pb2.py

@@ -0,0 +1,36 @@
+from typing import Any
+
+from pydantic import Field
+
+from canvas_generated.messages.effects_pb2 import EffectType
+from canvas_sdk.effects.base import _BaseEffect
+
+
+class ShowApplicationEffect(_BaseEffect):
+    """An Effect that returns an application's properties."""
+
+    class Meta:
+        effect_type = EffectType.SHOW_APPLICATION
+
+    name: str = Field(min_length=1)
+    identifier: str = Field(min_length=1)
+    open_by_default: bool = Field(default=False)
+    priority: int = Field(default=0)
+
+    @property
+    def values(self) -> dict[str, Any]:
+        """The ShowApplicationEffect's values."""
+        return {
+            "name": self.name,
+            "identifier": self.identifier,
+            "open_by_default": self.open_by_default,
+            "priority": self.priority,
+        }
+
+    @property
+    def effect_payload(self) -> dict[str, Any]:
+        """The payload of the effect."""
+        return {"data": self.values}
+
+
+__exports__ = ("ShowApplicationEffect",)

canvas_generated/messages/events_pb2.pyi

@@ -1,9 +1,10 @@
+import warnings
 from abc import ABC, abstractmethod
 
 from canvas_sdk.effects import Effect
+from canvas_sdk.effects.show_application import ShowApplicationEffect
 from canvas_sdk.events import EventType
 from canvas_sdk.handlers import BaseHandler
-from canvas_sdk.handlers.action_button import ActionButton
 from canvas_sdk.handlers.utils import normalize_effects
 
 
@@ -13,6 +14,7 @@ class Application(BaseHandler, ABC):
     RESPONDS_TO = [
         EventType.Name(EventType.APPLICATION__ON_OPEN),
         EventType.Name(EventType.APPLICATION__ON_CONTEXT_CHANGE),
+        EventType.Name(EventType.APPLICATION__ON_GET),
     ]
 
     def compute(self) -> list[Effect]:
@@ -42,34 +44,72 @@ def identifier(self) -> str:
         return f"{self.__class__.__module__}:{self.__class__.__qualname__}"
 
 
-class NoteApplication(ActionButton):
-    """An Application that can be shown in a note."""
+class DynamicApplication(Application, ABC):
+    """An embeddable application that can be registered to Canvas."""
 
-    NAME: str = ""
-    IDENTIFIER: str = ""
+    NAME: str
+    SCOPE: str
+    IDENTIFIER: str | None = None
+    PRIORITY: int = 0
 
-    @property
-    def BUTTON_TITLE(self) -> str:  # type: ignore[override]
-        """Return NAME as the button title."""
-        return self.NAME
+    def compute(self) -> list[Effect]:
+        """Handle the application events."""
+        match self.event.type:
+            case EventType.APPLICATION__ON_GET:
+                if self.visible():
+                    return [
+                        ShowApplicationEffect(
+                            name=self.NAME,
+                            identifier=self.identifier,
+                            open_by_default=self.open_by_default(),
+                            priority=self.PRIORITY,
+                        ).apply()
+                    ]
+                return []
+            case _:
+                return super().compute()
 
-    @property
-    def BUTTON_KEY(self) -> str:  # type: ignore[override]
-        """Return IDENTIFIER as the button key."""
-        return self.IDENTIFIER
+    def open_by_default(self) -> bool:
+        """Open the application by default."""
+        return False
+
+    def visible(self) -> bool:
+        """Determine whether the application should be visible."""
+        return self.context.get("scope") == self.SCOPE
 
     @property
-    def BUTTON_LOCATION(self) -> ActionButton.ButtonLocation:  # type: ignore[override]
-        """Return the note body as the button location."""
-        return ActionButton.ButtonLocation.NOTE_BODY
+    def identifier(self) -> str:
+        """The application identifier."""
+        return self.IDENTIFIER if self.IDENTIFIER else super().identifier
+
+
+class NoteApplication(DynamicApplication):
+    """An Application that can be shown in a note."""
+
+    SCOPE = "note"
+
+    def on_open(self) -> Effect | list[Effect]:
+        """Delegate to handle() for backward compatibility with old plugins."""
+        # If a subclass overrides handle(), call it for backward compat.
+        # New plugins should override on_open() directly.
+        return self.handle()
 
-    @abstractmethod
     def handle(self) -> list[Effect]:
-        """Method to handle button click."""
-        raise NotImplementedError("Implement to handle button click")
+        """Method to handle application click/on_open.
+
+        .. deprecated::
+            Override :meth:`on_open` instead.
+        """
+        warnings.warn(
+            "NoteApplication.handle() is deprecated. Override on_open() instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        return []
 
 
 __exports__ = (
     "Application",
+    "DynamicApplication",
     "NoteApplication",
 )

canvas_sdk/effects/show_application.py

@@ -670,6 +670,9 @@
   "canvas_sdk.effects.send_invite": [
     "SendInviteEffect"
   ],
+  "canvas_sdk.effects.show_application": [
+    "ShowApplicationEffect"
+  ],
   "canvas_sdk.effects.show_button": [
     "ShowButtonEffect"
   ],
@@ -745,6 +748,7 @@
   ],
   "canvas_sdk.handlers.application": [
     "Application",
+    "DynamicApplication",
     "NoteApplication"
   ],
   "canvas_sdk.handlers.base": [

canvas_sdk/handlers/application.py

@@ -278,6 +278,7 @@ enum EffectType {
   COMMAND_VALIDATION_ERRORS = 1601;
 
   SHOW_ACTION_BUTTON = 1000;
+  SHOW_APPLICATION = 1001;
 
 
 

plugin_runner/allowed-module-imports.json

@@ -1236,6 +1236,7 @@ enum EventType {
 
   APPLICATION__ON_OPEN = 103000;
   APPLICATION__ON_CONTEXT_CHANGE = 103001;
+  APPLICATION__ON_GET = 103002;
 
   PATIENT_PORTAL__GET_FORMS = 110000;
   PATIENT_PORTAL__APPOINTMENT_CANCELED = 110001;