statezero 0.1.0b4__py3-none-any.whl → 0.1.0b6__py3-none-any.whl

statezero/core/interfaces.py

@@ -1,104 +1,126 @@
 from __future__ import annotations
 
 from abc import ABC, abstractmethod
-from typing import Any, Callable, Dict, List, Optional, Set, Tuple, Type, Union, Literal, Protocol
+from typing import (
+    Any,
+    Callable,
+    Dict,
+    List,
+    Optional,
+    Set,
+    Tuple,
+    Type,
+    Union,
+    Literal,
+    Protocol,
+)
 
 from statezero.core.classes import ModelSchemaMetadata, SchemaFieldMetadata
-from statezero.core.types import (ActionType, ORMField, ORMModel, ORMQuerySet, RequestType)
+from statezero.core.types import (
+    ActionType,
+    ORMField,
+    ORMModel,
+    ORMQuerySet,
+    RequestType,
+)
+
 
 class AbstractORMProvider(ABC):
     """
     A merged ORM engine interface that combines both query building (filtering,
     ordering, aggregation, etc.) and ORM provider responsibilities (queryset assembly,
     event signal registration, model graph construction, etc.).
+
+    UPDATED: All query manipulation methods now take queryset parameters and return
+    new querysets instead of mutating internal state.
     """
 
-    # === Query Engine Methods ===
+    # === Query Engine Methods (UPDATED: Now stateless) ===
 
     @abstractmethod
-    def get_fields(self) -> Set[str]:
+    def get_fields(self, model: ORMModel) -> Set[str]:
         """
         Get all of the model fields - doesn't apply permissions check.
         """
         pass
 
     @abstractmethod
-    def filter_node(self, node: Dict[str, Any]) -> None:
+    def filter_node(self, queryset: ORMQuerySet, node: Dict[str, Any]) -> ORMQuerySet:
         """
-        Apply filter/and/or/not logic to the current query.
+        Apply filter/and/or/not logic to the queryset and return new queryset.
         """
         pass
 
     @abstractmethod
-    def search_node(self, search_query: str, search_fields: Set[str]) -> None:
+    def search_node(
+        self, queryset: ORMQuerySet, search_query: str, search_fields: Set[str]
+    ) -> ORMQuerySet:
         """
-        Apply search to the current query.
+        Apply search to the queryset and return new queryset.
         """
         pass
 
     @abstractmethod
-    def create(self, data: Dict[str, Any]) -> Any:
-        """Create a new record."""
-        pass
-
-    @abstractmethod
-    def update(self, node: Dict[str, Any]) -> int:
+    def exclude_node(self, queryset: ORMQuerySet, node: Dict[str, Any]) -> ORMQuerySet:
         """
-        Update records (by filter or primary key).
-        Returns the number of rows updated.
+        Apply exclude logic to the queryset and return new queryset.
         """
         pass
 
     @abstractmethod
-    def delete(self, node: Dict[str, Any]) -> int:
+    def order_by(self, queryset: ORMQuerySet, order_list: List[str]) -> ORMQuerySet:
         """
-        Delete records (by filter or primary key).
-        Returns the number of rows deleted.
+        Order the queryset based on a list of fields and return new queryset.
         """
         pass
 
     @abstractmethod
-    def get(self, node: Dict[str, Any]) -> Any:
+    def select_related(
+        self, queryset: ORMQuerySet, related_fields: List[str]
+    ) -> ORMQuerySet:
         """
-        Retrieve a single record. Raises an error if multiple or none are found.
+        Optimize the queryset by eager loading the given related fields and return new queryset.
         """
         pass
 
     @abstractmethod
-    def get_or_create(self, node: Dict[str, Any]) -> Tuple[Any, bool]:
+    def prefetch_related(
+        self, queryset: ORMQuerySet, related_fields: List[str]
+    ) -> ORMQuerySet:
         """
-        Retrieve a record if it exists, otherwise create it.
-        Returns a tuple of (instance, created_flag).
+        Optimize the queryset by prefetching the given related fields and return new queryset.
         """
         pass
 
     @abstractmethod
