makea-cli 0.2.8__py3-none-any.whl → 0.2.10__py3-none-any.whl

makea_cli/__init__.py

@@ -1 +1 @@
-__version__ = "0.2.8"
+__version__ = "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/commands/analytics/cmd.py

@@ -4,7 +4,8 @@ Behavioural metrics (feature usage, clicks, page/feature time, active users)
 backed by PostHog HogQL. Distinct from the `metrics` group, which reads the
 Makea backend for financial figures.
 
-Requires env: POSTHOG_API_KEY, POSTHOG_PROJECT_ID (see config.py).
+Goes through the Makea backend by default (admin login is enough); a local
+POSTHOG_API_KEY + POSTHOG_PROJECT_ID switches to querying PostHog directly.
 """
 
 from __future__ import annotations
@@ -32,8 +33,7 @@ def register(app: typer.Typer) -> None:
         "get",
         "feature-usage",
         legacy="analytics-feature-usage",
-        api="POSTHOG hogql",
-        external="posthog",
+        api="POST /admin/analytics/query",
         help=(
             "How many distinct users used a feature recently, plus event volume. "
             "Matches $pageview path and feature_time_spent events. "
@@ -82,8 +82,7 @@ def register(app: typer.Typer) -> None:
         "get",
         "top-features",
         legacy="analytics-top-features",
-        api="POSTHOG hogql",
-        external="posthog",
+        api="POST /admin/analytics/query",
         help=(
             "Rank pageview paths by distinct users over the last N days — a quick "
             "map of which features get used most."
@@ -118,8 +117,7 @@ def register(app: typer.Typer) -> None:
         "get",
         "top-clicks",
         legacy="analytics-top-clicks",
-        api="POSTHOG hogql",
-        external="posthog",
+        api="POST /admin/analytics/query",
         help=(
             "Rank autocaptured click targets by count over the last N days — "
             "which buttons/elements get clicked most."
@@ -156,8 +154,7 @@ def register(app: typer.Typer) -> None:
         "get",
         "active-users",
         legacy="analytics-active-users",
-        api="POSTHOG hogql",
-        external="posthog",
+        api="POST /admin/analytics/query",
         help="Distinct active users per day over the last N days (DAU series).",
     )
     def active_users(
@@ -184,8 +181,7 @@ def register(app: typer.Typer) -> None:
         "get",
         "analytics-query",
         legacy="analytics-query",
-        api="POSTHOG hogql",
-        external="posthog",
+        api="POST /admin/analytics/query",
         help=(
             "Run an arbitrary HogQL query (escape hatch). "
             'Example: analytics-query "SELECT count() FROM events"'

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/config.py

@@ -48,8 +48,9 @@ def redirect_uri() -> str:
 
 # PostHog product-analytics (behavioural metrics: clicks, page/feature time,
 # funnels, retention). Distinct from the financial `metrics` command group,
-# which reads the Makea backend. Configured purely via environment so no key is
-# ever committed:
+# which reads the Makea backend. Optional: without these the analytics commands
+# go through the backend's /admin/analytics/query, which holds the key. Set them
+# only to query PostHog directly:
 #   POSTHOG_API_KEY     personal API key (phx_...), read-only is enough
 #   POSTHOG_PROJECT_ID  numeric project id
 #   POSTHOG_HOST        defaults to the EU cloud query host

makea_cli/posthog_client.py

@@ -1,10 +1,11 @@
 """Minimal PostHog query client (HogQL over the Query API).
 
-This talks to PostHog's cloud directly, not the Makea backend, so it has its
-own auth (a personal API key from env) rather than the Cognito token used by
-api_client.
+Two routes to the same query:
 
