makea-cli 0.1.22__tar.gz → 0.1.24__tar.gz

{makea_cli-0.1.22 → makea_cli-0.1.24}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: makea-cli
-Version: 0.1.22
+Version: 0.1.24
 Summary: Makea admin CLI (browser login + Makea admin HTTP API)
 Requires-Python: >=3.10
 Requires-Dist: httpx>=0.27
@@ -80,6 +80,8 @@ makea-cli auth --logout
 - `makea-cli create-user <email> --user-type "<type>" [--password ...] [--name ...] [--company-name ...] [--username ...]` — 注册用户并直接确认 Cognito 账号（POST `/admin/users/create`，不发验证码邮件，创建后即可用该密码登录）  
 - `makea-cli list-suppliers` — 列出供应商（需管理员权限）  
 - `makea-cli create-quote-request -s <supplier_id> -p <product_reference_id> [--quote-type SAMPLING|PRODUCTION] [--message ...] [--due-date YYYY-MM-DD]` — 创建并发送 quote request（POST `/admin/supplier/create_quote_request`）  
+- `makea-cli get-quote-requests [--product-id <product_id>] [--quote-request-id <id>]` — 列某个产品下的 quote requests，或读单条完整内容（GET `/admin/quote_requests`）  
+- `makea-cli update-quote-request <quote_request_id> [--stage SAMPLING] [--status PENDING_SUPPLIER] [--due-date YYYY-MM-DD | --clear-due-date]` — 改 quote request 的 stage / status / 截止日（PATCH `/admin/quote_requests/{id}/update`）。**代供应商报价前常常要先用它**：quote request 停在 ENGAGEMENT（供应商还没接单）时 `submit-supplier-quote` 会被拒；过了 due date 也会被拒  
 - `makea-cli get-quote-requests-by-supplier-id <supplier_id> [--status <status>] [-n <limit>]` — 直连后端按 supplier_id 查询 quote requests  
 - `makea-cli get-supplier-links-by-supplier-id <supplier_id> [--link-type SAMPLING|PRODUCTION]` — 直连后端按 supplier_id 查询 supplier links  
 - `makea-cli submit-supplier-quote <quote_request_id> --link-name ... --currency ... --sampling-price-value ... --sampling-price-valid-until ... --sample-lead-time ... --deliverables-json ... --customer-note ...` — 以 admin 身份代供应商向指定 quote request 新增 quote。大货阶梯价（`--production-price-tiers-json`）和 `--lead-time` 现在是可选的；样衣加做费、MOQ 口径、寄料地址（CMT / full package 打样报价必填）、可选尺码颜色、规格行、typed link 等字段见 `--help`。pricing groups 提交时给不进去，提交完用 `update-supplier-quote` 补  

{makea_cli-0.1.22 → makea_cli-0.1.24}/README.md

@@ -69,6 +69,8 @@ makea-cli auth --logout
 - `makea-cli create-user <email> --user-type "<type>" [--password ...] [--name ...] [--company-name ...] [--username ...]` — 注册用户并直接确认 Cognito 账号（POST `/admin/users/create`，不发验证码邮件，创建后即可用该密码登录）  
 - `makea-cli list-suppliers` — 列出供应商（需管理员权限）  
 - `makea-cli create-quote-request -s <supplier_id> -p <product_reference_id> [--quote-type SAMPLING|PRODUCTION] [--message ...] [--due-date YYYY-MM-DD]` — 创建并发送 quote request（POST `/admin/supplier/create_quote_request`）  
+- `makea-cli get-quote-requests [--product-id <product_id>] [--quote-request-id <id>]` — 列某个产品下的 quote requests，或读单条完整内容（GET `/admin/quote_requests`）  
+- `makea-cli update-quote-request <quote_request_id> [--stage SAMPLING] [--status PENDING_SUPPLIER] [--due-date YYYY-MM-DD | --clear-due-date]` — 改 quote request 的 stage / status / 截止日（PATCH `/admin/quote_requests/{id}/update`）。**代供应商报价前常常要先用它**：quote request 停在 ENGAGEMENT（供应商还没接单）时 `submit-supplier-quote` 会被拒；过了 due date 也会被拒  
 - `makea-cli get-quote-requests-by-supplier-id <supplier_id> [--status <status>] [-n <limit>]` — 直连后端按 supplier_id 查询 quote requests  
 - `makea-cli get-supplier-links-by-supplier-id <supplier_id> [--link-type SAMPLING|PRODUCTION]` — 直连后端按 supplier_id 查询 supplier links  
 - `makea-cli submit-supplier-quote <quote_request_id> --link-name ... --currency ... --sampling-price-value ... --sampling-price-valid-until ... --sample-lead-time ... --deliverables-json ... --customer-note ...` — 以 admin 身份代供应商向指定 quote request 新增 quote。大货阶梯价（`--production-price-tiers-json`）和 `--lead-time` 现在是可选的；样衣加做费、MOQ 口径、寄料地址（CMT / full package 打样报价必填）、可选尺码颜色、规格行、typed link 等字段见 `--help`。pricing groups 提交时给不进去，提交完用 `update-supplier-quote` 补  