-    def update_or_create(self, node: Dict[str, Any]) -> Tuple[Any, bool]:
+    def select_fields(self, queryset: ORMQuerySet, fields: List[str]) -> ORMQuerySet:
         """
-        Update a record if it exists or create it if it doesn't.
-        Returns a tuple of (instance, created_flag).
+        Select only specific fields from the queryset and return new queryset.
         """
         pass
 
     @abstractmethod
-    def first(self) -> Any:
-        """Return the first record from the current query."""
-        pass
-
-    @abstractmethod
-    def last(self) -> Any:
-        """Return the last record from the current query."""
+    def fetch_list(
+        self,
+        queryset: ORMQuerySet,
+        offset: Optional[int] = None,
+        limit: Optional[int] = None,
+        req: Optional[RequestType] = None,
+        permissions: Optional[List[Type]] = None,
+    ) -> ORMQuerySet:
+        """
+        Return a sliced queryset based on pagination with permission checks.
+        """
         pass
 
-    @abstractmethod
-    def exists(self) -> bool:
-        """Return True if the current query has any results; otherwise False."""
-        pass
+    # === Aggregate Methods (UPDATED: Take queryset parameter) ===
 
     @abstractmethod
-    def aggregate(self, agg_list: List[Dict[str, Any]]) -> Dict[str, Any]:
+    def aggregate(
+        self, queryset: ORMQuerySet, agg_list: List[Dict[str, Any]]
+    ) -> Dict[str, Any]:
         """
-        Aggregate the current query based on the provided functions.
+        Aggregate the queryset based on the provided functions.
         Example:
           [
             {'function': 'count', 'field': 'id', 'alias': 'id_count'},
@@ -108,60 +130,155 @@ class AbstractORMProvider(ABC):
         pass
 
     @abstractmethod
-    def count(self, field: str) -> int:
+    def count(self, queryset: ORMQuerySet, field: str) -> int:
         """Count the number of records for the given field."""
         pass
 
     @abstractmethod
-    def sum(self, field: str) -> Any:
+    def sum(self, queryset: ORMQuerySet, field: str) -> Any:
         """Sum the values of the given field."""
         pass
 
     @abstractmethod
-    def avg(self, field: str) -> Any:
+    def avg(self, queryset: ORMQuerySet, field: str) -> Any:
         """Calculate the average of the given field."""
         pass
 
     @abstractmethod
-    def min(self, field: str) -> Any:
+    def min(self, queryset: ORMQuerySet, field: str) -> Any:
         """Find the minimum value for the given field."""
         pass
 
     @abstractmethod
-    def max(self, field: str) -> Any:
+    def max(self, queryset: ORMQuerySet, field: str) -> Any:
         """Find the maximum value for the given field."""
         pass
 
     @abstractmethod
-    def order_by(self, order_list: List[Dict[str, str]]) -> None:
+    def first(self, queryset: ORMQuerySet) -> Any:
+        """Return the first record from the queryset."""
+        pass
+
+    @abstractmethod
+    def last(self, queryset: ORMQuerySet) -> Any:
+        """Return the last record from the queryset."""
+        pass
+
+    @abstractmethod
+    def exists(self, queryset: ORMQuerySet) -> bool:
+        """Return True if the queryset has any results; otherwise False."""
+        pass
+
+    # === CRUD Methods (UPDATED: Take model or queryset parameters explicitly) ===
+
+    @abstractmethod
+    def create(
+        self, model: Type[ORMModel], data: Dict[str, Any], *args, **kwargs
+    ) -> Any:
+        """Create a new record using the model class."""
+        pass
+
+    @abstractmethod
+    def update(
+        self,
+        queryset: ORMQuerySet,
+        node: Dict[str, Any],
+        req: RequestType,
+        permissions: List[Type],
+        readable_fields: Optional[Set[str]] = None,
+    ) -> Tuple[int, List[Any]]:
         """
