makea-cli 0.2.4__py3-none-any.whl → 0.2.6__py3-none-any.whl

makea_cli/__init__.py

@@ -1 +1 @@
-__version__ = "0.2.4"
+__version__ = "0.2.6"

makea_cli/api_client.py

@@ -1213,6 +1213,27 @@ def designer_create_checkout(body: dict[str, Any]) -> Any:
     return post_json("/designer/payments/basket/create-session", body)
 
 
+def designer_production_price(production_order_id: str, phase: str) -> Any:
+    """GET /designer/production_orders/{id}/calculate_price — deposit or balance, itemised."""
+    return get_json(
+        f"/designer/production_orders/{production_order_id}/calculate_price",
+        params={"payment_type": phase},
+    )
+
+
+def designer_set_production_cart(production_order_id: str, cart: dict[str, int]) -> Any:
+    """PUT /designer/production_orders/{id}/cart — replace the size x colour quantities."""
+    return put_json(f"/designer/production_orders/{production_order_id}/cart", {"cart_items": cart})
+
+
+def designer_set_production_lock(production_order_id: str, locked: bool) -> Any:
+    """POST /designer/production_orders/{id}/configuration-lock — place or reopen the run."""
+    return post_json(
+        f"/designer/production_orders/{production_order_id}/configuration-lock",
+        {"locked": locked},
+    )
+
+
 def designer_list_collections() -> Any:
     """GET /designer/collections — the brand's collections."""
     return get_json("/designer/collections")

makea_cli/commands/brand/cmd.py

@@ -914,3 +914,99 @@ def register(app: typer.Typer) -> None:
         if accept_terms:
             body["terms_accepted"] = True
         print_json_or_exit(console, lambda: api_client.designer_create_checkout(body))
+
+    # --- the production journey: quantities, place the order, pay the deposit ---
+
+    @command(
+        app,
+        "designer",
+        "get",
+        "production-price",
+        api="GET /designer/production_orders/{production_order_id}/calculate_price",
+        help=(
+            "GET /designer/production_orders/{id}/calculate_price — what the deposit (or the "
+            "balance, --phase final) comes to for the quantities on the run right now, line "
+            "by line."
+        ),
+    )
+    def get_production_price(
+        production_order_id: str = typer.Argument(..., help="Production order id."),
+        phase: str = typer.Option("deposit", "--phase", help="deposit or final."),
+    ) -> None:
+        """Price a production order's deposit or balance."""
+        if phase not in ("deposit", "final"):
+            raise typer.BadParameter("--phase is deposit or final")
+        print_json_or_exit(
+            console,
+            lambda: api_client.designer_production_price(production_order_id, phase),
+        )
+
+    @command(
+        app,
+        "designer",
+        "set",
+        "production-cart",
+        api="PUT /designer/production_orders/{production_order_id}/cart",
+        side_effects=["replaces the run's quantities; nothing is ordered until it is locked"],
+        approval="auto",
+        help=(
+            "PUT /designer/production_orders/{id}/cart — the quantity of every size and "
+            "colour on the run. Replaces the whole cart: pass every cell you want kept. "
+            "--qty repeats as 'SIZE,#RRGGBB=COUNT' (quote it: # starts a shell comment), "
+            "with the sizes and colour hex codes from "
+            "the order's available_sizes / available_colors (`designer list "
+            "production-order --product <id>`). Refused once the run is locked."
+        ),
+    )
+    def set_production_cart(
+        production_order_id: str = typer.Argument(..., help="Production order id."),
+        qty: list[str] = typer.Option(
+            ..., "--qty", help="SIZE,#RRGGBB=COUNT for one cell (repeat)."
+        ),
+    ) -> None:
+        """Set a production order's size x colour quantities."""
+        cart: dict[str, int] = {}
+        for cell in qty:
+            key, sep, count = cell.rpartition("=")
+            if not sep or "," not in key:
+                raise typer.BadParameter(f"--qty {cell!r}: expected SIZE,#RRGGBB=COUNT")
+            try:
+                n = int(count)
+            except ValueError as e:
+                raise typer.BadParameter(f"--qty {cell!r}: COUNT must be a whole number") from e
+            if n < 0:
+                raise typer.BadParameter(f"--qty {cell!r}: COUNT cannot be negative")
+            size, _, colour = key.partition(",")
+            cart[f"{size.strip()},{colour.strip()}"] = n
+        print_json_or_exit(
+            console,
+            lambda: api_client.designer_set_production_cart(production_order_id, cart),
+        )
+
+    @command(
+        app,
+        "designer",
+        "set",
+        "production-lock",
+        api="POST /designer/production_orders/{production_order_id}/configuration-lock",
+        side_effects=[
+            "places the order: the quantities are final and the deposit becomes payable",
+            "can be unlocked again until the deposit is paid",
+        ],
+        approval="ask",
+        help=(
+            "POST /designer/production_orders/{id}/configuration-lock — place the order "
+            "with the quantities on the run (--unlock to reopen them). Locking is what makes "
+            "the deposit payable: `designer create checkout --key "
+            "production:<id>:deposit --accept-terms`."
+        ),
+    )
+    def set_production_lock(
+        production_order_id: str = typer.Argument(..., help="Production order id."),
+        unlock: bool = typer.Option(False, "--unlock", help="Reopen the quantities instead."),
+    ) -> None:
+        """Lock (place) or unlock a production order's configuration."""
+        print_json_or_exit(
+            console,
+            lambda: api_client.designer_set_production_lock(production_order_id, not unlock),
+        )

