@josephyan/qingflow-app-builder-mcp 1.1.16 → 1.1.18

package/src/qingflow_mcp/builder_facade/models.py

@@ -1105,6 +1105,91 @@ class ViewAssociatedResourcesPatch(StrictModel):
     )
 
 
+class ViewActionButtonPatch(StrictModel):
+    button_id: int | None = Field(default=None, validation_alias=AliasChoices("button_id", "buttonId", "id"))
+    client_key: str | None = Field(default=None, validation_alias=AliasChoices("client_key", "clientKey"))
+    text: str = Field(validation_alias=AliasChoices("text", "button_text", "buttonText", "name"))
+    action: PublicButtonTriggerAction = Field(validation_alias=AliasChoices("action", "trigger_action", "triggerAction"))
+    url: str | None = Field(default=None, validation_alias=AliasChoices("url", "link_url", "linkUrl", "trigger_link_url", "triggerLinkUrl"))
+    target_app_key: str | None = Field(default=None, validation_alias=AliasChoices("target_app_key", "targetAppKey", "related_app_key", "relatedAppKey"))
+    target_app_name: str | None = Field(default=None, validation_alias=AliasChoices("target_app_name", "targetAppName", "related_app_name", "relatedAppName"))
+    field_mappings: list[dict[str, Any]] = Field(default_factory=list, validation_alias=AliasChoices("field_mappings", "fieldMappings", "mappings"))
+    default_values: dict[str, Any] = Field(default_factory=dict, validation_alias=AliasChoices("default_values", "defaultValues", "defaults"))
+    placement: PublicButtonPlacement = Field(default=PublicButtonPlacement.detail, validation_alias=AliasChoices("placement", "position"))
+    primary: bool = Field(default=False, validation_alias=AliasChoices("primary", "being_main", "beingMain"))
+    visible_when: list[list[ViewFilterRulePatch]] = Field(
+        default_factory=list,
+        validation_alias=AliasChoices("visible_when", "visibleWhen", "button_limit", "buttonLimit"),
+    )
+    button_formula: str | None = Field(default=None, validation_alias=AliasChoices("button_formula", "buttonFormula"))
+    button_formula_type: int = Field(default=1, validation_alias=AliasChoices("button_formula_type", "buttonFormulaType"))
+    print_tpls: list[Any] = Field(default_factory=list, validation_alias=AliasChoices("print_tpls", "printTpls"))
+    style_preset: str | None = Field(default=None, validation_alias=AliasChoices("style_preset", "stylePreset"))
+    background_color: str | None = Field(default=None, validation_alias=AliasChoices("background_color", "backgroundColor"))
+    text_color: str | None = Field(default=None, validation_alias=AliasChoices("text_color", "textColor"))
+    button_icon: str | None = Field(default=None, validation_alias=AliasChoices("button_icon", "buttonIcon"))
+    external_qrobot_config: dict[str, Any] | None = Field(
+        default=None,
+        validation_alias=AliasChoices(
+            "external_qrobot_config",
+            "externalQrobotConfig",
+            "externalQRobotConfig",
+            "custom_button_external_qrobot_relation_vo",
+            "customButtonExternalQRobotRelationVO",
+        ),
+    )
+    trigger_wings_config: dict[str, Any] | None = Field(default=None, validation_alias=AliasChoices("trigger_wings_config", "triggerWingsConfig"))
+
+    @model_validator(mode="before")
+    @classmethod
+    def normalize_aliases(cls, value: Any) -> Any:
+        if not isinstance(value, dict):
+            return value
+        payload = dict(value)
+        raw_action = payload.get("action", payload.get("trigger_action", payload.get("triggerAction")))
+        if isinstance(raw_action, str):
+            normalized = raw_action.strip()
+            aliases = {
+                "add_data": PublicButtonTriggerAction.add_data.value,
+                "add-data": PublicButtonTriggerAction.add_data.value,
+                "adddata": PublicButtonTriggerAction.add_data.value,
+                "addData": PublicButtonTriggerAction.add_data.value,
+                "link": PublicButtonTriggerAction.link.value,
+                "url": PublicButtonTriggerAction.link.value,
+                "qrobot": PublicButtonTriggerAction.qrobot.value,
+                "qRobot": PublicButtonTriggerAction.qrobot.value,
+                "wings": PublicButtonTriggerAction.wings.value,
+            }
+            payload["action"] = aliases.get(normalized, aliases.get(normalized.lower(), normalized))
+        raw_placement = payload.get("placement", payload.get("position", payload.get("config_type", payload.get("configType"))))
+        if isinstance(raw_placement, str):
+            normalized = raw_placement.strip().lower()
+            if normalized in {"top", "header"}:
+                payload["placement"] = PublicButtonPlacement.header.value
+            elif normalized in {"detail", "data_detail"}:
+                payload["placement"] = PublicButtonPlacement.detail.value
+            elif normalized in {"list", "row", "row_action", "inside"}:
+                payload["placement"] = PublicButtonPlacement.list.value
+        raw_limits = payload.get("visible_when", payload.get("visibleWhen", payload.get("button_limit", payload.get("buttonLimit"))))
+        if isinstance(raw_limits, list) and raw_limits and all(isinstance(item, dict) for item in raw_limits):
+            payload["visible_when"] = [raw_limits]
+        return payload
+
+    @model_validator(mode="after")
+    def validate_shape(self) -> "ViewActionButtonPatch":
+        if not str(self.text or "").strip():
+            raise ValueError("action_buttons[].text is required")
+        if self.action == PublicButtonTriggerAction.link and not str(self.url or "").strip():
+            raise ValueError("link action_buttons require url")
+        if self.action == PublicButtonTriggerAction.add_data and not str(self.target_app_key or "").strip():
+            raise ValueError("add_data action_buttons require target_app_key")
+        if self.action == PublicButtonTriggerAction.qrobot and self.external_qrobot_config is None:
+            raise ValueError("qRobot action_buttons require external_qrobot_config")
+        if self.action == PublicButtonTriggerAction.wings and self.trigger_wings_config is None:
+            raise ValueError("wings action_buttons require trigger_wings_config")
+        return self
+
+
 class ViewUpsertPatch(StrictModel):
     name: str
     view_key: str | None = Field(default=None, validation_alias=AliasChoices("view_key", "viewKey"))