-        Order the query based on a list of fields.
-        Each dict should contain 'field' and optionally 'direction' ('asc' or 'desc').
+        Update records in the queryset.
+        Returns tuple of (number of rows updated, updated instances).
         """
         pass
 
     @abstractmethod
-    def select_related(self, related_fields: List[str]) -> None:
+    def delete(
+        self,
+        queryset: ORMQuerySet,
+        node: Dict[str, Any],
+        req: RequestType,
+        permissions: List[Type],
+    ) -> Tuple[int, Any]:
         """
-        Optimize the query by eager loading the given related fields.
+        Delete records in the queryset.
+        Returns tuple of (number of rows deleted, deleted instance data).
         """
         pass
 
     @abstractmethod
-    def prefetch_related(self, related_fields: List[str]) -> None:
+    def get(
+        self,
+        queryset: ORMQuerySet,
+        node: Dict[str, Any],
+        req: RequestType,
+        permissions: List[Type],
+    ) -> Any:
         """
-        Optimize the query by prefetching the given related fields.
+        Retrieve a single record from the queryset.
+        Raises an error if multiple or none are found.
         """
         pass
 
     @abstractmethod
-    def fetch_list(self, offset: int, limit: int) -> List[Any]:
+    def get_or_create(
+        self,
+        queryset: ORMQuerySet,
+        node: Dict[str, Any],
+        serializer: Any,
+        req: RequestType,
+        permissions: List[Type],
+        create_fields_map: Dict[str, Set[str]],
+    ) -> Tuple[Any, bool]:
         """
-        Return a list of records (as dicts or objects) based on pagination.
+        Retrieve a record if it exists, otherwise create it.
+        Returns a tuple of (instance, created_flag).
         """
         pass
 
-    # === ORM Provider Methods ===
+    @abstractmethod
+    def update_or_create(
+        self,
+        queryset: ORMQuerySet,
+        node: Dict[str, Any],
+        req: RequestType,
+        serializer: Any,
+        permissions: List[Type],
+        update_fields_map: Dict[str, Set[str]],
+        create_fields_map: Dict[str, Set[str]],
+    ) -> Tuple[Any, bool]:
+        """
+        Update a record if it exists or create it if it doesn't.
+        Returns a tuple of (instance, created_flag).
+        """
+        pass
+
+    @abstractmethod
+    def update_instance(
+        self,
+        model: Type[ORMModel],
+        ast: Dict[str, Any],
+        req: RequestType,
+        permissions: List[Type],
+        serializer: Any,
+        fields_map: Dict[str, Set[str]],
+    ) -> Any:
+        """Update a single model instance by filter."""
+        pass
+
+    @abstractmethod
+    def delete_instance(
+        self,
+        model: Type[ORMModel],
+        ast: Dict[str, Any],
+        req: RequestType,
+        permissions: List[Type],
+    ) -> int:
+        """Delete a single model instance by filter."""
+        pass
+
+    # === ORM Provider Methods (Unchanged - these are utility methods) ===
 
     @abstractmethod
     def get_queryset(
@@ -205,29 +322,32 @@ class AbstractORMProvider(ABC):
         pass
 
     @abstractmethod
-    def get_user(self, request: RequestType): # returns User
+    def get_user(self, request: RequestType):  # returns User
         """
         Get the request user.
         """
         pass
 
     @abstractmethod
-    def build_model_graph(self, model: ORMModel) -> None:  # type:ignore
+    def build_model_graph(self, model: ORMModel) -> Any:  # type:ignore
         """
         Construct a graph representation of model relationships.
         """
         pass
 
 
+# === Other Abstract Classes (Unchanged) ===
+
+
 class AbstractCustomQueryset(ABC):
     @abstractmethod
     def get_queryset(self, request: Optional[RequestType] = None) -> Any:
         """
         Return a custom queryset (e.g. a custom SQLAlchemy Query or Django QuerySet).
-        
+
         Args:
             request: The current request object, which may contain user information
-        
+
         Returns:
             A custom queryset
         """
@@ -302,7 +422,7 @@ class AbstractEventEmitter(ABC):
     ) -> None:
         """
         Emit an event to the specified namespace with the given event type and data.
-        
+
         Parameters:
         -----------
         namespace: str
