amsdal 0.5.19__cp312-cp312-macosx_10_13_universal2.whl → 0.5.21__cp312-cp312-macosx_10_13_universal2.whl

amsdal/__about__.py

@@ -1,4 +1,4 @@
 # SPDX-FileCopyrightText: 2023-present
 #
 # SPDX-License-Identifier: AMSDAL End User License Agreement
-__version__ = '0.5.19'
+__version__ = '0.5.21'

amsdal/contrib/frontend_configs/migrations/0002_add_button_and_invoke_actions.py

@@ -0,0 +1,314 @@
+from amsdal_models.migration import migrations
+from amsdal_utils.models.enums import ModuleType
+
+
+class Migration(migrations.Migration):
+    operations: list[migrations.Operation] = [
+        migrations.CreateClass(
+            module_type=ModuleType.CONTRIB,
+            class_name="UpdateValueAction",
+            new_schema={
+                "title": "UpdateValueAction",
+                "type": "FrontendConfigSkipNoneBase",
+                "required": ["type", "field_id", "value"],
+                "properties": {
+                    "type": {
+                        "type": "string",
+                        "options": [{"key": "update_value", "value": "update_value"}],
+                        "title": "Type",
+                        "enum": ["update_value"],
+                    },
+                    "field_id": {"type": "string", "title": "Field ID"},
+                    "value": {"type": "anything", "title": "Value"},
+                },
+                "meta_class": "TypeMeta",
+                "custom_code": "from typing import Any\n\nfrom amsdal.contrib.frontend_configs.models.frontend_config_skip_none_base import *\n\n\ndef model_dump(self, **kwargs: Any) -> dict[str, Any]:\n    kwargs['exclude_none'] = True\n    return super().model_dump(**kwargs)\n\ndef model_dump_json(self, **kwargs: Any) -> str:\n    kwargs['exclude_none'] = True\n    return super().model_dump_json(**kwargs)",
+                "storage_metadata": {"table_name": "UpdateValueAction", "db_fields": {}, "foreign_keys": {}},
+            },
+        ),
+        migrations.CreateClass(
+            module_type=ModuleType.CONTRIB,
+            class_name="InvokeAction",
+            new_schema={
+                "title": "InvokeAction",
+                "type": "FrontendConfigSkipNoneBase",
+                "required": ["type", "method", "url"],
+                "properties": {
+                    "type": {
+                        "type": "string",
+                        "options": [{"key": "invoke", "value": "invoke"}],
+                        "title": "Type",
+                        "enum": ["invoke"],
+                    },
+                    "method": {
+                        "type": "string",
+                        "title": "HTTP Method",
+                        "enum": ["GET", "POST", "PUT", "PATCH", "DELETE"],
+                        "options": [
+                            {"key": "GET", "value": "GET"},
+                            {"key": "POST", "value": "POST"},
+                            {"key": "PUT", "value": "PUT"},
+                            {"key": "PATCH", "value": "PATCH"},
+                            {"key": "DELETE", "value": "DELETE"},
+                        ],
+                    },
+                    "url": {"type": "string", "title": "URL"},
+                    "headers": {"type": "dict", "title": "Headers"},
+                    "body": {"type": "dict", "title": "Body"},
+                    "onSuccess": {
+                        "type": "array",
+                        "items": {"type": "anything"},
+                        "title": "On Success Actions",
+                    },
+                    "onError": {
+                        "type": "array",
+                        "items": {"type": "anything"},
+                        "title": "On Error Actions",
+                    },
+                },
+                "meta_class": "TypeMeta",
+                "custom_code": "from typing import Any\n\nfrom amsdal.contrib.frontend_configs.models.frontend_config_skip_none_base import *\n\n\ndef model_dump(self, **kwargs: Any) -> dict[str, Any]:\n    kwargs['exclude_none'] = True\n    return super().model_dump(**kwargs)\n\ndef model_dump_json(self, **kwargs: Any) -> str:\n    kwargs['exclude_none'] = True\n    return super().model_dump_json(**kwargs)",
+                "storage_metadata": {"table_name": "InvokeAction", "db_fields": {}, "foreign_keys": {}},
+            },
+        ),
+        migrations.CreateClass(
+            module_type=ModuleType.CONTRIB,
+            class_name="ChangeContextAction",
+            new_schema={
+                "title": "ChangeContextAction",
+                "type": "FrontendConfigSkipNoneBase",
+                "required": ["type", "context"],
+                "properties": {
+                    "type": {
+                        "type": "string",
+                        "options": [{"key": "change_context", "value": "change_context"}],
+                        "title": "Type",
+                        "enum": ["change_context"],
+                    },
+                    "context": {"type": "dict", "title": "Context"},
+                },
+                "meta_class": "TypeMeta",
+                "custom_code": "from typing import Any\n\nfrom amsdal.contrib.frontend_configs.models.frontend_config_skip_none_base import *\n\n\ndef model_dump(self, **kwargs: Any) -> dict[str, Any]:\n    kwargs['exclude_none'] = True\n    return super().model_dump(**kwargs)\n\ndef model_dump_json(self, **kwargs: Any) -> str:\n    kwargs['exclude_none'] = True\n    return super().model_dump_json(**kwargs)",
+                "storage_metadata": {"table_name": "ChangeContextAction", "db_fields": {}, "foreign_keys": {}},
+            },
+        ),
+        migrations.CreateClass(
+            module_type=ModuleType.CONTRIB,
+            class_name="SaveAction",
+            new_schema={
+                "title": "SaveAction",
+                "type": "FrontendConfigSkipNoneBase",
+                "required": ["type"],
+                "properties": {
+                    "type": {
+                        "type": "string",
+                        "options": [{"key": "save", "value": "save"}],
+                        "title": "Type",
+                        "enum": ["save"],
+                    },
+                },
+                "meta_class": "TypeMeta",
+                "custom_code": "from typing import Any\n\nfrom amsdal.contrib.frontend_configs.models.frontend_config_skip_none_base import *\n\n\ndef model_dump(self, **kwargs: Any) -> dict[str, Any]:\n    kwargs['exclude_none'] = True\n    return super().model_dump(**kwargs)\n\ndef model_dump_json(self, **kwargs: Any) -> str:\n    kwargs['exclude_none'] = True\n    return super().model_dump_json(**kwargs)",
+                "storage_metadata": {"table_name": "SaveAction", "db_fields": {}, "foreign_keys": {}},
+            },
+        ),
+        migrations.UpdateClass(
+            module_type=ModuleType.CONTRIB,
+            class_name="FrontendControlConfig",
+            old_schema={
+                "title": "FrontendControlConfig",
+                "type": "FrontendConfigSkipNoneBase",
+                "required": ["type", "name"],
+                "properties": {
+                    "type": {
+                        "type": "string",
+                        "options": [
+                            {"key": "Bytes", "value": "Bytes"},
+                            {"key": "array", "value": "array"},
+                            {"key": "checkbox", "value": "checkbox"},
+                            {"key": "date", "value": "date"},
+                            {"key": "dateTriplet", "value": "dateTriplet"},
+                            {"key": "datetime", "value": "datetime"},
+                            {"key": "dict", "value": "dict"},
+                            {"key": "dropzone", "value": "dropzone"},
+                            {"key": "email", "value": "email"},
+                            {"key": "file", "value": "file"},
+                            {"key": "group", "value": "group"},
+                            {"key": "group_switch", "value": "group_switch"},
+                            {"key": "group_toggle", "value": "group_toggle"},
+                            {"key": "info-group", "value": "info-group"},
+                            {"key": "infoscreen", "value": "infoscreen"},
+                            {"key": "multiselect", "value": "multiselect"},
+                            {"key": "number", "value": "number"},
+                            {"key": "number-operations", "value": "number-operations"},
+                            {"key": "number-slider", "value": "number-slider"},
+                            {"key": "number_equals", "value": "number_equals"},
+                            {"key": "number_initial", "value": "number_initial"},
+                            {"key": "number_minus", "value": "number_minus"},
+                            {"key": "number_plus", "value": "number_plus"},
+                            {"key": "object", "value": "object"},
+                            {"key": "object_group", "value": "object_group"},
+                            {"key": "object_latest", "value": "object_latest"},
+                            {"key": "password", "value": "password"},
+                            {"key": "phone", "value": "phone"},
+                            {"key": "radio", "value": "radio"},
+                            {"key": "select", "value": "select"},
+                            {"key": "text", "value": "text"},
+                            {"key": "textarea", "value": "textarea"},
+                            {"key": "time", "value": "time"},
+                            {"key": "toggle", "value": "toggle"},
+                            {"key": "sections", "value": "sections"},
+                            {"key": "section", "value": "section"},
+                        ],
+                        "title": "Type",
+                        "enum": [
+                            "Bytes",
+                            "array",
+                            "checkbox",
+                            "date",
+                            "dateTriplet",
+                            "datetime",
+                            "dict",
+                            "dropzone",
+                            "email",
+                            "file",
+                            "group",
+                            "group_switch",
+                            "group_toggle",
+                            "info-group",
+                            "infoscreen",
+                            "multiselect",
+                            "number",
+                            "number-operations",
+                            "number-slider",
+                            "number_equals",
+                            "number_initial",
+                            "number_minus",
+                            "number_plus",
+                            "object",
+                            "object_group",
+                            "object_latest",
+                            "password",
+                            "phone",
+                            "radio",
+                            "select",
+                            "text",
+                            "textarea",
+                            "time",
+                            "toggle",
+                            "sections",
+                            "section",
+                        ],
+                    },
+                    "name": {"type": "string", "title": "Name"},
+                    "actions": {
+                        "type": "array",
+                        "items": {"type": "FrontendConfigControlAction", "title": "FrontendConfigControlAction"},
+                        "title": "Actions",
+                    },
+                },
+                "meta_class": "TypeMeta",
+                "storage_metadata": {"table_name": "FrontendControlConfig", "db_fields": {}, "foreign_keys": {}},
+            },
+            new_schema={
+                "title": "FrontendControlConfig",
+                "type": "FrontendConfigSkipNoneBase",
+                "required": ["type", "name"],
+                "properties": {
+                    "type": {
+                        "type": "string",
+                        "options": [
+                            {"key": "Bytes", "value": "Bytes"},
+                            {"key": "array", "value": "array"},
+                            {"key": "button", "value": "button"},
+                            {"key": "chat", "value": "chat"},
+                            {"key": "checkbox", "value": "checkbox"},
+                            {"key": "date", "value": "date"},
+                            {"key": "dateTriplet", "value": "dateTriplet"},
+                            {"key": "datetime", "value": "datetime"},
+                            {"key": "dict", "value": "dict"},
+                            {"key": "dropzone", "value": "dropzone"},
+                            {"key": "email", "value": "email"},
+                            {"key": "file", "value": "file"},
+                            {"key": "group", "value": "group"},
+                            {"key": "group_switch", "value": "group_switch"},
+                            {"key": "group_toggle", "value": "group_toggle"},
+                            {"key": "info-group", "value": "info-group"},
+                            {"key": "infoscreen", "value": "infoscreen"},
+                            {"key": "multiselect", "value": "multiselect"},
+                            {"key": "number", "value": "number"},
+                            {"key": "number-operations", "value": "number-operations"},
+                            {"key": "number-slider", "value": "number-slider"},
+                            {"key": "number_equals", "value": "number_equals"},
+                            {"key": "number_initial", "value": "number_initial"},
+                            {"key": "number_minus", "value": "number_minus"},
+                            {"key": "number_plus", "value": "number_plus"},
+                            {"key": "object", "value": "object"},
+                            {"key": "object_group", "value": "object_group"},
+                            {"key": "object_latest", "value": "object_latest"},
+                            {"key": "password", "value": "password"},
+                            {"key": "phone", "value": "phone"},
+                            {"key": "radio", "value": "radio"},
+                            {"key": "select", "value": "select"},
+                            {"key": "text", "value": "text"},
+                            {"key": "textarea", "value": "textarea"},
+                            {"key": "time", "value": "time"},
+                            {"key": "toggle", "value": "toggle"},
+                            {"key": "sections", "value": "sections"},
+                            {"key": "section", "value": "section"},
+                        ],
+                        "title": "Type",
+                        "enum": [
+                            "Bytes",
+                            "array",
+                            "button",
+                            "chat",
+                            "checkbox",
+                            "date",
+                            "dateTriplet",
+                            "datetime",
+                            "dict",
+                            "dropzone",
+                            "email",
+                            "file",
+                            "group",
+                            "group_switch",
+                            "group_toggle",
+                            "info-group",
+                            "infoscreen",
+                            "multiselect",
+                            "number",
+                            "number-operations",
+                            "number-slider",
+                            "number_equals",
+                            "number_initial",
+                            "number_minus",
+                            "number_plus",
+                            "object",
+                            "object_group",
+                            "object_latest",
+                            "password",
+                            "phone",
+                            "radio",
+                            "select",
+                            "text",
+                            "textarea",
+                            "time",
+                            "toggle",
+                            "sections",
+                            "section",
+                        ],
+                    },
+                    "name": {"type": "string", "title": "Name"},
+                    "actions": {
+                        "type": "array",
+                        "items": {"type": "anything"},
+                        "title": "Actions",
+                    },
+                },
+                "meta_class": "TypeMeta",
+                "custom_code": "from typing import Any\n\nfrom amsdal.contrib.frontend_configs.models.frontend_config_skip_none_base import *\n\n\ndef model_dump(self, **kwargs: Any) -> dict[str, Any]:\n    kwargs['exclude_none'] = True\n    return super().model_dump(**kwargs)\n\ndef model_dump_json(self, **kwargs: Any) -> str:\n    kwargs['exclude_none'] = True\n    return super().model_dump_json(**kwargs)",
+                "storage_metadata": {"table_name": "FrontendControlConfig", "db_fields": {}, "foreign_keys": {}},
+            },
+        ),
+    ]