@@ -1116,6 +1201,8 @@ class ViewUpsertPatch(StrictModel):
     end_field: str | None = Field(default=None, validation_alias=AliasChoices("end_field", "endField"))
     title_field: str | None = Field(default=None, validation_alias=AliasChoices("title_field", "titleField"))
     buttons: list["ViewButtonBindingPatch"] | None = None
+    action_buttons: list[ViewActionButtonPatch] | None = Field(default=None, validation_alias=AliasChoices("action_buttons", "actionButtons"))
+    action_buttons_mode: str = Field(default="merge", validation_alias=AliasChoices("action_buttons_mode", "actionButtonsMode", "button_mode", "buttonMode"))
     visibility: VisibilityPatch | None = None
     query_conditions: ViewQueryConditionsPatch | None = Field(default=None, validation_alias=AliasChoices("query_conditions", "queryConditions", "query_condition", "queryCondition"))
     associated_resources: ViewAssociatedResourcesPatch | None = Field(
@@ -1165,6 +1252,12 @@ class ViewUpsertPatch(StrictModel):
             payload["associated_resources"] = payload.pop("associatedReports")
         if "asosChartConfig" in payload and "associated_resources" not in payload:
             payload["associated_resources"] = payload.pop("asosChartConfig")
+        if "actionButtons" in payload and "action_buttons" not in payload:
+            payload["action_buttons"] = payload.pop("actionButtons")
+        if "actionButtonsMode" in payload and "action_buttons_mode" not in payload:
+            payload["action_buttons_mode"] = payload.pop("actionButtonsMode")
+        if "buttonMode" in payload and "action_buttons_mode" not in payload:
+            payload["action_buttons_mode"] = payload.pop("buttonMode")
         raw_type = payload.get("type")
         if isinstance(raw_type, str):
             normalized = raw_type.strip().lower()
@@ -1186,6 +1279,10 @@ class ViewUpsertPatch(StrictModel):
             raise ValueError("board view requires group_by")
         if self.type == PublicViewType.gantt and not (self.start_field and self.end_field):
             raise ValueError("gantt view requires start_field and end_field")
+        normalized_mode = str(self.action_buttons_mode or "merge").strip().lower()
+        if normalized_mode not in {"merge", "replace"}:
+            raise ValueError("action_buttons_mode must be merge or replace")
+        self.action_buttons_mode = normalized_mode
         return self
 
 
@@ -1211,6 +1308,76 @@ class ViewPartialPatch(StrictModel):
         return self
 
 
+def public_button_trigger_action_value(value: Any) -> str:
+    raw = value.value if isinstance(value, PublicButtonTriggerAction) else str(value or "").strip()
+    normalized = raw.lower()
+    if raw == PublicButtonTriggerAction.add_data.value or normalized in {"add_data", "add-data", "adddata"}:
+        return "add_data"
+    if normalized in {PublicButtonTriggerAction.link.value, "url"}:
+        return "link"
+    if raw == PublicButtonTriggerAction.qrobot.value or normalized == "qrobot":
+        return "qRobot"
+    if normalized == PublicButtonTriggerAction.wings.value:
+        return "wings"
+    return raw
+
+
+def _drop_empty_public_payload_values(payload: dict[str, Any]) -> dict[str, Any]:
+    compact: dict[str, Any] = {}
+    for key, item in payload.items():
+        if item is None or item == "" or item == [] or item == {}:
+            continue
+        if key == "primary" and item is False:
+            continue
+        compact[key] = item
+    return compact
+
+
+def public_view_action_button_payload(button: Any, *, compact: bool = False) -> dict[str, Any]:
+    if isinstance(button, ViewActionButtonPatch):
+        payload = button.model_dump(mode="json")
+    elif isinstance(button, dict):
+        payload = dict(button)
+    else:
+        return {}
+    raw_action = payload.get("action", payload.get("trigger_action", payload.get("triggerAction")))
+    if raw_action is not None:
+        payload["action"] = public_button_trigger_action_value(raw_action)
+        payload.pop("trigger_action", None)
+        payload.pop("triggerAction", None)
+    if compact:
+        return _drop_empty_public_payload_values(payload)
+    return payload
+
+
+def public_view_upsert_payload(view: ViewUpsertPatch) -> dict[str, Any]:
+    payload = view.model_dump(mode="json")
+    if view.action_buttons is not None:
+        payload["action_buttons"] = [
+            public_view_action_button_payload(button, compact=True)
+            for button in view.action_buttons
+        ]
+    return payload
+
+
+def public_view_partial_payload(patch: ViewPartialPatch) -> dict[str, Any]:
+    payload = patch.model_dump(mode="json")
+    patch_set = payload.get("set")
+    if isinstance(patch_set, dict):
+        raw_buttons = patch_set.get("action_buttons")
+        if raw_buttons is None:
+            raw_buttons = patch_set.get("actionButtons")
+        if isinstance(raw_buttons, list):
+            patch_set = dict(patch_set)
+            patch_set.pop("actionButtons", None)
+            patch_set["action_buttons"] = [
+                public_view_action_button_payload(button, compact=True)
+                for button in raw_buttons
+            ]
+            payload["set"] = patch_set
+    return payload
+
+
 class CustomButtonJudgeValuePatch(StrictModel):
     id: int | str | None = None
     value: Any | None = None
@@ -2093,6 +2260,22 @@ class ChartApplyRequest(StrictModel):
         return self
 
 
+class PortalInlineChartPatch(ChartUpsertPatch):
+    app_key: str = Field(validation_alias=AliasChoices("app_key", "appKey"))
+
+    @model_validator(mode="before")
+    @classmethod
+    def normalize_inline_aliases(cls, value: Any) -> Any:
+        if not isinstance(value, dict):
+            return value
+        payload = dict(value)
+        if "chart_name" in payload and "name" not in payload:
+            payload["name"] = payload.pop("chart_name")
+        if "chartName" in payload and "name" not in payload:
+            payload["name"] = payload.pop("chartName")
+        return payload
+
+
 class PortalComponentPositionPatch(StrictModel):
     pc_x: int = Field(default=0, validation_alias=AliasChoices("pc_x", "pcX", "x"))
     pc_y: int = Field(default=0, validation_alias=AliasChoices("pc_y", "pcY", "y"))
@@ -2177,6 +2360,7 @@ class PortalSectionPatch(StrictModel):
     dash_style_config: dict[str, Any] | None = Field(default=None, validation_alias=AliasChoices("dash_style_config", "dashStyleConfigBO"))
     config: dict[str, Any] = Field(default_factory=dict)
     chart_ref: PortalChartRefPatch | None = None
+    chart: PortalInlineChartPatch | None = Field(default=None, validation_alias=AliasChoices("chart", "inline_chart", "inlineChart", "create_chart", "createChart"))
     view_ref: PortalViewRefPatch | None = None
     text: str | None = None
     url: str | None = None
@@ -2195,6 +2379,14 @@ class PortalSectionPatch(StrictModel):
             payload["role"] = raw_role.strip().lower()
         if "chartRef" in payload and "chart_ref" not in payload:
             payload["chart_ref"] = payload.pop("chartRef")
+        if "inlineChart" in payload and "chart" not in payload:
+            payload["chart"] = payload.pop("inlineChart")
+        if "inline_chart" in payload and "chart" not in payload:
+            payload["chart"] = payload.pop("inline_chart")
+        if "createChart" in payload and "chart" not in payload:
+            payload["chart"] = payload.pop("createChart")
+        if "create_chart" in payload and "chart" not in payload:
+            payload["chart"] = payload.pop("create_chart")
         if "viewRef" in payload and "view_ref" not in payload:
             payload["view_ref"] = payload.pop("viewRef")
         if "dashStyleConfigBO" in payload and "dash_style_config" not in payload:
@@ -2206,8 +2398,8 @@ class PortalSectionPatch(StrictModel):
         supported = {"chart", "view", "grid", "filter", "text", "link"}
         if self.source_type not in supported:
             raise ValueError(f"unsupported portal source_type '{self.source_type}'")
-        if self.source_type == "chart" and self.chart_ref is None:
-            raise ValueError("chart section requires chart_ref")
+        if self.source_type == "chart" and self.chart_ref is None and self.chart is None:
+            raise ValueError("chart section requires chart_ref or chart")
         if self.source_type == "view" and self.view_ref is None:
             raise ValueError("view section requires view_ref")
         if self.source_type == "text" and self.text is None:
@@ -2495,6 +2687,14 @@ def _normalize_field_payload(value: Any) -> Any:
     if not isinstance(value, dict):
         return value
     payload = dict(value)
+    if "data_title" in payload and "as_data_title" not in payload and "asDataTitle" not in payload:
+        payload["as_data_title"] = payload.pop("data_title")
+    if "dataTitle" in payload and "as_data_title" not in payload and "asDataTitle" not in payload:
+        payload["as_data_title"] = payload.pop("dataTitle")
+    if "data_cover" in payload and "as_data_cover" not in payload and "asDataCover" not in payload:
+        payload["as_data_cover"] = payload.pop("data_cover")
+    if "dataCover" in payload and "as_data_cover" not in payload and "asDataCover" not in payload:
+        payload["as_data_cover"] = payload.pop("dataCover")
     if "fields" in payload and "subfields" not in payload:
         payload["subfields"] = payload.pop("fields")
     if "options" in payload: