Add optional photo providers, layout studio and scoped integrations

pigway_frame_flow/integrations/kokonna_official/rpc.py

@@ -17,8 +17,15 @@ class OfficialRPC:
     def authorized(self) -> bool:
         return bool(self._token)
 
-    def _call(self, method: str, params: dict) -> dict:
-        if method not in READ_OPERATIONS and method != "app.login":
+    def _call(self, method: str, params: dict, *, allow_write=False) -> dict:
+        if method == "appFrame.setFrameCover" and not allow_write:
+            raise FlowError(
+                E.UNSUPPORTED_CAPABILITY, "Use the explicit widget operation", 422
+            )
+        if method not in READ_OPERATIONS and method not in (
+            "app.login",
+            "appFrame.setFrameCover",
+        ):
             raise FlowError(
                 E.UNSUPPORTED_CAPABILITY, "Official operation is not enabled", 422
             )
@@ -62,6 +69,10 @@ class OfficialRPC:
         except FlowError:
             raise
         except (requests.RequestException, ValueError, AttributeError):
+            if method == "appFrame.setFrameCover":
+                raise FlowError(
+                    E.WRITE_RESULT_UNKNOWN, "Official widget write result unknown", 409
+                ) from None
             raise FlowError(
                 E.CLOUD_UNAVAILABLE, "Official service query failed", 502
             ) from None
@@ -86,3 +97,10 @@ class OfficialRPC:
 
     def widgets(self, robot_id: int) -> dict:
         return self._call("appFrame.getFrameCovers", {"robotId": robot_id})
+
+    def set_widget(self, robot_id, cover_id, args):
+        return self._call(
+            "appFrame.setFrameCover",
+            {"robotId": robot_id, "coverId": cover_id, "args": args},
+            allow_write=True,
+        )