makea_cli-0.1.24/makea_cli/__init__.py

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

{makea_cli-0.1.22 → makea_cli-0.1.24}/makea_cli/api_client.py

@@ -294,6 +294,25 @@ def get_quote_requests(*, product_id: str | None = None) -> Any:
     return get_json("/admin/quote_requests", params=params)
 
 
+def get_quote_request(*, quote_request_id: str) -> Any:
+    """
+    GET /admin/quote_requests/{quote_request_id} — one quote request in full.
+    """
+    return get_json(f"/admin/quote_requests/{quote_request_id}")
+
+
+def update_quote_request(
+    *,
+    quote_request_id: str,
+    body: dict[str, Any],
+) -> Any:
+    """
+    PATCH /admin/quote_requests/{quote_request_id}/update — set a quote request's
+    stage, status and/or due date. Only the keys present in ``body`` are applied.
+    """
+    return patch_json(f"/admin/quote_requests/{quote_request_id}/update", body)
+
+
 def create_quote_request(
     *,
     supplier_id: str,

{makea_cli-0.1.22 → makea_cli-0.1.24}/makea_cli/commands/supplier/cmd.py

@@ -22,6 +22,32 @@ def _normalize_add_supplier_body(raw: dict) -> dict:
 
 MOQ_APPLIES_TO_VALUES = ("style", "size", "color")
 
+# Mirrors garmentby_service.domain.QuoteRequest — kept here only so `--help` can
+# name the values; the backend is the one that validates.
+QUOTE_REQUEST_STAGES = ("ENGAGEMENT", "SAMPLING", "PRODUCTION")
+QUOTE_REQUEST_STATUSES = (
+    "PENDING_MERCHANT",
+    "PENDING_SUPPLIER",
+    "NEEDS_CLARIFICATION",
+    "COMPLETED",
+    "ORDER_PLACED",
+    "TERMINATED",
+    "RESAMPLE_QUOTE_REQUESTED",
+)
+PRODUCTION_FLOW_STATUSES = (
+    "PENDING_QUOTE",
+    "QUOTE_SUBMITTED",
+    "QUOTE_CONFIRMED",
+    "AWAITING_DEPOSIT",
+    "DEPOSIT_PAID",
+    "IN_PRODUCTION",
+    "AWAITING_FINAL_PAYMENT",
+    "FINAL_PAYMENT_PAID",
+    "SHIPPED",
+    "COMPLETED",
+    "CANCELLED",
+)
+
 
 def _parse_json_option(raw: str, option_name: str) -> object:
     """Parse a JSON-valued option, failing with the option's own name."""
@@ -61,6 +87,14 @@ def _validate_moq_applies_to(values: list[str]) -> list[str]:
     return [v for v in MOQ_APPLIES_TO_VALUES if v in set(normalized)]
 
 
+def _validate_choice(value: str, allowed: tuple[str, ...], option_name: str) -> str:
+    """Reject an out-of-range option before it costs a round trip."""
+    if value not in allowed:
+        console.print(f"[red]{option_name} must be one of {', '.join(allowed)}.[/red]")
+        raise typer.Exit(1)
+    return value
+
+
 def _none_if_null_literal(value: str) -> str | None:
     """Let an option clear a stored value by passing the literal `null`."""
     return None if value.strip().lower() in ("null", "none") else value
@@ -514,6 +548,124 @@ def register(app: typer.Typer) -> None:
             ),
         )
 
