unitysvc-core 0.2.23__tar.gz → 0.2.24__tar.gz

{unitysvc_core-0.2.23/src/unitysvc_core.egg-info → unitysvc_core-0.2.24}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: unitysvc-core
-Version: 0.2.23
+Version: 0.2.24
 Summary: Shared data models and validation helpers for UnitySVC packages
 Author-email: Bo Peng <bo.peng@unitysvc.com>
 Maintainer-email: Bo Peng <bo.peng@unitysvc.com>

{unitysvc_core-0.2.23 → unitysvc_core-0.2.24}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "unitysvc-core"
-version = "0.2.23"
+version = "0.2.24"
 description = "Shared data models and validation helpers for UnitySVC packages"
 readme = "README.md"
 authors = [{ name = "Bo Peng", email = "bo.peng@unitysvc.com" }]

{unitysvc_core-0.2.23 → unitysvc_core-0.2.24}/src/unitysvc_core/models/__init__.py

@@ -1,4 +1,5 @@
 from .base import (
+    ROUTABLE_GROUP_TYPES,
     AccessMethodEnum,
     AuthMethodEnum,
     ContentFilterEnum,
@@ -131,6 +132,7 @@ __all__ = [
     "QuotaResetCycleEnum",
     "RateLimitUnitEnum",
     "RequestTransformEnum",
+    "ROUTABLE_GROUP_TYPES",
     "SellerTypeEnum",
     "ServiceGroupStatusEnum",
     "ServiceTypeEnum",

{unitysvc_core-0.2.23 → unitysvc_core-0.2.24}/src/unitysvc_core/models/base.py

@@ -136,16 +136,21 @@ class GroupOwnerTypeEnum(StrEnum):
 
 
 class GroupTypeEnum(StrEnum):
-    """Type of service group.
+    """Type of service group. Derived from members, not authored.
 
-    - ``regular``: Enrollable, services-bearing group (the common case).
-    - ``category``: Non-enrollable parent that organizes child groups.
-    - ``misc``: System-generated catch-all for uncategorized services.
+    - ``category``: Parent group for browsing/organization only.
+    - ``collection``: Services-bearing group that is not routable.
+    - ``open``: Routable group where keyless requests can fan safely.
+    - ``keyed``: Routable group where callers must provide a routing key.
     """
 
-    regular = "regular"
     category = "category"
-    misc = "misc"
+    collection = "collection"
+    open = "open"
+    keyed = "keyed"
+
+
+ROUTABLE_GROUP_TYPES = frozenset({GroupTypeEnum.open, GroupTypeEnum.keyed})
 
 
 class SellerTypeEnum(StrEnum):

{unitysvc_core-0.2.23 → unitysvc_core-0.2.24}/src/unitysvc_core/models/service_group_data.py

@@ -84,10 +84,11 @@ class ServiceGroupData(BaseModel):
     )
 
     group_type: GroupTypeEnum = Field(
-        default=GroupTypeEnum.regular,
+        default=GroupTypeEnum.category,
         description=(
-            "Type of group: regular (enrollable), category (non-enrollable "
-            "parent), or misc (system-generated catch-all)."
+            "Backend-derived group type: category (browse-only parent), "
+            "collection (not routable), open (routable keyless fanout), "
+            "or keyed (routable by key)."
         ),
     )
 

{unitysvc_core-0.2.23 → unitysvc_core-0.2.24}/src/unitysvc_core/schema/service_group_v1.json

@@ -11,11 +11,12 @@
       "type": "string"
     },
     "GroupTypeEnum": {
-      "description": "Type of service group.\n\n- ``regular``: Enrollable, services-bearing group (the common case).\n- ``category``: Non-enrollable parent that organizes child groups.\n- ``misc``: System-generated catch-all for uncategorized services.",
+      "description": "Type of service group. Derived from members, not authored.\n\n- ``category``: Parent group for browsing/organization only.\n- ``collection``: Services-bearing group that is not routable.\n- ``open``: Routable group where keyless requests can fan safely.\n- ``keyed``: Routable group where callers must provide a routing key.",
       "enum": [
-        "regular",
         "category",
-        "misc"
+        "collection",
+        "open",
+        "keyed"
       ],
       "title": "GroupTypeEnum",
       "type": "string"
@@ -69,8 +70,8 @@
     },
     "group_type": {
       "$ref": "#/$defs/GroupTypeEnum",
-      "default": "regular",
-      "description": "Type of group: regular (enrollable), category (non-enrollable parent), or misc (system-generated catch-all)."
+      "default": "category",
+      "description": "Backend-derived group type: category (browse-only parent), collection (not routable), open (routable keyless fanout), or keyed (routable by key)."
     },
     "membership_rules": {
       "anyOf": [

{unitysvc_core-0.2.23 → unitysvc_core-0.2.24/src/unitysvc_core.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: unitysvc-core
-Version: 0.2.23
+Version: 0.2.24
 Summary: Shared data models and validation helpers for UnitySVC packages
 Author-email: Bo Peng <bo.peng@unitysvc.com>
 Maintainer-email: Bo Peng <bo.peng@unitysvc.com>

{unitysvc_core-0.2.23 → unitysvc_core-0.2.24}/tests/test_service_group.py

@@ -46,22 +46,44 @@ class TestServiceGroupDataAdminFields:
         g = ServiceGroupData(name="ok", display_name="X")
         assert g.owner_type is GroupOwnerTypeEnum.platform
         assert g.owner_id is None
-        assert g.group_type is GroupTypeEnum.regular
+        assert g.group_type is GroupTypeEnum.category
         assert g.access_interface_data_template is None
 
+    @pytest.mark.parametrize(
+        "group_type",
+        [
+            GroupTypeEnum.category,
+            GroupTypeEnum.collection,
+            GroupTypeEnum.open,
+            GroupTypeEnum.keyed,
+        ],
+    )
+    def test_backend_group_types_set(self, group_type: GroupTypeEnum):
+        g = ServiceGroupData(
+            name="ok",
+            display_name="X",
+            group_type=group_type,
+        )
+        assert g.group_type is group_type
+
     def test_admin_fields_set(self):
         g = ServiceGroupData(
             name="ok",
             display_name="X",
             owner_type=GroupOwnerTypeEnum.seller,
             owner_id="00000000-0000-0000-0000-000000000001",
-            group_type=GroupTypeEnum.category,
+            group_type=GroupTypeEnum.open,
             access_interface_data_template='{"base_url": "https://x"}',
         )
         assert g.owner_type is GroupOwnerTypeEnum.seller
-        assert g.group_type is GroupTypeEnum.category
+        assert g.group_type is GroupTypeEnum.open
         assert g.access_interface_data_template == '{"base_url": "https://x"}'
 
+    @pytest.mark.parametrize("legacy_type", ["regular", "misc"])
+    def test_legacy_group_types_rejected(self, legacy_type: str):
+        with pytest.raises(ValidationError):
+            ServiceGroupData(name="ok", display_name="X", group_type=legacy_type)
+
 
 class TestServiceGroupV1FileModel:
     """``extra='forbid'`` keeps file-level validation strict."""
@@ -78,10 +100,11 @@ class TestServiceGroupV1FileModel:
             name="my-group",
             display_name="X",
             owner_type="platform",
-            group_type="regular",
+            group_type="keyed",
             status="active",
         )
         assert g.status is ServiceGroupStatusEnum.active
+        assert g.group_type is GroupTypeEnum.keyed
 
 
 class TestValidateServiceGroupDict: