makea-cli 0.1.12__tar.gz → 0.1.14__tar.gz

{makea_cli-0.1.12 → makea_cli-0.1.14}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: makea-cli
-Version: 0.1.12
+Version: 0.1.14
 Summary: Makea admin CLI (browser login + Makea admin HTTP API)
 Requires-Python: >=3.10
 Requires-Dist: httpx>=0.27

{makea_cli-0.1.12 → makea_cli-0.1.14}/makea_cli/api_client.py

@@ -198,6 +198,11 @@ def add_supplier(body: dict[str, Any]) -> Any:
     return post_json("/admin/supplier/add_supplier", body)
 
 
+def update_supplier(body: dict[str, Any]) -> Any:
+    """PUT /admin/supplier/update_supplier — body must carry supplier_id and {\"supplier\": {...}}."""
+    return put_json("/admin/supplier/update_supplier", body)
+
+
 def backfill_supplier_id_with_quote_requests(
     *,
     user_id: str,

{makea_cli-0.1.12 → makea_cli-0.1.14}/makea_cli/commands/supplier/cmd.py

@@ -59,7 +59,12 @@ def register(app: typer.Typer) -> None:
 
     @app.command(
         "add-supplier",
-        help="POST /admin/supplier/add_supplier — create supplier from JSON file (admin).",
+        help=(
+            "POST /admin/supplier/add_supplier — create supplier from JSON file (admin). "
+            "Run `makea-cli get-supplier-profile-schema` FIRST to get the field taxonomy "
+            "(sections, exact field keys, allowed options, required rules) and build the "
+            "JSON against it."
+        ),
     )
     def add_supplier(
         file: Path = typer.Option(
@@ -75,6 +80,13 @@ def register(app: typer.Typer) -> None:
         """
         Create a supplier (admin).
 
+        Before building the JSON, run ``makea-cli get-supplier-profile-schema`` to fetch
+        the v2 field taxonomy (sections, exact field keys, allowed options and required
+        rules), then construct the supplier object against it. Required core fields:
+        name, legal_entity_name, type (one of supplier_type_options), country_region,
+        city, contact_name, contact_email — plus the type-specific required fields the
+        schema marks with required_when for the chosen ``type``.
+
         HTTP: POST /admin/supplier/add_supplier with JSON body {\"supplier\": <object>}.
 
         Input file
@@ -126,6 +138,86 @@ def register(app: typer.Typer) -> None:
         body = _normalize_add_supplier_body(raw)
         print_json_or_exit(console, lambda: api_client.add_supplier(body))
 
+    @app.command(
+        "update-supplier",
+        help=(
+            "PUT /admin/supplier/update_supplier — update an existing supplier from a "
+            "JSON file (admin). Run `makea-cli get-supplier-profile-schema` FIRST to get "
+            "the field taxonomy (sections, exact field keys, allowed options, required "
+            "rules) and build the JSON against it."
+        ),
+    )
+    def update_supplier(
+        file: Path = typer.Option(
+            ...,
+            "--file",
+            "-f",
+            exists=True,
+            dir_okay=False,
+            readable=True,
+            help='Path to UTF-8 JSON: either the supplier object alone or {"supplier": {...}}.',
+        ),
+        supplier_id: str | None = typer.Option(
+            None,
+            "--supplier-id",
+            "-s",
+            help=(
+                "supplier_id of the record to update. Overrides any supplier_id in the "
+                "file. Required if the file does not contain one."
+            ),
+        ),
+    ) -> None:
+        """
+        Update an existing supplier (admin).
+
+        Before building the JSON, run ``makea-cli get-supplier-profile-schema`` to fetch
+        the v2 field taxonomy (sections, exact field keys, allowed options and required
+        rules), then construct the supplier object against it.
+
+        HTTP: PUT /admin/supplier/update_supplier with JSON body
+        {\"supplier_id\": <id>, \"supplier\": <object>}.
+
+        Input file
+        - Root may be the supplier fields object only (recommended), or the full envelope
+          {\"supplier\": {...}}. May also carry a top-level \"supplier_id\".
+        - The target supplier_id is taken from --supplier-id first, then a top-level
+          \"supplier_id\", then \"supplier_id\" inside the object. supplier_id itself is
+          never modified.
+        - Fields present in the file overwrite the stored values (including empty string
+          and empty list, which CLEAR a field); fields you omit are left unchanged.
+
+        IMPORTANT — full vs partial update:
+        - The server runs v2 schema validation whenever the payload contains ANY core
+          field (name, type, country_region, city, contact_name, contact_email) or a
+          \"supplier_master\". In that case the payload must be a COMPLETE, valid profile
+          (all required + type-specific required fields), not just the field you changed —
+          otherwise it fails with required_missing. Fetch the current record (list-suppliers),
+          merge your change in, and send the whole object.
+        - To touch only non-core fields (e.g. internal_notes, contact_phone, website),
+          you may send just those plus the supplier_id; no v2 validation is triggered.
+
+        Output: JSON {success, result} with HTTP 200 on success; result is the updated
+        supplier as a flat dict (dataclass asdict).
+        """
+        try:
+            raw = json.loads(file.read_text(encoding="utf-8"))
+        except (OSError, json.JSONDecodeError) as e:
+            console.print(f"[red]Invalid JSON file: {e}[/red]")
+            raise typer.Exit(1) from e
+        if not isinstance(raw, dict):
+            console.print("[red]JSON root must be an object.[/red]")
+            raise typer.Exit(1)
+        body = _normalize_add_supplier_body(raw)
+        resolved_id = supplier_id or raw.get("supplier_id") or body["supplier"].get("supplier_id")
+        if not resolved_id:
+            console.print(
+                "[red]supplier_id is required: pass --supplier-id or include it in the "
+                "JSON.[/red]"
+            )
+            raise typer.Exit(1)
+        body["supplier_id"] = resolved_id
+        print_json_or_exit(console, lambda: api_client.update_supplier(body))
+
     @app.command(
         "create-quote-request",
         help=(

{makea_cli-0.1.12 → makea_cli-0.1.14}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "makea-cli"
-version = "0.1.12"
+version = "0.1.14"
 description = "Makea admin CLI (browser login + Makea admin HTTP API)"
 readme = "README.md"
 requires-python = ">=3.10"