makea-cli 0.1.7__tar.gz → 0.1.9__tar.gz

{makea_cli-0.1.7 → makea_cli-0.1.9}/PKG-INFO

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

makea_cli-0.1.9/creds_temp.json

@@ -0,0 +1,6 @@
+{
+  "id_token": "eyJraWQiOiJmSmpIWG5cL3FtVlFhR01wZzNxN1duSDVheGNLRTJFSEpONWxRdTM0cm5jYz0iLCJhbGciOiJSUzI1NiJ9.eyJhdF9oYXNoIjoiVTBUM0lsSFptc2xGeWpXSEY2OENVQSIsInN1YiI6ImQyMjU3NGQ0LTAwYTEtNzA5OS1lMDNjLTI3ZjAxMGY4ZTg4ZSIsImVtYWlsX3ZlcmlmaWVkIjp0cnVlLCJpc3MiOiJodHRwczpcL1wvY29nbml0by1pZHAuZXUtd2VzdC0xLmFtYXpvbmF3cy5jb21cL2V1LXdlc3QtMV9SOUdIbHBHS3kiLCJjb2duaXRvOnVzZXJuYW1lIjoiYWRtaW5fdGVzdCIsInByZWZlcnJlZF91c2VybmFtZSI6ImFkbWluX3Rlc3QiLCJvcmlnaW5fanRpIjoiMzE4M2E3N2EtYjQxMy00NDEyLWE5OGQtYmQwMzdkZTZmYWQxIiwiY3VzdG9tOnVzZXJUeXBlIjoiYWRtaW4iLCJhdWQiOiIzbmZqOGczZXQ0bzg1a2Q2ZXNzYXMxNnZoMCIsImV2ZW50X2lkIjoiMGNmZGVkY2MtMWRjNS00YmZjLWE0MGMtZTAzZjk1YmUwMGYzIiwiY3VzdG9tOnN1YnNjcmlwdGlvblR5cGUiOiJncm93dGgiLCJ0b2tlbl91c2UiOiJpZCIsImF1dGhfdGltZSI6MTc3Nzk1OTMwNiwibmFtZSI6ImFkbWluX3Rlc3QiLCJleHAiOjE3Nzc5NjI5MDYsImlhdCI6MTc3Nzk1OTMwNiwiY3VzdG9tOnN1YnNjcmlwdGlvbkFjdGl2ZSI6InRydWUiLCJqdGkiOiJjOWEyYzBlZC0wNWU3LTQzZTktOGEyZS01YTdhNGVjMTRlMzYiLCJlbWFpbCI6InZpbmNoeS5jaGFuQGdhcm1lbnRieS5jb20ifQ.k4UWGG1HG477j3vVoY6kcP1IlitVWRioK5M-idx8nRb9Tj2AY-W4bH7iidjfmFhNPFOKud14MneGUpdN-AYl9N6Ng86AYj_LxsLwRmywVzLAlxxMlNphakgRAm9RvNoA3YMTtSVlRLS3EhQ1XZ_zhYqWYrBY86QJ6viT4vgLpbNo_K-B3P45KGBfbEMdnhbuNAbIRx9j9PHKmIB-NWEXpgbUin23tyRjAi3OkWMMc8uw89A8WPvHOpHTiuq5bm8C4Fi8vv-WyQ5LWZzSKrq-o6prW1FmW7Vl-GwejKY97LdhPQYlV0yj3TR1RvrGXt8tGqvMTA3NbUSEzwEXaIkg4A",
+  "refresh_token": "eyJjdHkiOiJKV1QiLCJlbmMiOiJBMjU2R0NNIiwiYWxnIjoiUlNBLU9BRVAifQ.bYhx1WmDlakjGyWn6JFjazkbTO8rmVLqo4M4Pynlr4BySleoi4ogskx4j80kdLf2jxKhTfc6K6gqZlrLKO89Rk1ZKeoPhgEoNQN4tPBKVrES0K_axV_bhYMcexG70g_MfPZv6MtA2DPu1pisxJYdNtMtNngeLhzN_gwu2RKOgwXKsT3blVP_VoN5jq2eSR2UkFsPMykESN-gnREpnxZE4rWlZt-s3aEwYdDn7r3gQdbO5EnLPu8VAy861Vl8qIBw3Z49zCJiMl3OHbp1j9FTA5E7JdX9Y0KNH6wvKag-_UXcxfn6SMzo7OJ1zEcz-iC7QU_CVt6fh8RMyU8AwbGH5w.hrcf6QKQDJUq7E3p.ATF4evqU8_M1-1HwNQYlsUS7PFei_sNvjm-sBSKPbOJA9nzFWEaxFBicBj2AJ-WgA5liS-m1QIHlu7Ax5a98eNLDqXLlGBUcyrF5BtOqPvNfQBI_ha86PBadleFmLX7UrPb2vONcPovRWHE0gDUMr-0-CLbidODoL10fv8jc-X4T2195-a3sHsF2JwqPJkNQ-HQoaMriRQTL59XCDfIxB0kKHLRnmPM0o1Ar8Wn5X-HEXsDjWocD15R28BzvaNUJrSYDiHuTCyZCH9BHWZY4MTAf4SgyuA86nBvtmT1xiyBA7C2LHeNQLAIMXpKu9jx8u2vfvvINzdFBTNioSaOv2PFfHB0UY9R7ebAYPIqXHKMFYw3FXnJAie4_nkR2798MzL3FM5tZec5LfopA1JdPiEW5hbTUvV8XasHPPdifbIKJu3guDBIAU1EKTzJ-Uzt5bwDtdm7fb3s_fLnlpPXB3fnjGNMAR993ycw4xQvlaQiElBjM6_ZTvpY4wDVEv42bIpJzinKkdlWF2KC2j-XJGjFJj0dwBsSe6LS7ENy5sN319mvGOr8yOjfU56mWFj9AJizEQQWcsA9rPgTkxVWlRp8UspnqAgKcikRchb8kPtaxh9Ay3YPyz5OdP0thmDFwZHmvhQk8ByHtJO7deZp19RhAjK8Ynu28z6-7CUb8V_4frAQghd41RBJRMWY-VNTYXc3pAokCys_fT8f2A-vXPCKlL_elqKoLRCERNKvhDsGps6e2rdiPL7RWalTm1MlV3YgoeEuAFspEPXmEJfdP93dD7kQ9RfAlWcSimXl-6uUmmvYLhGNTFnnPtjgt802Q4rb23TeHmTmuBL2ZGxqyj2oJoAIeNeXRwolqKdNHDJow2sSw60LD7hGR3uEaoN0liiSZbsSwiBhoga4WN7fnYXt-NpjAulXxeM63KsnAi6rnIkfBPK-wnoLVHJx11vyj1MeWFBGOsAdYjYLVns7Qpal75Tdb1eiTcz6yD4XC34scoQDre9TQ_kcfEBkT4_JbtfZz959Dk2KdCJa5xWpNZJO6zj8CqH5iflkCEMerTDXSUfnkXPBachq6tMhuZgSq-6GldeoGCE_CoChpPGoofp4WUGlE0mzU89BcZ7EXNez7XB_F7HYFhg2C7fVQ7nblSRyWrtoiyGvLCUeMCqHqmS4HIhdeHnQzNl8CCawT6b9RMjNxNlG_wWq33Ya-DcvMZsnVzsoVOqhCqXVtJ_6UiO--QP89MA5j2GzcAkmId4anQr0xXcN4_ZAxqun4Tz4grphLRBJgmBHxlkjlzw.GUKzdtz3_VkgZ03M4A1htg",
+  "expires_in": 3600,
+  "saved_at": 1777959306.405317
+}