@@ -332,6 +452,29 @@ class AbstractEventEmitter(ABC):
 # --- Permissions ---
 
 
+class AbstractActionPermission(ABC):
+    """
+    Permission class for StateZero actions.
+    Similar to DRF BasePermission but with access to validated data and
+    gives the action instead of the view.
+    """
+
+    @abstractmethod
+    def has_permission(self, request, action_name: str) -> bool:
+        """
+        View-level permission check (before validation).
+        Similar to DRF BasePermission.has_permission
+        """
+        pass
+
+    @abstractmethod
+    def has_action_permission(self, request, action_name: str, validated_data: dict) -> bool:
+        """
+        Action-level permission check (after validation).
+        This is where you check permissions that depend on the actual data.
+        """
+        pass
+
 class AbstractPermission(ABC):
     @abstractmethod
     def filter_queryset(
@@ -408,22 +551,28 @@ class AbstractPermission(ABC):
 
 class AbstractSearchProvider(ABC):
     """Base class for search providers in StateZero."""
-    
+
     @abstractmethod
-    def search(self, queryset: ORMQuerySet, query: str, search_fields: Union[Set[str], Literal["__all__"]]) -> ORMQuerySet:
+    def search(
+        self,
+        queryset: ORMQuerySet,
+        query: str,
+        search_fields: Union[Set[str], Literal["__all__"]],
+    ) -> ORMQuerySet:
         """
         Apply search filtering to a queryset.
-        
+
         Args:
             queryset: Django queryset
             query: The search query string
             search_fields: Set of field names to search in
-            
+
         Returns:
             Filtered queryset with search applied
         """
         pass
 
+
 class AbstractQueryOptimizer(ABC):
     """
     Abstract Base Class for query optimizers.
@@ -436,7 +585,7 @@ class AbstractQueryOptimizer(ABC):
         self,
         depth: Optional[int] = None,
         fields_per_model: Optional[Dict[str, Set[str]]] = None,
-        get_model_name_func: Optional[Callable[[Type[ORMModel]], str]] = None
+        get_model_name_func: Optional[Callable[[Type[ORMModel]], str]] = None,
     ):
         """
         Initializes the optimizer with common configuration potentially
@@ -462,10 +611,7 @@ class AbstractQueryOptimizer(ABC):
 
     @abstractmethod
     def optimize(
-        self,
-        queryset: Any,
-        fields: Optional[List[str]] = None,
-        **kwargs: Any
+        self, queryset: Any, fields: Optional[List[str]] = None, **kwargs: Any
     ) -> Any:
         """
         Optimizes the given query object.
@@ -489,4 +635,4 @@ class AbstractQueryOptimizer(ABC):
             ValueError: If required parameters (like 'fields' or init config
                         for generation) are missing.
         """
-        raise NotImplementedError
+        raise NotImplementedError

statezero/core/process_request.py

@@ -170,13 +170,13 @@ class RequestProcessor:
                 )
 
         # Create and use the AST parser directly, instead of delegating to ORM provider
-        self.orm_provider.set_queryset(base_queryset)
         parser = ASTParser(
             engine=self.orm_provider,
             serializer=self.data_serializer,
             model=model,
             config=self.config,
             registry=self.registry,
+            base_queryset=base_queryset,  # Pass the queryset here
             serializer_options=serializer_options or {},
             request=req,
         )

