amsdal 0.4.10__cp312-cp312-macosx_10_13_universal2.whl → 0.5.33__cp312-cp312-macosx_10_13_universal2.whl

amsdal/contrib/frontend_configs/migrations/0003_create_class_frontendconfigdashboardelement.py

@@ -0,0 +1,145 @@
+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="FrontendConfigDashboard",
+            new_schema={
+                "title": "FrontendConfigDashboard",
+                "required": ["title", "elements"],
+                "properties": {
+                    "title": {"type": "string", "title": "Title", "description": "Title of the dashboard"},
+                    "elements": {
+                        "type": "array",
+                        "items": {"type": "FrontendConfigDashboardElement", "title": "FrontendConfigDashboardElement"},
+                        "title": "Elements",
+                        "description": "List of dashboard elements",
+                    },
+                },
+                "storage_metadata": {
+                    "table_name": "FrontendConfigDashboard",
+                    "db_fields": {},
+                    "primary_key": ["partition_key"],
+                    "foreign_keys": {},
+                },
+            },
+        ),
+        migrations.CreateClass(
+            module_type=ModuleType.CONTRIB,
+            class_name="FrontendConfigDashboardElement",
+            new_schema={
+                "title": "FrontendConfigDashboardElement",
+                "required": ["type"],
+                "properties": {
+                    "type": {
+                        "type": "string",
+                        "options": [
+                            {"key": "section", "value": "section"},
+                            {"key": "grid", "value": "grid"},
+                            {"key": "grid_col", "value": "grid_col"},
+                            {"key": "chart", "value": "chart"},
+                            {"key": "table", "value": "table"},
+                        ],
+                        "title": "Type",
+                        "enum": ["section", "grid", "grid_col", "chart", "table"],
+                    },
+                    "chart_type": {
+                        "type": "string",
+                        "title": "Chart Type",
+                        "description": "Type of chart (for chart elements)",
+                    },
+                    "columns": {
+                        "type": "integer",
+                        "title": "Columns",
+                        "description": "Number of columns for grid layout",
+                    },
+                    "rows": {"type": "integer", "title": "Rows", "description": "Number of rows for grid layout"},
+                    "title": {"type": "string", "title": "Title", "description": "Title of the dashboard element"},
+                    "elements": {
+                        "type": "array",
+                        "items": {"type": "FrontendConfigDashboardElement", "title": "FrontendConfigDashboardElement"},
+                        "title": "Elements",
+                        "description": "Nested dashboard elements for section or grid types",
+                    },
+                    "data_source": {
+                        "type": "FrontendConfigDashboardDataSource",
+                        "title": "FrontendConfigDashboardDataSource",
+                        "description": "Data source configuration for chart or table elements",
+                    },
+                },
+                "meta_class": "TypeMeta",
+                "storage_metadata": {
+                    "table_name": "FrontendConfigDashboardElement",
+                    "db_fields": {},
+                    "foreign_keys": {},
+                },
+            },
+        ),
+        migrations.CreateClass(
+            module_type=ModuleType.CONTRIB,
+            class_name="FrontendConfigDashboardQueryParams",
+            new_schema={
+                "title": "FrontendConfigDashboardQueryParams",
+                "required": ["field", "operator"],
+                "properties": {
+                    "field": {"type": "string", "title": "Field", "description": "Field name for the query parameter"},
+                    "operator": {
+                        "type": "string",
+                        "title": "Operator",
+                        "description": "Operator for the query parameter",
+                    },
+                    "value": {"type": "anything", "title": "Value", "description": "Value for the query parameter"},
+                },
+                "meta_class": "TypeMeta",
+                "storage_metadata": {
+                    "table_name": "FrontendConfigDashboardQueryParams",
+                    "db_fields": {},
+                    "foreign_keys": {},
+                },
+            },
+        ),
+        migrations.CreateClass(
+            module_type=ModuleType.CONTRIB,
+            class_name="FrontendConfigDashboardDataSource",
+            new_schema={
+                "title": "FrontendConfigDashboardDataSource",
+                "required": ["type", "entity_name"],
+                "properties": {
+                    "type": {
+                        "type": "string",
+                        "options": [{"key": "class", "value": "class"}, {"key": "transaction", "value": "transaction"}],
+                        "title": "Type",
+                        "enum": ["class", "transaction"],
+                    },
+                    "entity_name": {
+                        "type": "string",
+                        "title": "Entity Name",
+                        "description": "Name of the entity or transaction",
+                    },
+                    "query_params": {
+                        "type": "array",
+                        "items": {
+                            "type": "FrontendConfigDashboardQueryParams",
+                            "title": "FrontendConfigDashboardQueryParams",
+                        },
+                        "title": "Query Params",
+                        "description": "List of query parameters for filtering data (for class type)",
+                    },
+                    "body": {
+                        "type": "anything",
+                        "title": "Body",
+                        "description": "Request body for transaction data source (for transaction type)",
+                    },
+                },
+                "meta_class": "TypeMeta",
+                "storage_metadata": {
+                    "table_name": "FrontendConfigDashboardDataSource",
+                    "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_config_dashboard.py

@@ -0,0 +1,51 @@
+from typing import Any
+from typing import ClassVar
+from typing import Literal
+from typing import Optional
+
+from amsdal_models.classes.model import Model
+from amsdal_models.classes.model import TypeModel
+from amsdal_utils.models.enums import ModuleType
+from pydantic.fields import Field
+
+
+class FrontendConfigDashboardQueryParams(TypeModel):
+    __module_type__: ClassVar[ModuleType] = ModuleType.CONTRIB
+
+    field: str = Field(..., description='Field name for the query parameter')
+    operator: str = Field(..., description='Operator for the query parameter')
+    value: Optional[Any] = Field(None, description='Value for the query parameter')
+
+
+class FrontendConfigDashboardDataSource(TypeModel):
+    __module_type__: ClassVar[ModuleType] = ModuleType.CONTRIB
+
+    type: Literal['class', 'transaction']
+    entity_name: str = Field(..., description='Name of the entity or transaction')
+    query_params: list[FrontendConfigDashboardQueryParams] | None = Field(
+        None, description='List of query parameters for filtering data (for class type)'
+    )
+    body: Any = Field(None, description='Request body for transaction data source (for transaction type)')
+
+
+class FrontendConfigDashboardElement(TypeModel):
+    __module_type__: ClassVar[ModuleType] = ModuleType.CONTRIB
+
+    type: Literal['section', 'grid', 'grid_col', 'chart', 'table']
+    chart_type: str | None = Field(None, description='Type of chart (for chart elements)')
+    columns: int | None = Field(None, description='Number of columns for grid layout')
+    rows: int | None = Field(None, description='Number of rows for grid layout')
+    title: str | None = Field(None, description='Title of the dashboard element')
+    elements: list['FrontendConfigDashboardElement'] | None = Field(
+        None, description='Nested dashboard elements for section or grid types'
+    )
+    data_source: FrontendConfigDashboardDataSource | None = Field(
+        None, description='Data source configuration for chart or table elements'
+    )
+
+
+class FrontendConfigDashboard(Model):
+    __module_type__: ClassVar[ModuleType] = ModuleType.CONTRIB
+
+    title: str = Field(..., description='Title of the dashboard')
+    elements: list[FrontendConfigDashboardElement] = Field(..., description='List of dashboard elements')

amsdal/contrib/frontend_configs/models/frontend_control_config.py

@@ -1,11 +1,11 @@
+from typing import TYPE_CHECKING
 from typing import Any
 from typing import ClassVar
+from typing import Literal
 from typing import Optional
 
-from amsdal_models.builder.validators.options_validators import validate_options
 from amsdal_utils.models.enums import ModuleType
 from pydantic.fields import Field
-from pydantic.functional_validators import field_validator
 
 from amsdal.contrib.frontend_configs.models.frontend_activator_config import *  # noqa: F403
 from amsdal.contrib.frontend_configs.models.frontend_config_async_validator import *  # noqa: F403
@@ -16,15 +16,77 @@ 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',
+    'attachment',
+    'wizard',
+    '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',
+]
+
+
+class ConditionItem(FrontendConfigSkipNoneBase):  # noqa: F405
+    path: str = Field(title='Path')
+    condition: str = Field(title='Condition')
+    value: Any = Field(default=None, title='Value')
+
+
+class Condition(FrontendConfigSkipNoneBase):  # noqa: F405
+    __module_type__: ClassVar[ModuleType] = ModuleType.CONTRIB
+    operation: Literal['and', 'or', 'not'] = Field(title='Operation')
+    conditions: list[ConditionItem] = Field(title='Conditions')  # noqa: F405
+
+
+Condition.model_rebuild()
+
 
 class FrontendControlConfig(FrontendConfigSkipNoneBase):  # noqa: F405
     __module_type__: ClassVar[ModuleType] = ModuleType.CONTRIB
-    type: str = Field(title='Type')
+    id: str | None = Field(None, title='ID')
+    type: ConfigType = Field(title='Type')
     name: str = Field(title='Name')
     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,
@@ -42,46 +104,7 @@ class FrontendControlConfig(FrontendConfigSkipNoneBase):  # noqa: F405
     customLabel: list[str] | None = Field(None, title='Custom Label')  # noqa: N815
     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
+
 
-    @field_validator('type')
-    @classmethod
-    def validate_value_in_options_type(cls: type, value: Any) -> Any:  # type: ignore # noqa: A003
-        return validate_options(
-            value,
-            options=[
-                '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',
-            ],
-        )
+FrontendControlConfig.model_rebuild()

amsdal/manager.pyi

@@ -5,6 +5,7 @@ from amsdal.configs.main import settings as settings
 from amsdal.errors import AmsdalAuthenticationError as AmsdalAuthenticationError, AmsdalMissingCredentialsError as AmsdalMissingCredentialsError, AmsdalRuntimeError as AmsdalRuntimeError, AmsdalSignupError as AmsdalSignupError
 from amsdal.fixtures.manager import AsyncFixturesManager as AsyncFixturesManager, FixturesManager as FixturesManager
 from amsdal.mixins.class_versions_mixin import ClassVersionsMixin as ClassVersionsMixin
+from amsdal_data.transactions.decorators import async_transaction, transaction
 from amsdal_models.classes.class_manager import ClassManager
 from amsdal_utils.config.data_models.amsdal_config import AmsdalConfig as AmsdalConfig
 from amsdal_utils.utils.singleton import Singleton
@@ -69,6 +70,7 @@ class AmsdalManager(ClassVersionsMixin, metaclass=Singleton):
         Returns:
             None
         """
+    @transaction
     def post_setup(self) -> None:
         """
         Registers internal classes and prepares connections (creates internal tables).
@@ -98,6 +100,7 @@ class AmsdalManager(ClassVersionsMixin, metaclass=Singleton):
         Returns:
             None
         """
+    @transaction
     def apply_fixtures(self) -> None:
         """
         Loads and applies fixtures defined in your application.
@@ -194,6 +197,7 @@ class AsyncAmsdalManager(ClassVersionsMixin, metaclass=Singleton):
         Returns:
             None
         """
+    @async_transaction
     async def post_setup(self) -> None:
         """
         Registers internal classes and prepares connections (creates internal tables).
@@ -223,6 +227,7 @@ class AsyncAmsdalManager(ClassVersionsMixin, metaclass=Singleton):
         Returns:
             None
         """
+    @async_transaction
     async def apply_fixtures(self) -> None:
         """
         Loads and applies fixtures defined in your application.

amsdal/models/core/class_object.py

@@ -9,21 +9,22 @@ from pydantic.fields import Field
 from pydantic.functional_validators import field_validator
 
 from amsdal.models.core.class_property import *  # noqa: F403
+from amsdal.models.core.storage_metadata import *  # noqa: F403
 
 
 class ClassObject(Model):
     __module_type__: ClassVar[ModuleType] = ModuleType.CORE
+    title: str = Field(title='Title')
+    type: str = Field(title='Type')
+    module_type: str = Field(title='Module Type')
     properties: Optional[dict[str, Optional['ClassProperty']]] = Field(None, title='Properties')  # noqa: F405, UP007
-    table_name: Optional[str] = Field(None, title='Table name')  # noqa: UP007
-    primary_key: Optional[list[str]] = Field(None, title='Primary key fields')  # noqa: UP007
-    indexed: Optional[list[str]] = Field(None, title='Indexed')  # noqa: UP007
-    unique: Optional[list[list[str]]] = Field(None, title='Unique Fields')  # noqa: UP007
     required: Optional[list[str]] = Field(None, title='Required')  # noqa: UP007
-    meta_class: Optional[str] = Field('ClassObject', title='Meta Class')  # noqa: UP007
+    custom_code: str | None = Field(None, title='Custom Code')
+    storage_metadata: Optional['StorageMetadata'] = Field(None, title='Storage metadata')  # noqa: F405
 
     @field_validator('properties')
     @classmethod
-    def _non_empty_keys_properties(cls: type, value: Any) -> Any:
+    def _non_empty_keys_properties(cls: type, value: Any) -> Any:  # type: ignore # noqa: A003
         return validate_non_empty_keys(value)
 
     @property

amsdal/models/core/class_property.py

@@ -7,12 +7,18 @@ from amsdal_utils.models.enums import ModuleType
 from pydantic.fields import Field
 from pydantic.functional_validators import field_validator
 
+from amsdal.models.core.option import *  # noqa: F403
+
 
 class ClassProperty(TypeModel):
     __module_type__: ClassVar[ModuleType] = ModuleType.CORE
+    title: str | None = Field(None, title='Title')
     type: str = Field(title='Type')
+    default: Any | None = Field(None, title='Default')
+    options: list['Option'] | None = Field(None, title='Options')  # noqa: F405
     items: dict[str, Any | None] | None = Field(None, title='Items')
-    db_field: list[str] | None = Field(None, title='DB Fields')
+    discriminator: str | None = Field(None, title='Discriminator')
+    extra: dict[str, Any | None] = Field(default_factory=dict, title='Extra')
 
     @field_validator('items')
     @classmethod