makea_cli/commands/orders/cmd.py

@@ -314,3 +314,66 @@ def register(app: typer.Typer) -> None:
                 offset=offset,
             ),
         )
+
+    @command(
+        app,
+        "admin",
+        "update",
+        "tracking-status",
+        api="POST /admin/tracking/carrier_status",
+        side_effects=[
+            "moves the order to delivered when the status says so",
+            "emails and messages the designer, supplier and admins as the 17track webhook did",
+        ],
+        approval="ask",
+        idempotent=True,
+        help=(
+            "POST /admin/tracking/carrier_status — apply a carrier status looked up by hand "
+            "(the tracking-sweep skill) to one order. Runs the 17track webhook path: status, "
+            "fan-out to every order sharing the number, and the delivered emails."
+        ),
+    )
+    def update_tracking_status(
+        kind: str = typer.Argument(
+            ...,
+            help="sampling | production | restock | shipping | material | reference_sample",
+        ),
+        order_id: str = typer.Argument(..., help="Order id (product id for reference_sample)."),
+        tracking_number: str = typer.Argument(..., help="The parcel's tracking number."),
+        status: str = typer.Option(
+            ..., "--status", help="17track status, e.g. Delivered, InTransit."
+        ),
+        sub_status: str | None = typer.Option(None, "--sub-status"),
+        event: str | None = typer.Option(None, "--event", help="Latest carrier event text."),
+        location: str | None = typer.Option(None, "--location"),
+        time_utc: str | None = typer.Option(
+            None, "--time", help="Latest event time, ISO 8601 UTC."
+        ),
+    ) -> None:
+        """
+        Tell Makea what the carrier says about one parcel.
+
+        Output: JSON from the webhook path: success, status, and one entry per
+        order the number was fanned out to. Repeating a Delivered update is a
+        no-op (no second email).
+        """
+        track_info = {
+            "latest_status": {"status": status, "sub_status": sub_status},
+            "latest_event": {
+                "description": event,
+                "location": location,
+                "time_utc": time_utc,
+            },
+        }
+        print_json_or_exit(
+            console,
+            lambda: api_client.post_json(
+                "/admin/tracking/carrier_status",
+                {
+                    "kind": kind,
+                    "order_id": order_id,
+                    "tracking_number": tracking_number,
+                    "track_info": track_info,
+                },
+            ),
+        )