amsdal/contrib/frontend_configs/models/frontend_config_control_action.py

@@ -1,15 +1,27 @@
 from typing import Any
 from typing import ClassVar
+from typing import Literal
 
 from amsdal_models.builder.validators.options_validators import validate_options
 from amsdal_utils.models.enums import ModuleType
+from pydantic import Field
 from pydantic import field_validator
-from pydantic.fields import Field
 
 from amsdal.contrib.frontend_configs.models.frontend_config_skip_none_base import *  # noqa: F403
 
+__all__ = [
+    'ActionType',
+    'ChangeContextAction',
+    'FrontendConfigControlAction',
+    'InvokeAction',
+    'SaveAction',
+    'UpdateValueAction',
+]
+
 
 class FrontendConfigControlAction(FrontendConfigSkipNoneBase):  # noqa: F405
+    """Navigation action for form controls (backward compatible)."""
+
     __module_type__: ClassVar[ModuleType] = ModuleType.CONTRIB
     action: str = Field(title='Action')
     text: str = Field(title='Text')
@@ -52,3 +64,47 @@ class FrontendConfigControlAction(FrontendConfigSkipNoneBase):  # noqa: F405
             msg = 'Action must be one of: goPrev, goNext, goNextWithSubmit, submit, submitWithDataLayer, navigate::{string}'  # noqa: E501
             raise ValueError(msg)
         return v
+
+
+class UpdateValueAction(FrontendConfigSkipNoneBase):  # noqa: F405
+    """Action to update a field value (used in onSuccess callbacks)."""
+
+    __module_type__: ClassVar[ModuleType] = ModuleType.CONTRIB
+    type: Literal['update_value'] = Field(title='Type')
+    field_id: str = Field(title='Field ID')
+    value: Any = Field(title='Value')
+
+
+class InvokeAction(FrontendConfigSkipNoneBase):  # noqa: F405
+    """Action to invoke an API endpoint."""
+
+    __module_type__: ClassVar[ModuleType] = ModuleType.CONTRIB
+    type: Literal['invoke'] = Field(title='Type')
+    method: Literal['GET', 'POST', 'PUT', 'PATCH', 'DELETE'] = Field(title='HTTP Method')
+    url: str = Field(title='URL')
+    headers: dict[str, str] | None = Field(None, title='Headers')
+    body: dict[str, Any] | None = Field(None, title='Body')
+    onSuccess: list['ActionType'] | None = Field(None, title='On Success Actions')  # noqa: N815
+    onError: list['ActionType'] | None = Field(None, title='On Error Actions')  # noqa: N815
+
+
+class ChangeContextAction(FrontendConfigSkipNoneBase):  # noqa: F405
+    """Action to change the context."""
+
+    __module_type__: ClassVar[ModuleType] = ModuleType.CONTRIB
+    type: Literal['change_context'] = Field(title='Type')
+    context: dict[str, Any] = Field(title='Context')
+
+
+class SaveAction(FrontendConfigSkipNoneBase):  # noqa: F405
+    """Action to save data."""
+
+    __module_type__: ClassVar[ModuleType] = ModuleType.CONTRIB
+    type: Literal['save'] = Field(title='Type')
+
+
+# Union type for all action types - discriminated by 'type' field
+ActionType = FrontendConfigControlAction | InvokeAction | UpdateValueAction | ChangeContextAction | SaveAction
+
+# Rebuild model to handle forward references
+InvokeAction.model_rebuild()

