datex-studio-cli 0.4.7__tar.gz → 0.4.8__tar.gz

{datex_studio_cli-0.4.7 → datex_studio_cli-0.4.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: datex-studio-cli
-Version: 0.4.7
+Version: 0.4.8
 Summary: CLI for Datex Studio low-code platform, designed for LLM-based AI agents
 Project-URL: Homepage, https://github.com/datex/datex-studio-cli
 Project-URL: Documentation, https://github.com/datex/datex-studio-cli

{datex_studio_cli-0.4.7 → datex_studio_cli-0.4.8}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "datex-studio-cli"
-version = "0.4.7"
+version = "0.4.8"
 description = "CLI for Datex Studio low-code platform, designed for LLM-based AI agents"
 readme = "README.md"
 license = "MIT"

{datex_studio_cli-0.4.7 → datex_studio_cli-0.4.8}/src/dxs/__init__.py

@@ -1,4 +1,4 @@
 """Datex Studio CLI - Command-line interface for Datex Studio platform."""
 
-__version__ = "0.4.7"
+__version__ = "0.4.8"
 __app_name__ = "dxs"

{datex_studio_cli-0.4.7 → datex_studio_cli-0.4.8}/src/dxs/commands/configuration.py

@@ -397,8 +397,7 @@ def configuration_validate(
         )
     else:
         formatted = [
-            {"message": e.get("message", str(e)) if isinstance(e, dict) else str(e)}
-            for e in errors
+            {"message": e.get("message", str(e)) if isinstance(e, dict) else str(e)} for e in errors
         ]
         ctx.output(list_response(items=formatted, semantic_key="validation_errors"))
 
@@ -443,6 +442,72 @@ def configuration_contexts(
     ctx.output(single(item=response or {}, semantic_key="configuration_contexts"))
 
 
+@configuration.command("nomenclature")
+@click.option("--branch", "-b", type=int, default=None, help="Branch ID (falls back to global -b)")
+@click.option(
+    "--package",
+    "-p",
+    "package",
+    default=None,
+    help="Filter to one package (matches the <Package> segment of the type key).",
+)
+@click.option(
+    "--kind",
+    type=click.Choice(["all", "enum", "interface"]),
+    default="all",
+    show_default=True,
+    help="Filter by kind: enums (have members) or interfaces (no members).",
+)
+@click.option(
+    "--search",
+    "search",
+    default=None,
+    help="Case-insensitive substring match on the fully-qualified type key.",
+)
+@pass_context
+@require_auth
+def configuration_nomenclature(
+    ctx: DxsContext,
+    branch: int | None,
+    package: str | None,
+    kind: str,
+    search: str | None,
+) -> None:
+    """List custom types (interfaces/enums) and enum members on a branch.
+
+    Returns the platform's nomenclature registry: a flat catalog of every
+    `<Package>.<Type>` custom type, with each enum's members in
+    `constantValues` (empty for interfaces). Use it to confirm a type or enum
+    member exists before referencing `$types.<Package>.<Type>` in flow /
+    expression code — lighter than fetching full bodies (`get customtype`) or
+    the designer contexts (`contexts`).
+
+    \b
+    Examples:
+        dxs configuration nomenclature -b 64
+        dxs configuration nomenclature -b 64 --package Cartonization --kind enum
+        dxs configuration nomenclature -b 64 --search e_stage
+    """
+    branch_id = resolve_branch(ctx, branch, "DXS-CFG-010")
+
+    api_client = ApiClient()
+    path = ConfigurationEndpoints.custom_type_nomenclature(branch_id)
+    items: list[Any] = api_client.get(path) or []
+
+    if package:
+        prefix = f"{package.lower()}."
+        items = [i for i in items if str(i.get("key", "")).lower().startswith(prefix)]
+    if kind == "enum":
+        items = [i for i in items if i.get("constantValues")]
+    elif kind == "interface":
+        items = [i for i in items if not i.get("constantValues")]
+    if search:
+        needle = search.lower()
+        items = [i for i in items if needle in str(i.get("key", "")).lower()]
+
+    ctx.output(list_response(items=items, semantic_key="custom_types", branch_id=branch_id))
+
+
 @configuration.command("list")
 @click.argument("config_type")
 @click.option("--branch", "-b", type=int, default=None, help="Branch ID (falls back to global -b)")

{datex_studio_cli-0.4.7 → datex_studio_cli-0.4.8}/src/dxs/core/api/endpoints.py

@@ -454,6 +454,17 @@ class ConfigurationEndpoints:
         config_type = ConfigurationEndpoints.normalize_type(config_type)
         return f"/applications/{branch_id}/{config_type}configurations/validate"
 
+    @staticmethod
+    def custom_type_nomenclature(branch_id: int) -> str:
+        """Get the custom-type nomenclature registry for a branch.
+
+        Returns a flat catalog of every custom type as ``<Package>.<Type>``,
+        with each enum's members listed in ``constantValues`` (empty for
+        interfaces). This is a customtype-specific route, distinct from the
+        ``{type}configurations`` CRUD surface and the ``/contexts`` route.
+        """
+        return f"/applications/{branch_id}/customtypeconfigurations/nomenclature"
+
     # Singular-to-plural mapping for the configId endpoint.
     # The configId endpoint uses the plural enum name (e.g., "endpoints"),
     # NOT the "{type}configurations" pattern used by CRUD endpoints.