{makea_cli-0.2.4.dist-info → makea_cli-0.2.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: makea-cli
-Version: 0.2.4
+Version: 0.2.6
 Summary: Makea admin CLI (browser login + Makea admin HTTP API)
 Requires-Python: >=3.10
 Requires-Dist: click<9,>=8.1
@@ -131,6 +131,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin update quote-request` | write（ask） | `PATCH /admin/quote_requests/{quote_request_id}/update` | set a quote request's stage, status and/or due date. Only what you pass is changed. This is the door that unblocks a … | `update-quote-request` |
 | `makea-cli admin update supplier` | write（ask） | `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 fi… | `update-supplier` |
 | `makea-cli admin update tech-spec` | write（ask） | `POST /admin/products/{id}/technical-specifications` | persist specs from a JSON file. | `save-product-tech-spec` |
+| `makea-cli admin update tracking-status` | write（ask） | `POST /admin/tracking/carrier_status` | apply a carrier status looked up by hand (tracking-sweep skill) to one order. Runs the 17track webhook path: status, fan-out, delivered emails. | — |
 | `makea-cli admin update user` | write（ask） | `PUT /admin/user-profiles/{user_id}/update` | admin updates DynamoDB user profile fields and/or Cognito custom:userType. Allowed --user-type values: "Fashion brand… | `update-user-profile` |
 | `makea-cli admin upload financial-document` | write（auto） | `POST /admin/products/{product_id}/financial_documents` | upload one or more files to AWS S3 and return financial document metadata. | `upload-financial-documents` |
 | `makea-cli admin upload link-document` | write（auto） | `POST /admin/upload_link_document` | upload a file to AWS S3 and return document domain metadata for reuse as input in other commands. | `upload-link-document` |
@@ -157,6 +158,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli designer get collection` | read | `GET /designer/collections/{collection_id}/overview` | one collection with its products, orders and lifecycle in a single read. | — |
 | `makea-cli designer get lifecycle` | read | `GET /designer/product_orders/{product_order_id}/lifecycle` | which stage this product is in. | — |
 | `makea-cli designer get product` | read | `GET /designer/get_product` | one product: status, documents, prices, links. | — |
+| `makea-cli designer get production-price` | read | `GET /designer/production_orders/{production_order_id}/calculate_price` | what the deposit (or the balance, --phase final) comes to for the quantities on the run right now, line by line. | — |
 | `makea-cli designer get quote-advice` | read | `GET /designer/product/quote_advice` | which quote to award and why, from cache. Reading never spends a model call; the web app is what asks for a fresh one. | — |
 | `makea-cli designer get tech-pack` | read | `GET /designer/products/{product_id}/technical-specifications` | the product's tech pack. | — |
 | `makea-cli designer get tech-pack-history` | read | `GET /designer/products/{product_id}/specification-change-history` | who changed which spec field, when, and from what. | — |
@@ -173,6 +175,8 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli designer list task` | read | `GET /designer/tasks` | what the platform is waiting on you for. | — |
 | `makea-cli designer search note` | read | `GET /designer/products/{product_id}/channel_search` | full-text search across a product's conversation; --channel narrows to one channel key. | — |
 | `makea-cli designer set product-collection` | write（auto） | `POST /designer/products/{id}/link-to-collection` | assign product to a collection. | `designer-link-product-to-collection` |
+| `makea-cli designer set production-cart` | write（auto） | `PUT /designer/production_orders/{production_order_id}/cart` | the quantity of every size and colour on the run. Replaces the whole cart: pass every cell you want kept. --qty repea… | — |
+| `makea-cli designer set production-lock` | write（ask） | `POST /designer/production_orders/{production_order_id}/configuration-lock` | place the order with the quantities on the run (--unlock to reopen them). Locking is what makes the deposit payable: … | — |
 | `makea-cli designer submit production-order` | write（ask） | `POST /designer/production_orders/{production_order_id}/submit` | submit a 大货 order. This is the commitment, so --dry-run and confirm with the user first. | — |
 | `makea-cli designer submit sampling-order` | write（ask） | `POST /designer/sampling_orders/{sampling_order_id}/confirm` | confirm a sample order so the supplier starts. Run --dry-run first and read it back to the user. | — |
 | `makea-cli designer submit tech-pack` | write（ask） | `POST /designer/products/{product_id}/technical-specifications/confirm` | confirm the tech pack, the step before anyone is asked to quote. | — |

{makea_cli-0.2.4.dist-info → makea_cli-0.2.6.dist-info}/RECORD

@@ -1,6 +1,6 @@
-makea_cli/__init__.py,sha256=SBl2EPFW-ltPvQ7vbVWItyAsz3aKYIpjO7vcfr84GkU,22
+makea_cli/__init__.py,sha256=Oz5HbwHMyE87nmwV80AZzpkJPf-wBg7eDuJr_BXZkhU,22
 makea_cli/__main__.py,sha256=AkQjxWfKE3w9iD1d6I-2Zqvv2t9cct0oYyFF0UiA-Z0,144
-makea_cli/api_client.py,sha256=rm_0M09oNte-4U_E81k2L9JeHd0NfampHOoH0Ub5-A4,49562
+makea_cli/api_client.py,sha256=Q17LkGpWs_W87Y8ArFBT2l8LfBfsc_OUGPazOaJhQas,50484
 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
@@ -17,7 +17,7 @@ makea_cli/commands/analytics/cmd.py,sha256=_I5fBlomTalAxRpB-jculS01AbjEC5cVG3lAN
 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=WLX3zixuUbQCT6gMT2hMg5qlRgyNJDWYDi15dTsQ99g,35050
+makea_cli/commands/brand/cmd.py,sha256=khcU-vVYKh6fKs43bQTgGHdMCIYG5QP9lkgVnwsrAew,39177
 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
@@ -33,7 +33,7 @@ makea_cli/commands/library/cmd.py,sha256=eXZa6iLyPaoEWtRd-UmhRT6Ox-zlfs89gJqGn-I
 makea_cli/commands/metrics/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 makea_cli/commands/metrics/cmd.py,sha256=mXMSy3zHgJXzqLNy6OrdQqySk9COknPKVDf_SQQdFIA,7662
 makea_cli/commands/orders/__init__.py,sha256=6WKPqX02e0RRPmItPIBJ0TA4_yDI2PVvBDkAiMQu9rU,75
-makea_cli/commands/orders/cmd.py,sha256=pzmUUJ2hgwJGloqWjWLitWjxbRrkaJq93TUIcLPYMJc,10537
+makea_cli/commands/orders/cmd.py,sha256=_5s_G6vSEvKXYbfZifX41r1s1HX1Cv7CSPWJ0zeXdjY,13022
 makea_cli/commands/product/__init__.py,sha256=mfdonFmpbddDSlJq6JWNWgNpM6aOpKtZr-3FJ6scrwg,76
 makea_cli/commands/product/cmd.py,sha256=W0oVTZvsK1QWZWv2x6NC26_JQMXrO16O8gYuKYPWC08,7101
 makea_cli/commands/production/__init__.py,sha256=Whn5ziwVMt4jzcokiFWLhWIpRLYC-ldnjZgAzeQ3We4,79
@@ -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.4.dist-info/METADATA,sha256=YNBpGwq6K0GXZF9xNELy1AOgvJykyKD2w7VcuE1ryHs,30554
-makea_cli-0.2.4.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
-makea_cli-0.2.4.dist-info/entry_points.txt,sha256=4x-lbVa1jBbNlkNq7L-rYyfRh2spZmc3BLIzP-Dl-Qk,50
-makea_cli-0.2.4.dist-info/RECORD,,
+makea_cli-0.2.6.dist-info/METADATA,sha256=26l-95HysQaWiBsSEMcpwTvruyaG-uRrFXxg6PQA8PI,31580
+makea_cli-0.2.6.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+makea_cli-0.2.6.dist-info/entry_points.txt,sha256=4x-lbVa1jBbNlkNq7L-rYyfRh2spZmc3BLIzP-Dl-Qk,50
+makea_cli-0.2.6.dist-info/RECORD,,