-Docs: POST {host}/api/projects/{project_id}/query/ with a HogQLQuery body.
+- By default it goes through the Makea backend (POST /admin/analytics/query),
+  which holds the PostHog key. An admin's `makea-cli login` is all it takes.
+- If POSTHOG_API_KEY and POSTHOG_PROJECT_ID are set locally, it talks to
+  PostHog directly instead (POST {host}/api/projects/{project_id}/query/).
 """
 
 from __future__ import annotations
@@ -14,33 +15,21 @@ from typing import Any
 
 import httpx
 
+from makea_cli import api_client
 from makea_cli.config import posthog_api_key, posthog_host, posthog_project_id
 
 
-class PostHogNotConfigured(RuntimeError):
-    """Raised when the required PostHog env vars are missing."""
-
-
-def _require_config() -> tuple[str, str, str]:
-    key = posthog_api_key()
-    project = posthog_project_id()
-    if not key or not project:
-        raise PostHogNotConfigured(
-            "PostHog is not configured. Set POSTHOG_API_KEY (personal API key, "
-            "phx_...) and POSTHOG_PROJECT_ID, optionally POSTHOG_HOST "
-            "(default https://eu.posthog.com)."
-        )
-    return posthog_host(), project, key
-
-
-def run_hogql(query: str, *, timeout: float = 60.0) -> dict[str, Any]:
+def run_hogql(query: str, *, timeout: float = 90.0) -> dict[str, Any]:
     """Run a HogQL query and return the raw result.
 
     The result has ``columns`` (list of names) and ``results`` (list of rows);
     callers usually want to zip them into dicts for display.
     """
-    host, project, key = _require_config()
-    url = f"{host}/api/projects/{project}/query/"
+    key = posthog_api_key()
+    project = posthog_project_id()
+    if not key or not project:
+        return api_client.post_json("/admin/analytics/query", {"query": query}, timeout=timeout)
+    url = f"{posthog_host()}/api/projects/{project}/query/"
     headers = {
         "Authorization": f"Bearer {key}",
         "Content-Type": "application/json",

{makea_cli-0.2.8.dist-info → makea_cli-0.2.10.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: makea-cli
-Version: 0.2.8
+Version: 0.2.10
 Summary: Makea admin CLI (browser login + Makea admin HTTP API)
 Requires-Python: >=3.10
 Requires-Dist: click<9,>=8.1
@@ -98,18 +98,18 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin download document` | read | `GET /admin/document/download` | save a document file (document id + designer user_id). | `download-document` |
 | `makea-cli admin download product-document` | read | `GET /admin/document/download` | Resolve product via admin list product-order payload, then GET /admin/document/download. | `download-product-document` |
 | `makea-cli admin generate pricing-groups` | write（ask） | `POST /admin/production_orders/{id}/details/update` | Lay a production order's variants into pricing groups along one axis (--by style \| colour \| variant \| all) with th… | `production-groups-generate` |
-| `makea-cli admin get active-users` | read | `posthog` | Distinct active users per day over the last N days (DAU series). | `analytics-active-users` |
-| `makea-cli admin get analytics-query` | read | `posthog` | Run an arbitrary HogQL query (escape hatch). Example: analytics-query "SELECT count() FROM events" | `analytics-query` |
+| `makea-cli admin get active-users` | read | `POST /admin/analytics/query` | Distinct active users per day over the last N days (DAU series). | `analytics-active-users` |
+| `makea-cli admin get analytics-query` | read | `POST /admin/analytics/query` | Run an arbitrary HogQL query (escape hatch). Example: analytics-query "SELECT count() FROM events" | `analytics-query` |
 | `makea-cli admin get currency-conversion` | read | `currency-api` | avoids repeated lookups. | `convert-currency` |
-| `makea-cli admin get feature-usage` | read | `posthog` | How many distinct users used a feature recently, plus event volume. Matches $pageview path and feature_time_spent eve… | `analytics-feature-usage` |
+| `makea-cli admin get feature-usage` | read | `POST /admin/analytics/query` | How many distinct users used a feature recently, plus event volume. Matches $pageview path and feature_time_spent eve… | `analytics-feature-usage` |
 | `makea-cli admin get library-schema` | read | `GET /admin/library_components/schema` | the tech-pack library taxonomy: sections and their library-role field keys (run this before create/update). | `library-schema` |
 | `makea-cli admin get production-pricing` | read | `GET /admin/production_orders/{id}/details` | show a production order's price tiers, MOQ, sizes/colours, pricing groups and cart coverage. | `production-pricing-show` |
 | `makea-cli admin get quote-request` | read | `GET /admin/quote_requests/{quote_request_id}` | one quote request in full. | — |
 | `makea-cli admin get revenue-metrics` | read | `GET /admin/business-metrics/cumulative-payment-and-platform-revenue` | platform-wide payment received and platform revenue (service fee + transaction fee) bucketed over a date range. | `get-cumulative-payment-and-platform-revenue` |
 | `makea-cli admin get supplier-profile-schema` | read | `GET /admin/supplier/profile/schema` | supplier profile v2 schema (section/field taxonomy: sections, fields, options, required rules). | `get-supplier-profile-schema` |
 | `makea-cli admin get tech-spec-extraction` | read | `GET /admin/products/{id}/extract-tech-specifications` | AI-generate specs (not saved). | `extract-ai-tech-spec` |
-| `makea-cli admin get top-clicks` | read | `posthog` | which buttons/elements get clicked most. | `analytics-top-clicks` |
-| `makea-cli admin get top-features` | read | `posthog` | a quick map of which features get used most. | `analytics-top-features` |
+| `makea-cli admin get top-clicks` | read | `POST /admin/analytics/query` | which buttons/elements get clicked most. | `analytics-top-clicks` |
+| `makea-cli admin get top-features` | read | `POST /admin/analytics/query` | a quick map of which features get used most. | `analytics-top-features` |
 | `makea-cli admin list library-element` | read | `GET /admin/designer/{user_id}/library_components` | list a designer's tech-pack library (org-fanned). Optional --section scopes to one type. | `library-list` |
 | `makea-cli admin list misc-payment` | read | `GET /admin/products/{id}/misc-payments` | misc payments for one product (admin). | `list-misc-payments-by-product` |
 | `makea-cli admin list product-order` | read | `GET /admin/designer/get_all_product_orders` | designer product (SKU) list. For 大货 use admin list production-order or admin list production-order --product. | `list-product-orders` |

{makea_cli-0.2.8.dist-info → makea_cli-0.2.10.dist-info}/RECORD

@@ -1,23 +1,23 @@
-makea_cli/__init__.py,sha256=G6Dbxq2ws-1ZAXwDD8q0KWueYtso_Y6Uyvtj8sRWsPI,22
+makea_cli/__init__.py,sha256=waXgc7p-jgGCsUjdVfO_KjlVZblnCvrzf4A0dsBj_lg,23
 makea_cli/__main__.py,sha256=AkQjxWfKE3w9iD1d6I-2Zqvv2t9cct0oYyFF0UiA-Z0,144
-makea_cli/api_client.py,sha256=dzMCH9KzY7NJxoop-WVyqm_JQ3eU3hvFh_ic2Zk-evc,50763
+makea_cli/api_client.py,sha256=a2q6wPZkGn2D_HIrIqDgPFULpuLK_1rRhUr9BrQIqYM,54320
 makea_cli/auth_pkce.py,sha256=iXSyJ7DM3qVuj-3FwPiqM25CxXz9ebFs9FNthZdw3ws,7315
 makea_cli/broker.py,sha256=5O650nAdRuF-u9E1MuVM2jVv796iBdxJGIaJasxHij0,3019
-makea_cli/config.py,sha256=lVPsp-44V9pPyUNbcG-uQNV8srCrBVMZnb0HF38Paks,2906
+makea_cli/config.py,sha256=hz8MnJSkhxcIEZkcpHR005JrDceo1Xmi8qwIUq50cMU,3003
 makea_cli/errors.py,sha256=_2qKjvkU8YWeBcUd04Yn62lKkZoqQY52kH8klNMyxhM,2780
 makea_cli/identity.py,sha256=pfYT-asaY1ZTzoAzfqI-v4Eyz1RtxqR2YgvxRGx_lxg,2758
 makea_cli/main.py,sha256=nuTQ8_P8OSdRbjMHMB4qcKdex124nS-ApCW-zfbqlI0,7169
 makea_cli/output.py,sha256=VWvZe2Ad8zxT4ZQyBhFRc6wkFwbyYzQFPddepANGAbY,6361
-makea_cli/posthog_client.py,sha256=OcqspuG3mX0ZoHzhWBfO2K9ItYwk22L4clqBzWyV7GA,2177
+makea_cli/posthog_client.py,sha256=k0cy9Hq7bhdLlPvC1ZW_esJ70xHDdQzPQUlx-GpVskk,1921
 makea_cli/registry.py,sha256=GYJK_idhwIh1X2ictwFjn8PEMaXT56hFVkoLEVYrVqw,13722
 makea_cli/commands/__init__.py,sha256=sxDNEYDmQTASzH2uvMtqNwKLLbOQBzwPfxc-S1tHf-w,1474
 makea_cli/commands/_util.py,sha256=zSFwWaWpncARlKxgq4WuJlJvNv7XdZ39HfHrNOELHuw,980
 makea_cli/commands/analytics/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-makea_cli/commands/analytics/cmd.py,sha256=_I5fBlomTalAxRpB-jculS01AbjEC5cVG3lANJeryjM,6548
+makea_cli/commands/analytics/cmd.py,sha256=KVLUtYSeyYZ8_09jIuIAmePjQqcpQS2mb5PBBzGwQYQ,6562
 makea_cli/commands/auth/__init__.py,sha256=NXoKGfkY2X_hb8GnAyzhoI_qDXfpwKZPqt4HnOrXW3Y,73
 makea_cli/commands/auth/cmd.py,sha256=G9ZeiaJwzUUTptIyynr0V-82wI7eV0qVX0pD6rdPSXg,1321
 makea_cli/commands/brand/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-makea_cli/commands/brand/cmd.py,sha256=khcU-vVYKh6fKs43bQTgGHdMCIYG5QP9lkgVnwsrAew,39177
+makea_cli/commands/brand/cmd.py,sha256=lYT-9CRdOugVTGy2pJz9-RqdqWPIKIW10K8iSb0kQVE,42259
 makea_cli/commands/designer/__init__.py,sha256=Tc3Ju4-BKX2euBljhlrEd-Ksirk6JSPNixq4x0IbQYI,77
 makea_cli/commands/designer/cmd.py,sha256=4oOJ5tWYojUs8FBj3QRmgpwbicpsU1XqswoNlJpLLS8,23615
 makea_cli/commands/directory/__init__.py,sha256=rQHBc0JOFXynlzrBm_YfqoRuNsS-JOl-OOvPjgDbnIA,78
@@ -41,7 +41,7 @@ makea_cli/commands/production/cmd.py,sha256=s6fVAGzOvokF6Va5WKGEA2vw2x2hDQ3PrsF0
 makea_cli/commands/production/pricing_spec.py,sha256=xGbj7-ps3PcKuU6Oc59A70b62FjF6Awhr5IY3ymZveU,27174
 makea_cli/commands/supplier/__init__.py,sha256=qfQDeQdQ-B7I_uwFVfcp1vXFUTL4fAcNLu3ipsZ7dfs,77
 makea_cli/commands/supplier/cmd.py,sha256=crRCy9WfhkryHMIL3iufoiT90_SG3-mKChAtdhd06uc,58076
-makea_cli-0.2.8.dist-info/METADATA,sha256=OzSfopJ02Nfd_htjbm1nKlEfRbvesQkePfp1C5lDLlo,31660
-makea_cli-0.2.8.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
-makea_cli-0.2.8.dist-info/entry_points.txt,sha256=4x-lbVa1jBbNlkNq7L-rYyfRh2spZmc3BLIzP-Dl-Qk,50
-makea_cli-0.2.8.dist-info/RECORD,,
+makea_cli-0.2.10.dist-info/METADATA,sha256=iK_NxuwTO2xNvxR87xGQ3UGrQbfgCVoN2sd-M4IvLCo,31761
+makea_cli-0.2.10.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+makea_cli-0.2.10.dist-info/entry_points.txt,sha256=4x-lbVa1jBbNlkNq7L-rYyfRh2spZmc3BLIzP-Dl-Qk,50
+makea_cli-0.2.10.dist-info/RECORD,,