makea-cli 0.2.9__tar.gz → 0.2.10__tar.gz

{makea_cli-0.2.9 → makea_cli-0.2.10}/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 0.2.10
+
+- PM reads for a brand (and Beeboo working for one):
+  - `designer get tna`: the Time & Action calendar, every pack's arrival with
+    how sure it is (done / confirmed / estimated) and its launch day.
+  - `designer list milestone --product <id>`: the bulk order's production
+    milestones, flattened (step, milestone, status, submitted/approved).
+  - `designer list note --product <id> --channel <key> [--since <date>]`: a
+    channel's messages without a search keyword, optionally only recent ones.
+  - `designer list fit-round --product <id>`: fit rounds and the corrections
+    carried into bulk.
+  - `designer get costing --style <id>`: one unit of each pack, factory price,
+    fees, the brand's freight/duty estimates, target, RRP, margin.
+
 ## 0.2.9
 
 - The analytics commands (`admin get analytics-query`, `active-users`,

{makea_cli-0.2.9 → makea_cli-0.2.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: makea-cli
-Version: 0.2.9
+Version: 0.2.10
 Summary: Makea admin CLI (browser login + Makea admin HTTP API)
 Requires-Python: >=3.10
 Requires-Dist: click<9,>=8.1

makea_cli-0.2.10/makea_cli/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.2.10"

{makea_cli-0.2.9 → makea_cli-0.2.10}/makea_cli/api_client.py

@@ -1359,6 +1359,99 @@ def supplier_list_quote_edit_requests(quote_request_id: str) -> Any:
     return get_json(f"/supplier/quote_requests/{quote_request_id}/quote_edit_requests")
 
 
+def designer_get_tna() -> Any:
+    """GET /designer/tna_calendar — every pack's five steps and arrival, with
+    the launch it is measured against when the arrival is confirmed."""
+    return get_json("/designer/tna_calendar")
+
+
+def designer_list_milestones(product_id: str) -> Any:
+    """Production milestones on a pack's bulk orders, compact: what is done,
+    submitted or waiting, never a lateness the factory did not commit to."""
+    raw = get_json(
+        f"/designer/products/{product_id}/production_order_details",
+        params={"type": "PRODUCTION"},
+    )
+    orders = (
+        raw.get("production_orders_details") or raw.get("orders")
+        if isinstance(raw, dict)
+        else raw
+    )
+    out = []
+    for order in orders or []:
+        if not isinstance(order, dict):
+            continue
+        for step in order.get("production_progress") or []:
+            meta = step.get("metadata") or {}
+            for m in meta.get("milestones") or []:
+                if not isinstance(m, dict):
+                    continue
+                out.append(
+                    {
+                        "order_id": order.get("production_order_id"),
+                        "step": step.get("progress_type"),
+                        "milestone": m.get("title"),
+                        "status": m.get("status"),
+                        "days_from_payment": m.get("time_window"),
+                        "submitted_at": m.get("submitted_at"),
+                        "approval_result": m.get("approval_result"),
+                        "completed_at": m.get("completed_at"),
+                    }
+                )
+    return {"product_id": product_id, "milestones": out}
+
+
+def designer_list_notes(
+    product_id: str, channel_key: str, *, since: str | None = None
+) -> Any:
+    """A channel's messages, oldest first, optionally only those after
+    ``since`` (ISO date or datetime): what the factory said this week."""
+    raw = get_json(f"/designer/products/{product_id}/channels/{channel_key}/notes")
+    notes = raw.get("notes") if isinstance(raw, dict) else raw
+    out = []
+    for n in notes or []:
+        if not isinstance(n, dict):
+            continue
+        if since and str(n.get("created_at") or "") < since:
+            continue
+        out.append(
+            {
+                "note_id": n.get("note_id"),
+                "at": n.get("created_at"),
+                "from": n.get("created_by_type"),
+                "supplier": n.get("supplier_name"),
+                "text": n.get("content"),
+                "replies": len(n.get("replies") or []),
+            }
+        )
+    return {"product_id": product_id, "channel": channel_key, "notes": out}
+
+
+def designer_list_fit_rounds(product_id: str) -> Any:
+    """GET /designer/products/{id}/fit_rounds — every fit round on the pack and
+    the corrections carried into bulk."""
+    return get_json(f"/designer/products/{product_id}/fit_rounds")
+
+
+def designer_get_costing(style_id: str) -> Any:
+    """One unit of each pack on a product card: factory price, fees, the
+    brand's freight and duty estimates, target, RRP, margin."""
+    raw = get_json(f"/designer/styles/{style_id}/overview")
+    packs = raw.get("packs") if isinstance(raw, dict) else []
+    return {
+        "style_id": style_id,
+        "packs": [
+            {
+                "product_id": p.get("product_id"),
+                "pack": p.get("pack_label"),
+                "costing": p.get("costing"),
+            }
+            for p in packs or []
+            if isinstance(p, dict)
+        ],
+    }
+
+
 def designer_list_actions(*, product_id: str | None = None) -> Any:
     """GET /designer/actions — the brand's pending actions, optionally for one product."""
     params = {"product_id": product_id} if product_id else None

{makea_cli-0.2.9 → makea_cli-0.2.10}/makea_cli/commands/brand/cmd.py

@@ -212,6 +212,95 @@ def register(app: typer.Typer) -> None:
         """List a product's channels."""
         print_json_or_exit(console, lambda: api_client.designer_list_channels(product))
 
+    @command(
+        app,
+        "designer",
+        "get",
+        "tna",
+        api="GET /designer/tna_calendar",
+        help=(
+            "GET /designer/tna_calendar — when each pack arrives and how sure that is "
+            "(done / confirmed / estimated), with its launch day."
+        ),
+    )
+    def get_tna() -> None:
+        """The Time & Action calendar."""
+        print_json_or_exit(console, lambda: api_client.designer_get_tna())
+
+    @command(
+        app,
+        "designer",
+        "list",
+        "milestone",
+        api="GET /designer/products/{product_id}/production_order_details",
+        help=(
+            "GET /designer/products/{id}/production_order_details — the bulk order's "
+            "production milestones: done, submitted, waiting."
+        ),
+    )
+    def list_milestones(
+        product: str = typer.Option(..., "--product", "-p", help="Product id."),
+    ) -> None:
+        """List a pack's production milestones."""
+        print_json_or_exit(console, lambda: api_client.designer_list_milestones(product))
+
+    @command(
+        app,
+        "designer",
+        "list",
+        "note",
+        api="GET /designer/products/{product_id}/channels/{channel_key}/notes",
+        help=(
+            "GET /designer/products/{id}/channels/{key}/notes — a channel's messages, "
+            "oldest first; --since keeps the recent ones (no keyword needed)."
+        ),
+    )
+    def list_notes(
+        product: str = typer.Option(..., "--product", "-p", help="Product id."),
+        channel: str = typer.Option(..., "--channel", "-c", help="Channel key."),
+        since: str | None = typer.Option(
+            None, "--since", help="ISO date or datetime, e.g. 2026-10-01."
+        ),
+    ) -> None:
+        """List a channel's messages."""
+        print_json_or_exit(
+            console, lambda: api_client.designer_list_notes(product, channel, since=since)
+        )
+
+    @command(
+        app,
+        "designer",
+        "list",
+        "fit-round",
+        api="GET /designer/products/{product_id}/fit_rounds",
+        help=(
+            "GET /designer/products/{id}/fit_rounds — the pack's fit rounds and the "
+            "corrections carried into bulk."
+        ),
+    )
+    def list_fit_rounds(
+        product: str = typer.Option(..., "--product", "-p", help="Product id."),
+    ) -> None:
+        """List a pack's fit rounds."""
+        print_json_or_exit(console, lambda: api_client.designer_list_fit_rounds(product))
+
+    @command(
+        app,
+        "designer",
+        "get",
+        "costing",
+        api="GET /designer/styles/{style_id}/overview",
+        help=(
+            "GET /designer/styles/{id}/overview — what one unit of each pack costs and "
+            "the margin at RRP (freight and duty are the brand's estimates)."
+        ),
+    )
+    def get_costing(
+        style: str = typer.Option(..., "--style", "-s", help="Product card (style) id."),
+    ) -> None:
+        """A product card's unit cost and margin."""
+        print_json_or_exit(console, lambda: api_client.designer_get_costing(style))
+
     @command(
         app,
         "designer",

{makea_cli-0.2.9 → makea_cli-0.2.10}/pyproject.toml

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

{makea_cli-0.2.9 → makea_cli-0.2.10}/tests/golden_manifest.json

@@ -5257,6 +5257,38 @@
         }
       ]
     },
+    {
+      "name": "designer get costing",
+      "persona": "designer",
+      "verb": "get",
+      "noun": "costing",
+      "access": "read",
+      "api": "GET /designer/styles/{style_id}/overview",
+      "external": null,
+      "side_effects": [],
+      "approval": "auto",
+      "reversible": null,
+      "idempotent": null,
+      "limit": null,
+      "legacy": [],
+      "help": "GET /designer/styles/{id}/overview — what one unit of each pack costs and the margin at RRP (freight and duty are the brand's estimates).",
+      "function": "makea_cli.commands.brand.cmd.register.<locals>.get_costing",
+      "flags": [
+        {
+          "name": "style",
+          "kind": "option",
+          "opts": [
+            "--style",
+            "-s"
+          ],
+          "type": "text",
+          "required": true,
+          "multiple": false,
+          "default": null,
+          "help": "Product card (style) id."
+        }
+      ]
+    },
     {
       "name": "designer get lifecycle",
       "persona": "designer",
@@ -5468,6 +5500,24 @@
         }
       ]
     },
+    {
+      "name": "designer get tna",
+      "persona": "designer",
+      "verb": "get",
+      "noun": "tna",
+      "access": "read",
+      "api": "GET /designer/tna_calendar",
+      "external": null,
+      "side_effects": [],
+      "approval": "auto",
+      "reversible": null,
+      "idempotent": null,
+      "limit": null,
+      "legacy": [],
+      "help": "GET /designer/tna_calendar — when each pack arrives and how sure that is (done / confirmed / estimated), with its launch day.",
+      "function": "makea_cli.commands.brand.cmd.register.<locals>.get_tna",
+      "flags": []
+    },
     {
       "name": "designer list action",
       "persona": "designer",
@@ -5550,6 +5600,38 @@
       "function": "makea_cli.commands.brand.cmd.register.<locals>.list_collections",
       "flags": []
     },