amsdal/contrib/frontend_configs/models/frontend_control_config.py

@@ -1,3 +1,4 @@
+from typing import TYPE_CHECKING
 from typing import Any
 from typing import ClassVar
 from typing import Literal
@@ -15,9 +16,14 @@ from amsdal.contrib.frontend_configs.models.frontend_config_slider_option import
 from amsdal.contrib.frontend_configs.models.frontend_config_text_mask import *  # noqa: F403
 from amsdal.contrib.frontend_configs.models.frontend_config_validator import *  # noqa: F403
 
+if TYPE_CHECKING:
+    from amsdal.contrib.frontend_configs.models.frontend_config_control_action import ActionType
+
 ConfigType = Literal[
     'Bytes',
     'array',
+    'button',
+    'chat',
     'checkbox',
     'date',
     'dateTriplet',
@@ -77,7 +83,7 @@ class FrontendControlConfig(FrontendConfigSkipNoneBase):  # noqa: F405
     label: str | None = Field(None, title='Label')
     required: bool | None = Field(None, title='Required')
     hideLabel: bool | None = Field(None, title='Hide Label')  # noqa: N815
-    actions: list['FrontendConfigControlAction'] | None = Field(None, title='Actions')  # noqa: F405
+    actions: list[ActionType] | None = Field(None, title='Actions')  # noqa: F405
     validators: list['FrontendConfigValidator'] | None = Field(None, title='Validators')  # noqa: F405
     asyncValidators: list['FrontendConfigAsyncValidator'] | None = Field(  # noqa: F405, N815
         None,
@@ -96,3 +102,6 @@ class FrontendControlConfig(FrontendConfigSkipNoneBase):  # noqa: F405
     control: Optional['FrontendControlConfig'] = Field(None, title='Control')
     entityType: str | None = Field(None, title='Entity Type')  # noqa: N815
     condition: Condition | None = Field(None, title='Condition')  # noqa: F405
+
+
+FrontendControlConfig.model_rebuild()

amsdal/services/__init__.py

@@ -0,0 +1,11 @@
+# AMSDAL services package
+
+from amsdal.services.external_connections import ExternalConnectionManager
+from amsdal.services.external_connections import ExternalDatabaseReader
+from amsdal.services.external_model_generator import ExternalModelGenerator
+
+__all__ = [
+    'ExternalConnectionManager',
+    'ExternalDatabaseReader',
+    'ExternalModelGenerator',
+]