{statezero-0.1.0b4.dist-info → statezero-0.1.0b6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: statezero
-Version: 0.1.0b4
+Version: 0.1.0b6
 Summary: Connect your Python backend to a modern JavaScript SPA frontend with 90% less complexity.
 Author-email: Robert <robert.herring@statezero.dev>
 Project-URL: homepage, https://www.statezero.dev
@@ -222,7 +222,7 @@ npm i @statezero/core
 ### Generate TypeScript Models
 
 ```bash
-npx statezero sync-models
+npx statezero sync
 ```
 
 ## Why Choose StateZero Over...

{statezero-0.1.0b4.dist-info → statezero-0.1.0b6.dist-info}/RECORD

@@ -1,7 +1,8 @@
 statezero/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 statezero/adaptors/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 statezero/adaptors/django/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-statezero/adaptors/django/apps.py,sha256=UtL1XTZ70_9-q0ZEct0getDnaxJxnEjo_P9iEIqiYYE,4388
+statezero/adaptors/django/actions.py,sha256=Rm6riu-0zcaJKy65Eni2_GQ_NBg6-62sHit1WW4qFdo,7242
+statezero/adaptors/django/apps.py,sha256=51ZvUIDmHeAIazoG2qraUZuBGbONJJzLQ28ob_-smU8,6055
 statezero/adaptors/django/config.py,sha256=FVoKf-bYv0GAeAFjpQhfDnvn-L1c2noKXAg0B79egVo,3878
 statezero/adaptors/django/context_manager.py,sha256=Vrscb63wGJ2frXnOPPcJGULiyDkPnRO2SUhN-K-pJeI,379
 statezero/adaptors/django/event_emitters.py,sha256=Lb7NW7yFf_KxczVbj8g0vRcKZEny15t25m7PyIi2d3s,3057
@@ -9,13 +10,13 @@ statezero/adaptors/django/exception_handler.py,sha256=cQF1Fm5IjH91ydB54TK9sqXiAO
 statezero/adaptors/django/f_handler.py,sha256=yvITFj9UAnz8-r-aLEcWoz48tBhZ08-VMq9Fsm2uiN8,12305
 statezero/adaptors/django/helpers.py,sha256=0Dyq5vboDuTUaH-KpS3oVDjastA9yv6xI6XpBuvRM3I,5974
 statezero/adaptors/django/middleware.py,sha256=YVr8fkqCk51xJQM-ovtrUiB9Kt9H81cLd9xv4cM9YlM,410
-statezero/adaptors/django/orm.py,sha256=G_dhMzX5iaaTSxO4bxSZvxMiBw7mLMWY2GUD0mlkMNg,36304
+statezero/adaptors/django/orm.py,sha256=-9tWH9hW2Ta5AipXysoWy-em7R-ybHKmPLtBX89nYQc,37118
 statezero/adaptors/django/permissions.py,sha256=fU2c4bKK0zX2uuVB0UazZHTI-5OkiI5-BtPNcPEWmW0,9525
 statezero/adaptors/django/query_optimizer.py,sha256=-GNqL7Xn8WP8OsLEAAxXpIszSyEwm-l6WjgdkEFzxUM,38541
 statezero/adaptors/django/schemas.py,sha256=shq8ed9qHCnbCfYVsRxVE7V3R3GhGIKeRRj7dI3r1IU,12728
 statezero/adaptors/django/serializers.py,sha256=YFFDu6bzoWkSEOVH5Wmc4yJ8SaOkUA6HbXXYt6djlfc,23296
-statezero/adaptors/django/urls.py,sha256=G4LAUVG1WtPCyB_POQ3wa_VKqKCSI6p3fHZGy6GV99g,636
-statezero/adaptors/django/views.py,sha256=ZoTocBkqv8sdxaq5bMOZpsj1zko5FDcSYP1C9m8s9Hw,13723
+statezero/adaptors/django/urls.py,sha256=_Ylta5Bba0eI6pDvO7XddMt9ffEutx3JmZS2mSSi5DQ,828
+statezero/adaptors/django/views.py,sha256=_OTHkMyzEVaNFJeaK5lHv4mGDlJAoWEaqw7iCEjf4F8,17981
 statezero/adaptors/django/extensions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 statezero/adaptors/django/extensions/custom_field_serializers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 statezero/adaptors/django/extensions/custom_field_serializers/file_fields.py,sha256=BaOaJPmyzCp-YFwpsTOvGHjHpk6s8UJuZ5JsF-PEGV4,4518
@@ -27,7 +28,8 @@ statezero/adaptors/django/search_providers/__init__.py,sha256=47DEQpj8HBSa-_TImW
 statezero/adaptors/django/search_providers/basic_search.py,sha256=5_GJ1r_B6JdIYXL6yYEYn5mik88EolSH5aZvygc_UF0,977
 statezero/adaptors/django/search_providers/postgres_search.py,sha256=IMoHxzfi-Y3hAxPND4Xc6GatrPs1eXAqpmcfwt5Zr14,2459
 statezero/core/__init__.py,sha256=Z6RTutAAElLMEjBFphVVmpySPdJBA55j-Uo0BtR7c5E,1040
-statezero/core/ast_parser.py,sha256=epJ2pBpzRlKnrSgDMdVNOTRX6NX28khwkf_xOoPH_Uw,35561
+statezero/core/actions.py,sha256=uwN9O0NOcDhZtW3X3cq066_H9CyO-8WtjO38gyxxudo,2752
+statezero/core/ast_parser.py,sha256=ezEHqVB1Afqw_GSyUs4Dh0W94xFM4aaNEaxyYMk-rr4,38756
 statezero/core/ast_validator.py,sha256=YZAflPyba0kXWBNhd1Z_XeEk-_zUzM6MkY9zSlX1PMs,11582
 statezero/core/classes.py,sha256=-rJ8szqGGzsFxE3TvbtYHFHFP9Kg2WP24aYi74Io338,4923
 statezero/core/config.py,sha256=oOjcudQO0XgEZ60kwkzpcOoTi0QZARS8XWbp9gzgasg,11489
@@ -36,11 +38,11 @@ statezero/core/event_bus.py,sha256=2IFLBHSkLzpm1AX0MfSXSmF2X-lXK-gOoODZCtB2Jdw,6
 statezero/core/event_emitters.py,sha256=qjMbeUmdn4bG7WiVfqTmNdaflEea5amnTEpOn5X0J44,2046
 statezero/core/exceptions.py,sha256=_krMHWW9qBbMXvvqFdWf85a3Kayn7XbJczfC3x3gmBI,3330
 statezero/core/hook_checks.py,sha256=uqtvwRx1qGsF7Vc49elAWdOjMzhuv3RADKY1wiLvhK4,3425
-statezero/core/interfaces.py,sha256=HwcFXWJfIAxqYgWbGesn1Th9O8mvqH2r0XP2UyYifEw,15866
-statezero/core/process_request.py,sha256=NiG36XEjPMemJI03l5eTNaymyfUbwVgrx78chVcs4Nk,8047
+statezero/core/interfaces.py,sha256=uUWSq6k_hXqryhUILvBQP3L2bGMEpFKXglxIT-Tom7U,19818
+statezero/core/process_request.py,sha256=dwIeBEVOE8zA-oE1h65XNOGiVqFbbXA7SzTAguLNgZk,8060
 statezero/core/types.py,sha256=K9x9AU5J6yd2AWvqRz27CeAY6UYfuQoQ7xTEwTijrmM,1982
-statezero-0.1.0b4.dist-info/licenses/license.md,sha256=0uKjybTt9K_YbEmYgf25JN292qjjJ-BPofvIZ3wdtX4,7411
-statezero-0.1.0b4.dist-info/METADATA,sha256=dr2oqS3zZzB7K_CPWA3AGfi9svC-oCRqQAzBQUHWOx8,7152
-statezero-0.1.0b4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-statezero-0.1.0b4.dist-info/top_level.txt,sha256=UAuZYPKczradU1kcMQxsGjUzEW0qdgsqzhXyscrcLpw,10
-statezero-0.1.0b4.dist-info/RECORD,,
+statezero-0.1.0b6.dist-info/licenses/license.md,sha256=0uKjybTt9K_YbEmYgf25JN292qjjJ-BPofvIZ3wdtX4,7411
+statezero-0.1.0b6.dist-info/METADATA,sha256=JNWxgYNJ95vLpcRvz0HGz8B2McmKVBhFDsXYAJh8ysE,7145
+statezero-0.1.0b6.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+statezero-0.1.0b6.dist-info/top_level.txt,sha256=UAuZYPKczradU1kcMQxsGjUzEW0qdgsqzhXyscrcLpw,10
+statezero-0.1.0b6.dist-info/RECORD,,