+    @app.command(
+        "get-quote-requests",
+        help=(
+            "GET /admin/quote_requests — list quote requests, optionally for one product. "
+            "Pass --quote-request-id to read a single one in full "
+            "(GET /admin/quote_requests/{id})."
+        ),
+    )
+    def get_quote_requests(
+        product_id: str | None = typer.Option(
+            None,
+            "--product-id",
+            "-p",
+            help="product_id: only quote requests on this product (product_reference_id).",
+        ),
+        quote_request_id: str | None = typer.Option(
+            None,
+            "--quote-request-id",
+            help="quote_request_id: read this one quote request in full instead of a list.",
+        ),
+    ) -> None:
+        """
+        List quote requests, or read one.
+        """
+        if quote_request_id:
+            print_json_or_exit(
+                console,
+                lambda: api_client.get_quote_request(quote_request_id=quote_request_id),
+            )
+            return
+        print_json_or_exit(
+            console,
+            lambda: api_client.get_quote_requests(product_id=product_id),
+        )
+
+    @app.command(
+        "update-quote-request",
+        help=(
+            "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 submit: submit-supplier-quote requires "
+            "stage SAMPLING or PRODUCTION, and a quote request sits in ENGAGEMENT "
+            "until the supplier accepts it."
+        ),
+    )
+    def update_quote_request(
+        quote_request_id: str = typer.Argument(
+            ...,
+            help="quote_request_id: the quote request to update.",
+        ),
+        stage: str | None = typer.Option(
+            None,
+            "--stage",
+            help=(
+                "current_stage: ENGAGEMENT (supplier has not accepted yet), SAMPLING or "
+                "PRODUCTION. Moving to SAMPLING/PRODUCTION by hand skips the supplier's "
+                "own acceptance, so accepted_at / terms_accepted_at stay empty."
+            ),
+        ),
+        status: str | None = typer.Option(
+            None,
+            "--status",
+            help=(
+                "status: for ENGAGEMENT/SAMPLING one of "
+                f"{', '.join(QUOTE_REQUEST_STATUSES)}; "
+                "for PRODUCTION one of "
+                f"{', '.join(PRODUCTION_FLOW_STATUSES)}. "
+                "The backend validates against whichever stage the request ends up in."
+            ),
+        ),
+        due_date: str | None = typer.Option(
+            None,
+            "--due-date",
+            help=(
+                "due_date: ISO date (YYYY-MM-DD). A quote request past its due date "
+                "cannot be quoted, so this is the other thing that blocks a submit."
+            ),
+        ),
+        clear_due_date: bool = typer.Option(
+            False,
+            "--clear-due-date",
+            help="Send due_date as null, leaving the quote request with no deadline.",
+        ),
+    ) -> None:
+        """
+        Update a quote request's stage, status and/or due date.
+        """
+        if due_date and clear_due_date:
+            console.print("[red]Pass either --due-date or --clear-due-date, not both.[/red]")
+            raise typer.Exit(1)
+
+        body: dict[str, object] = {}
+        if stage is not None:
+            body["current_stage"] = _validate_choice(
+                stage.strip().upper(), QUOTE_REQUEST_STAGES, "--stage"
+            )
+        if status is not None:
+            body["status"] = status.strip().upper()
+        if due_date:
+            body["due_date"] = due_date.strip()
+        elif clear_due_date:
+            body["due_date"] = None
+
+        if not body:
+            console.print(
+                "[red]Nothing to update: pass --stage, --status, --due-date or "
+                "--clear-due-date.[/red]"
+            )
+            raise typer.Exit(1)
+
+        print_json_or_exit(
+            console,
+            lambda: api_client.update_quote_request(
+                quote_request_id=quote_request_id,
+                body=body,
+            ),
+        )
+
     @app.command(
         "submit-supplier-quote",
         help=(
@@ -705,6 +857,17 @@ def register(app: typer.Typer) -> None:
             "--refundable-terms-json",
             help="refundable_terms: refundable terms (optional, JSON object/array string).",
         ),
+        ip_schedule_json: str | None = typer.Option(
+            None,
+            "--ip-schedule-json",
+            help=(
+                "ip_schedule: who owns each asset the job creates (optional, JSON object). "
+                "Omit when the factory did not state it — makea must not invent an answer "
+                "on its behalf. If supplied it has to be COMPLETE (every one of the 12 "
+                "assets answered, plus production location and subcontractors on a "
+                "PRODUCTION link) or the API returns 400 listing what is missing."
+            ),
+        ),
         resample_request_id: str | None = typer.Option(
             None,
             "--resample-request-id",
@@ -795,6 +958,8 @@ def register(app: typer.Typer) -> None:
             body["refundable_terms"] = _parse_json_option(
                 refundable_terms_json, "--refundable-terms-json"
             )
+        if ip_schedule_json is not None:
+            body["ip_schedule"] = _parse_json_option(ip_schedule_json, "--ip-schedule-json")
         if resample_request_id is not None:
             body["resample_request_id"] = resample_request_id
         if original_link_id is not None:
@@ -943,6 +1108,16 @@ def register(app: typer.Typer) -> None:
             "--refundable-terms-json",
             help="refundable_terms: refundable terms (JSON object; pass `null` to clear).",
         ),
+        ip_schedule_json: str | None = typer.Option(
+            None,
+            "--ip-schedule-json",
+            help=(
+                "ip_schedule: who owns each asset the job creates (JSON object; pass "
+                "`null` to clear). A supplied schedule must be COMPLETE — the API "
+                "refuses a half-answered one, so a quote can never carry a schedule "
+                "the factory could not have submitted itself."
+            ),
+        ),
         available_sizes_json: str | None = typer.Option(
             None,
             "--available-sizes-json",
@@ -1041,6 +1216,8 @@ def register(app: typer.Typer) -> None:
             override["one_time_production_fees"] = _parse_json_list_option(
                 one_time_production_fees_json, "--one-time-production-fees-json"
             )
+        if ip_schedule_json is not None:
+            override["ip_schedule"] = _parse_json_option(ip_schedule_json, "--ip-schedule-json")
         if refundable_terms_json is not None:
             override["refundable_terms"] = _parse_json_option(
                 refundable_terms_json, "--refundable-terms-json"

{makea_cli-0.1.22 → makea_cli-0.1.24}/pyproject.toml

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

makea_cli-0.1.22/makea_cli/__init__.py

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