makea_cli-0.1.9/makea_cli/__init__.py

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

{makea_cli-0.1.7 → makea_cli-0.1.9}/makea_cli/api_client.py

@@ -656,6 +656,23 @@ def designer_create_or_update_collection(
     return post_json("/designer/collections/create", body, timeout=timeout)
 
 
+def designer_link_product_to_collection(
+    product_id: str,
+    collection_id: str,
+    *,
+    timeout: float = 60.0,
+) -> Any:
+    """
+    POST ``/designer/products/{product_id}/link-to-collection`` — JSON body
+    ``{"collection_id": "<uuid>"}`` (designer token must own the product).
+    """
+    return post_json(
+        f"/designer/products/{product_id}/link-to-collection",
+        {"collection_id": collection_id},
+        timeout=timeout,
+    )
+
+
 def designer_upload_document(
     *,
     product_id: str | None,

{makea_cli-0.1.7 → makea_cli-0.1.9}/makea_cli/commands/designer/cmd.py

@@ -19,53 +19,129 @@ Request shape
   HTTP body is {"product": { ... }}. --file may be that wrapper or only the inner object;
   the CLI wraps bare objects as {"product": <your dict>}.
 
-Hard requirement — backend parse (Product.to_domain)
-  user_id — MUST exist on the product object (string). The API reads JSON before applying
-      token rules: missing user_id raises KeyError / 400. In normal designer mode the
-      service then overwrites user_id with the Cognito sub from the token; under admin
-      impersonation the value in JSON is the target designer (same as the web app).
-  requests[] — each element must include "type" and "status" (see domain/Request.py).
-      Empty list is valid JSON; the web flow always sends at least one.
-
-Specifications page parity (manufacture/.../specifications — isFormValid + handleComplete)
-  The create_or_update endpoint does not re-run every UI validator. To match what the
-  React page sends before "Save", include:
-  display_name — non-empty project name.
-  contact_name, contact_email, contact_phone — non-empty (web also validates email/phone).
-  product_category — non-empty string (subcategory optional).
-  has_sampling — boolean (web maps yes/no from the physical-sample question).
-  shipping_address — object with street, city, state, postal_code, country (web requires
-      each field non-empty; backend accepts partial/None via ShippingAddress.to_domain).
-  minimum_unit_requested — integer > 0 (MOQ / min stock).
-  bulk_production_size_count — integer > 0.
-  grading_required — boolean (not null); web blocks submit until answered.
-  requests — at least one of DESIGN_DEVELOPMENT, SOURCING, MANUFACTURING, LOGISTICS with
-      status such as REQUESTED (same rows the page builds from service checkboxes).
-  available_documents — non-empty after uploads: each item is parsed by Document.to_domain
-      (document_id, name, s3_key, type, status, etc. from upload/get_product responses).
-      The page requires at least one tech pack or sketch before save.
-  Optional in the same API call as the page: collection_id, product_subcategory,
-      expected_launch_date, target_product_cost / target_sales_price, sampling_size_mode,
-      sampling_sizes, custom_notes, reviewed_at / reviewed_by, created_at / updated_at,
-      reference_id / status.
-
-Money
-  target_product_cost / target_sales_price — {"currency": "<ISO>", "value": <number>}
-  (Price.to_domain uses "value", not "amount"; the TS form stores "amount" but maps to
-  "value" in JSON).
+Requirement — parity with web “Specifications” step (manufacture/.../specifications)
+  When creating or submitting a product via CLI, fill every field the React page collects and
+  validates before Save (isFormValid + handleComplete). The API does not re-run UI checks;
+  missing items cause divergent behavior or failed submission versus the browser flow.
+
+  Mandatory on product (same semantics as the web form):
+    display_name — project name (maps from form “Project name”).
+    contact_name, contact_email, contact_phone — non-empty; email format like UI;
+      phone: digits-only length 10–15 after stripping separators (same rule as frontend).
+    product_category — exactly one of the literals listed under “Product categories” below.
+    product_subcategory — see “Subcategories”: REQUIRED when the chosen category has a list;
+      for Clothing there is no subcategory list in the UI — send null or omit (same as web).
+    has_sampling — boolean (yes/no on UI maps to true/false).
+    shipping_address — object street, city, state, postal_code, country; web requires each
+      non-empty string for submit.
+    minimum_unit_requested — integer > 0 (“Minimum stock / MOQ”).
+    bulk_production_size_count — integer > 0 (“Bulk production size count”).
+    grading_required — boolean, must not be null (frontend blocks until answered).
+    requests — at least one row; mirror selected services with status REQUESTED:
+      types DESIGN_DEVELOPMENT, SOURCING, MANUFACTURING, LOGISTICS (same combinations as
+      ticking boxes / “all services”).
+    available_documents — non-empty list with valid Document-shaped entries after running
+      designer-upload-document (web requires at least one TECH_PACK or SKETCH-class upload).
+    sampling_size_mode — REQUIRED for CLI create payload; one of:
+      "manual" | "from_documents" (same radio options as frontend).
+    sampling_sizes — REQUIRED list of strings for CLI create payload.
+      Use normalized size labels such as ["XS","S","M","L","XL"], ["S","M","L"],
+      or ["One Size"].
+      For sampling_size_mode="manual", this is the exact manual list.
+      For sampling_size_mode="from_documents", still send a non-empty list describing
+      intended sampling sizes if known, to keep CLI payload explicit and complete.
+
+  Strongly recommended / parity when used on web:
+    collection_id — when the designer selects a collection, set product.collection_id to
+      that UUID string (same field posted in the web Save JSON). If no collection, omit or
+      null (do not send placeholder “none”).
+      The SPA may also POST /designer/products/{reference_id}/link-to-collection with
+      {"collection_id": "..."}; setting collection_id on the product is what the Save body
+      does — duplicate link POST is optional for CLI unless you need identical double-write.
+      Use designer-link-product-to-collection <product_id> <collection_id> for that POST alone.
+      Note: backend create_or_update_product does not persist collection_id by itself; this
+      command auto-calls link-to-collection after upsert when collection_id is present.
+
+  Optional fields the web sends when filled:
+    expected_launch_date — ISO date string or null.
+    target_product_cost, target_sales_price — {"currency": "<ISO>", "value": <number>}
+      (Price uses "value", not "amount").
+    custom_notes — string.
 
-Server-side transition (DesignerService.create_or_update_product)
-  If status is DRAFT and both requests and available_documents are non-empty, the product
-  may be promoted to IN_REVIEW and notification email sent — same as submitting a complete
-  draft with docs through the UI.
+Hard requirement — backend parse (Product.to_domain)
+  user_id — MUST exist on the product object (string). Missing raises KeyError / 400. Normal
+      designer tokens overwrite with Cognito sub; impersonation uses JSON user_id as target.
 
-Advanced / round-trip
-  supplier_links, fabric_trim_links, fees, internal_notes, customer_notes,
-  selected_image_document_id, moq, lead_time, product_type, description, prices — see
-  garmentby_service/domain/Product.py::to_domain.
+Money — same as web JSON mapping to target_product_cost / target_sales_price above.
 
-Auth
-  makea-cli auth with a designer-capable token (designer user or impersonation, per env).
+Server-side transition (DesignerService.create_or_update_product)
+  If status is DRAFT and requests + available_documents are non-empty, product may move to
+  IN_REVIEW and notify — same as completing the specifications flow in the browser.
+  CLI default behavior keeps DRAFT: designer-upsert-product blocks such payloads unless
+  --allow-auto-submit is provided.
+  If you want to keep DRAFT, keep requests as an empty list ([]). This is the safest
+  backend-compatible way to avoid auto-transition.
+
+Advanced — supplier_links, fabric_trim_links, fees, notes, etc.: Product.to_domain
+
+Auth — designer-capable token from makea-cli auth (or impersonation per env).
+
+Product categories (exact strings — client/src/constants/product-categories.ts PRODUCT_CATEGORIES)
+  Clothing
+  Soft Accessories
+  Hard Accessories
+  Packaging
+  Merch
+
+Subcategories (exact “name” strings — SUBCATEGORY_OPTIONS; pick one when category lists rows)
+
+  Soft Accessories:
+    Scarves and Shawls
+    Hats and Beanies
+    Gloves
+    Belts
+    Ties and Bowties
+    Socks and Hosiery
+    Fabric Bags and Pouches
+
+  Hard Accessories:
+    Jewelry
+    Eyewear
+    Watches
+    Structured Handbags
+    Hair Accessories
+    Belt Buckles
+    Keychains and Charms
+
+  Packaging:
+    Primary Packaging
+      — Direct-contact protection such as polybags, tissue paper, pouches, brand tags,
+        size tags, hang tags
+    Secondary Packaging
+      — Branded presentation items like retail boxes, shopping bags, and mailers
+    Transit Packaging
+      — Outer logistics layers like shipping cartons, padding, and pallet wraps
+
+  Merch:
+    Apparel Merch
+      — T-shirts and hoodies, sweatshirts and joggers, caps and beanies,
+        outerwear (jackets, windbreakers)
+    Accessories Merch
+      — Tote bags and canvas pouches, socks and scarves, keychains and lanyards,
+        phone cases and tech sleeves
+    Lifestyle Merch
+      — Mugs and drinkware, stickers and patches, notebooks and stationery,
+        candles and home items
+    Limited Edition Merch
+      — Numbered collector items, signed or autographed products,
+        artist collaboration pieces
+
+  Clothing — no subcategory rows in the UI constants; use null / omit product_subcategory.
+
+Workflow reminder — documents before upsert
+  Run designer-upload-document for each file, merge returned available_documents (and
+  reference_id if new) into the product payload, then designer-upsert-product — same order
+  as the specifications page.
 """.strip()
 
 _DESIGNER_UPLOAD_EPILOG = """
@@ -79,6 +155,9 @@ Workflow (same idea as the specifications page): upload files, read back documen
 product_id from JSON, merge available_documents into your product payload, then run
 designer-upsert-product.
 
+Full checklist for the final payload (categories, collection_id, requests, MOQ, etc.) lives in
+designer-upsert-product --help epilog.
+
 Response: success, documents (metadata list), product_id (always returned; generated if you
 omitted --product-id).
 """.strip()
@@ -109,8 +188,8 @@ def register(app: typer.Typer) -> None:
     @app.command(
         "designer-upsert-product",
         help=(
-            "POST or PUT /designer/product/create_or_update_product — "
-            "create/update a designer product (specifications-style payload)."
+            "POST/PUT create_or_update_product — payload must match manufacture/specifications "
+            "(all frontend fields; categories/subcategories + collection_id in --help epilog)."
         ),
         epilog=_DESIGNER_UPSERT_EPILOG,
     )
@@ -140,8 +219,22 @@ def register(app: typer.Typer) -> None:
             min=30.0,
             max=600.0,
         ),
+        allow_auto_submit: bool = typer.Option(
+            False,
+            "--allow-auto-submit",
+            help=(
+                "Allow backend auto-transition from DRAFT to IN_REVIEW when both requests "
+                "and available_documents are non-empty."
+            ),
+        ),
     ) -> None:
-        """Send --file JSON to the designer create/update product API (see --help epilog)."""
+        """
+        Send --file JSON to the designer create/update product API.
+
+        Read the epilog (makea-cli designer-upsert-product --help): list every field the web
+        Specifications step collects — category/subcategory literals, collection_id when using
+        a collection, requests/services mapping, documents workflow, and pricing/shipping keys.
+        """
         try:
             raw = json.loads(file.read_text(encoding="utf-8"))
             body = _normalize_designer_product_body(raw)
@@ -149,14 +242,66 @@ def register(app: typer.Typer) -> None:
             console.print(f"[red]Invalid file: {e}[/red]")
             raise typer.Exit(1) from e
 
-        print_json_or_exit(
-            console,
-            lambda: api_client.designer_create_or_update_product(
+        def run() -> Any:
+            product_obj = body.get("product", {})
+            requests = product_obj.get("requests") or []
+            available_documents = product_obj.get("available_documents") or []
+            requested_status = str(product_obj.get("status") or "DRAFT").upper()
+
+            # Backend rule: DRAFT + requests + available_documents => IN_REVIEW.
+            if (
+                not allow_auto_submit
+                and requested_status == "DRAFT"
+                and len(requests) > 0
+                and len(available_documents) > 0
+            ):
+                raise RuntimeError(
+                    "Payload would auto-submit to IN_REVIEW (DRAFT + requests + "
+                    "available_documents). Remove requests or available_documents to keep draft, "
+                    "or pass --allow-auto-submit."
+                )
+
+            upsert = api_client.designer_create_or_update_product(
                 body,
                 use_put=use_put,
                 timeout=timeout,
-            ),
-        )
+            )
+
+            # Collection linkage is persisted by a separate endpoint.
+            collection_id_raw = product_obj.get("collection_id")
+            collection_id = str(collection_id_raw).strip() if collection_id_raw is not None else ""
+            if collection_id.lower() in {"", "none", "null"}:
+                collection_id = ""
+            if not collection_id:
+                return upsert
+
+            product_payload = upsert.get("product") if isinstance(upsert, dict) else None
+            product_id = (
+                product_payload.get("reference_id") if isinstance(product_payload, dict) else None
+            ) or product_obj.get("reference_id")
+            if not product_id:
+                raise RuntimeError(
+                    "Upsert succeeded but no product reference_id found; cannot link collection."
+                )
+
+            try:
+                linked = api_client.designer_link_product_to_collection(
+                    str(product_id),
+                    collection_id,
+                    timeout=timeout,
+                )
+                return {"upsert": upsert, "link_collection": linked}
+            except Exception as e:
+                # Keep upsert result visible even when collection ownership/link fails.
+                return {
+                    "upsert": upsert,
+                    "link_collection": {
+                        "success": False,
+                        "error": str(e),
+                    },
+                }
+
+        print_json_or_exit(console, run)
 
     @app.command(
         "designer-upload-document",
@@ -379,3 +524,41 @@ def register(app: typer.Typer) -> None:
                 timeout=timeout,
             ),
         )
+
+    @app.command(
+        "designer-link-product-to-collection",
+        help=("POST /designer/products/{id}/link-to-collection — assign product to a collection."),
+    )
+    def designer_link_product_to_collection(
+        product_id: str = typer.Argument(
+            ...,
+            help="Product ``reference_id`` (designer must own this product).",
+        ),
+        collection_id: str = typer.Argument(
+            ...,
+            help="Collection UUID from designer-create-collection or GET /designer/collections.",
+        ),
+        timeout: float = typer.Option(
+            60.0,
+            "--timeout",
+            "-t",
+            help="HTTP timeout in seconds.",
+            min=10.0,
+            max=300.0,
+        ),
+    ) -> None:
+        """
+        Link an existing product row to a collection (same optional step as the web app after Save).
+
+        Input: path ``product_id`` and JSON body field ``collection_id`` (POST body).
+
+        Output: JSON ``{ success, message }`` on success; ``success`` false with ``error`` otherwise.
+        """
+        print_json_or_exit(
+            console,
+            lambda: api_client.designer_link_product_to_collection(
+                product_id,
+                collection_id,
+                timeout=timeout,
+            ),
+        )

{makea_cli-0.1.7 → makea_cli-0.1.9}/pyproject.toml

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

makea_cli-0.1.7/makea_cli/__init__.py

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