+    {
+      "name": "designer list fit-round",
+      "persona": "designer",
+      "verb": "list",
+      "noun": "fit-round",
+      "access": "read",
+      "api": "GET /designer/products/{product_id}/fit_rounds",
+      "external": null,
+      "side_effects": [],
+      "approval": "auto",
+      "reversible": null,
+      "idempotent": null,
+      "limit": "client",
+      "legacy": [],
+      "help": "GET /designer/products/{id}/fit_rounds — the pack's fit rounds and the corrections carried into bulk.",
+      "function": "makea_cli.commands.brand.cmd.register.<locals>.list_fit_rounds",
+      "flags": [
+        {
+          "name": "product",
+          "kind": "option",
+          "opts": [
+            "--product",
+            "-p"
+          ],
+          "type": "text",
+          "required": true,
+          "multiple": false,
+          "default": null,
+          "help": "Product id."
+        }
+      ]
+    },
     {
       "name": "designer list library-element",
       "persona": "designer",
@@ -5593,6 +5675,95 @@
         }
       ]
     },
+    {
+      "name": "designer list milestone",
+      "persona": "designer",
+      "verb": "list",
+      "noun": "milestone",
+      "access": "read",
+      "api": "GET /designer/products/{product_id}/production_order_details",
+      "external": null,
+      "side_effects": [],
+      "approval": "auto",
+      "reversible": null,
+      "idempotent": null,
+      "limit": "client",
+      "legacy": [],
+      "help": "GET /designer/products/{id}/production_order_details — the bulk order's production milestones: done, submitted, waiting.",
+      "function": "makea_cli.commands.brand.cmd.register.<locals>.list_milestones",
+      "flags": [
+        {
+          "name": "product",
+          "kind": "option",
+          "opts": [
+            "--product",
+            "-p"
+          ],
+          "type": "text",
+          "required": true,
+          "multiple": false,
+          "default": null,
+          "help": "Product id."
+        }
+      ]
+    },
+    {
+      "name": "designer list note",
+      "persona": "designer",
+      "verb": "list",
+      "noun": "note",
+      "access": "read",
+      "api": "GET /designer/products/{product_id}/channels/{channel_key}/notes",
+      "external": null,
+      "side_effects": [],
+      "approval": "auto",
+      "reversible": null,
+      "idempotent": null,
+      "limit": "client",
+      "legacy": [],
+      "help": "GET /designer/products/{id}/channels/{key}/notes — a channel's messages, oldest first; --since keeps the recent ones (no keyword needed).",
+      "function": "makea_cli.commands.brand.cmd.register.<locals>.list_notes",
+      "flags": [
+        {
+          "name": "product",
+          "kind": "option",
+          "opts": [
+            "--product",
+            "-p"
+          ],
+          "type": "text",
+          "required": true,
+          "multiple": false,
+          "default": null,
+          "help": "Product id."
+        },
+        {
+          "name": "channel",
+          "kind": "option",
+          "opts": [
+            "--channel",
+            "-c"
+          ],
+          "type": "text",
+          "required": true,
+          "multiple": false,
+          "default": null,
+          "help": "Channel key."
+        },
+        {
+          "name": "since",
+          "kind": "option",
+          "opts": [
+            "--since"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "ISO date or datetime, e.g. 2026-10-01."
+        }
+      ]
+    },
     {
       "name": "designer list payment",
       "persona": "designer",

makea_cli-0.2.10/tests/test_pm_reads.py

@@ -0,0 +1,69 @@
+"""The PM reads Beeboo uses: milestones, recent notes, costing — trimmed to
+what answers "will it be on time", "what did the factory say this week",
+"what does it cost".
+
+Run with ``.venv/bin/python -m unittest tests.test_pm_reads``.
+"""
+
+import unittest
+from unittest import mock
+
+from makea_cli import api_client
+
+
+class PmReadsTest(unittest.TestCase):
+    def test_milestones_are_flattened(self):
+        raw = {
+            "production_orders_details": [
+                {
+                    "production_order_id": "po1",
+                    "production_progress": [
+                        {
+                            "progress_type": "During Production",
+                            "metadata": {
+                                "milestones": [
+                                    {"title": "Cutting", "status": "completed", "time_window": ["3", "5"]},
+                                ]
+                            },
+                        }
+                    ],
+                }
+            ]
+        }
+        with mock.patch.object(api_client, "get_json", return_value=raw):
+            out = api_client.designer_list_milestones("p1")
+        self.assertEqual(
+            out["milestones"][0],
+            {
+                "order_id": "po1",
+                "step": "During Production",
+                "milestone": "Cutting",
+                "status": "completed",
+                "days_from_payment": ["3", "5"],
+                "submitted_at": None,
+                "approval_result": None,
+                "completed_at": None,
+            },
+        )
+
+    def test_notes_since_keep_the_recent_ones(self):
+        raw = {
+            "notes": [
+                {"note_id": "a", "created_at": "2026-09-30T10:00:00", "content": "old"},
+                {"note_id": "b", "created_at": "2026-10-05T10:00:00", "content": "new", "replies": [{}]},
+            ]
+        }
+        with mock.patch.object(api_client, "get_json", return_value=raw):
+            out = api_client.designer_list_notes("p1", "supplier:s", since="2026-10-01")
+        self.assertEqual([n["note_id"] for n in out["notes"]], ["b"])
+        self.assertEqual(out["notes"][0]["replies"], 1)
+
+    def test_costing_is_per_pack(self):
+        raw = {"packs": [{"product_id": "p1", "pack_label": "v1", "costing": {"make": 50}}]}
+        with mock.patch.object(api_client, "get_json", return_value=raw):
+            out = api_client.designer_get_costing("st1")
+        self.assertEqual(out["packs"], [{"product_id": "p1", "pack": "v1", "costing": {"make": 50}}])
+
+
+if __name__ == "__main__":
+    unittest.main()

makea_cli-0.2.9/makea_cli/__init__.py

@@ -1 +0,0 @@
-__version__ = "0.2.9"