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

makea_cli-0.1.11/.gitignore

@@ -0,0 +1,24 @@
+.DS_Store
+.venv/
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.mypy_cache/
+dist/
+*.egg-info/
+
+# Local credentials dumped by the makea-collection-upload skill workflow —
+# the skill writes Makea JWTs here to pass into the Claude Code sandbox.
+# Must never be committed.
+creds_*.json
+
+# Packaged skill bundles (zip). Sources live under .claude/skills/ or
+# co-located dirs (e.g. makea-collection-upload/); the .skill artifact is a
+# build output meant for distribution, not for the repo.
+*.skill
+
+# Claude Code per-session git worktrees.
+.claude/worktrees/
+
+# Random-name temp drop from sandbox uploads (e.g. zi1zLQLi).
+zi1zLQLi

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

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

makea_cli-0.1.11/makea-collection-upload/SKILL.md

@@ -0,0 +1,296 @@
+---
+name: makea-collection-upload
+description: >
+  Uploads a fashion collection PDF (tech pack) to Makea, creating a collection
+  and individual SKU products from the document. Use this skill whenever the
+  user uploads or references a collection PDF and wants to create products in
+  Makea — e.g. "这是我的collection，帮我上传到makea", "create products from
+  this tech pack", "建立这个collection的sku", "upload collection to makea",
+  or any request combining a PDF/document with creating products or a
+  collection in the Makea platform. Also triggers when the user says things
+  like "帮我建sku", "add this to makea", or "create a new collection" with
+  an attached file.
+---
+
+# Makea Collection Upload Skill
+
+This skill turns a collection tech pack PDF into a full set of Makea designer
+products — one per SKU — each attached to a collection, with documents uploaded.
+**All products are created in DRAFT status** — the user reviews and submits
+each one on the Makea platform afterwards.
+
+The workflow has four stages: **Auth → Analyze → Collection → Products → Review reminder**.
+Always follow them in order. Never skip user confirmation steps.
+
+---
+
+## Prerequisites
+
+Before starting, ensure `makea-cli` is installed and credentials are available
+in the sandbox. If in doubt, invoke the `makea-cli-setup` skill first.
+
+To load credentials into the sandbox, ask the user to run this in Terminal
+(copy it to their clipboard via computer-use):
+```
+cat ~/Library/Application\ Support/makea-cli/credentials.json > ~/workspace/gby/makea-cli/creds_temp.json
+```
+Then read the file at the workspace path and copy it to the sandbox config:
+```bash
+mkdir -p ~/.config/makea-cli
+cp /sessions/.../mnt/makea-cli/creds_temp.json ~/.config/makea-cli/credentials.json
+```
+Decode the JWT `sub` field for `USER_ID`. Verify the token has at least
+~10 min remaining (`saved_at + expires_in - now()`). Remind the user to
+delete `creds_temp.json` from the workspace after the session.
+
+Install Python deps if needed:
+```bash
+pip install makea-cli pdfplumber pypdf --break-system-packages -q
+pip install --upgrade makea-cli --break-system-packages -q
+```
+
+**CLI binary**: `~/.local/bin/makea-cli`
+
+---
+
+## Stage 1 — Analyze the PDF
+
+Use `pdfplumber` to extract text page by page. For each page that contains
+product specs (look for fields like "Style:", "Class:", "Category:", "MATERIALS",
+"TRIMS", "COLOR PALETTE"), identify it as a new SKU.
+
+A typical tech pack structure is:
+- 1–2 intro/cover pages (skip)
+- Then repeating groups of 2–3 pages per SKU: spec page → reference image pages
+
+For each SKU, extract:
+- **Name**: derive from Style + category (e.g. "Crew Neck Mid Sleeve Top")
+- **Category**: map to a Makea category (see valid values below)
+- **Materials**: from the MATERIALS section
+- **Colors**: from COLOR PALETTE
+- **Size range**: from "Size range:" field
+- **Sample size**: from "Sample Size:" field
+- **Page range**: which pages belong to this SKU (for PDF extraction)
+
+Present a summary table to the user before proceeding, e.g.:
+```
+Found 11 SKUs:
+ 1. Crew Neck Mid Sleeve Top   | Clothing | pages 3–5  | S/M/L
+ 2. Double Layer Shirt         | Clothing | pages 6–8  | S/M/L
+ ...
+```
+Ask the user to confirm the SKU list is correct before continuing.
+
+---
+
+## Stage 2 — Collection Info
+
+Ask the user to confirm the collection details **before** creating it:
+
+- **Name**: e.g. "nAia 01: Becoming" (from cover page or user input)
+- **Season**: e.g. "Drop 1", "SS2026"
+- **Description**: brief summary (optional)
+
+Show a confirmation block:
+```
+Collection to create:
+  Name:        nAia 01: Becoming
+  Season:      Drop 1
+  Description: Drop 1 - nAia 01: Becoming collection
+
+Confirm? (yes to proceed)
+```
+
+Only call `designer-create-collection` after explicit confirmation:
+```bash
+makea-cli designer-create-collection "nAia 01: Becoming" \
+  --season "Drop 1" \
+  --description "Drop 1 - nAia 01: Becoming collection"
+```
+Save the returned `collection_id` — you'll use it for every product.
+
+---
+
+## Stage 3 — Product Details Confirmation
+
+Before creating any products, gather the fields that apply to **all** SKUs in
+this collection (ask once, reuse for each):
+
+**Required fields to confirm with user:**
+- `contact_name` — designer/owner name
+- `contact_email` — contact email
+- `contact_phone` — digits only, 10–15 digits after stripping separators
+- `shipping_address` — street, city, state, postal_code, country (all non-empty)
+- `minimum_unit_requested` — MOQ integer > 0
+- `bulk_production_size_count` — bulk integer > 0
+- `grading_required` — yes/no
+- `has_sampling` — yes/no
+- `sampling_size_mode` — "manual" or "from_documents"
+
+Use `AskUserQuestion` for structured choices (MOQ, grading, sampling).
+Ask for free-text fields (phone, address) in a single message.
+
+**Valid `product_category` values** (use exactly these strings):
+- `Clothing` — for all apparel (tops, bottoms, dresses, outerwear, etc.)
+- `Soft Accessories` — scarves, hats, gloves, belts, fabric bags
+- `Hard Accessories` — jewelry, eyewear, structured handbags, etc.
+- `Packaging` — primary, secondary, transit packaging
+- `Merch` — branded apparel, lifestyle items, limited edition
+
+For `Clothing`, set `product_subcategory` to `null` (no subcategory in UI).
+
+---
+
+## Stage 4 — Create Each Product
+
+Process SKUs **one at a time** in order. For each SKU:
+
+### 4a — Show per-SKU confirmation
+
+Display a confirmation block with all fields before touching the API:
+
+```
+─────────────────────────────────────────
+SKU 1/11: Crew Neck Mid Sleeve Top
+─────────────────────────────────────────
+Category:    Clothing
+Description: Vegan microsuede, 95% Polyester 5% Spandex...
+Sampling:    Yes  |  Grading: Yes
+Sizes:       manual → ["S","M","L"]
+MOQ: 50  |  Bulk: 200
+Contact:     Beeboo | support@makea.co | 6081231231
+Address:     1201 NW A Street, Seattle, WA 98105, US
+Services:    [] (DRAFT — no requests)
+Attachment:  pages 3–5 extracted as tech pack PDF
+Collection:  nAia 01: Becoming (linked after creation)
+─────────────────────────────────────────
+Submit this product? (yes / skip / edit)
+```
+
+Only proceed after the user confirms. Respect "skip" to skip that SKU,
+"edit" to let the user correct specific fields.
+
+### 4b — Extract PDF pages
+
+```python
+from pypdf import PdfReader, PdfWriter
+reader = PdfReader(pdf_path)
+writer = PdfWriter()
+for p in range(page_start - 1, page_end):   # 0-indexed
+    writer.add_page(reader.pages[p])
+with open(sku_pdf_path, "wb") as f:
+    writer.write(f)
+```
+
+### 4c — Upload document
+
+```bash
+makea-cli designer-upload-document \
+  --file <sku_pdf_path> \
+  --doc-type TECH_PACK
+```
+
+Save `product_id` and `documents[0]` from the response.
+
+### 4d — Create product (DRAFT, no collection)
+
+Build the JSON payload:
+```json
+{
+  "user_id": "<USER_ID>",
+  "product_id": "<from upload response>",
+  "display_name": "<SKU name>",
+  "product_category": "Clothing",
+  "product_subcategory": null,
+  "description": "<materials + colors summary>",
+  "has_sampling": true,
+  "grading_required": true,
+  "minimum_unit_requested": 50,
+  "bulk_production_size_count": 200,
+  "sampling_size_mode": "manual",
+  "sampling_sizes": ["S", "M", "L"],
+  "contact_name": "<name>",
+  "contact_email": "<email>",
+  "contact_phone": "<digits only>",
+  "shipping_address": {
+    "street": "...", "city": "...", "state": "...",
+    "postal_code": "...", "country": "..."
+  },
+  "requests": [],
+  "available_documents": [<doc_meta from upload>]
+}
+```
+
+**Critical rules — DRAFT is the goal, not a side effect:**
+- `requests: []` — an empty requests list is what keeps the product in DRAFT.
+  Never add service requests here; that's the designer's job on the platform.
+- Do NOT include `collection_id` in this payload — link separately in step 4e.
+- `contact_phone`: strip all non-digit characters before sending.
+- `sampling_size_mode` is required — always include it.
+- Do NOT pass `--allow-auto-submit` — this flag would promote DRAFT to IN_REVIEW
+  automatically, which defeats the purpose of letting the designer review first.
+
+```bash
+makea-cli designer-upsert-product --file <payload.json>
+```
+
+Verify the response shows `"status": "DRAFT"` and `available_documents` is non-empty.
+
+### 4e — Link product to collection
+
+```bash
+makea-cli designer-link-product-to-collection \
+  <product_id> <collection_id>
+```
+
+### 4f — Report progress
+
+After each product:
+```
+✓ [3/11] Asymmetrical Waist Pants
+         product_id: d08a2852-...
+         status: DRAFT | docs: 1 | collection: linked
+```
+
+---
+
+## Stage 5 — Final Summary & Review Reminder
+
+After all SKUs are processed, show a summary table:
+
+```
+Collection: nAia 01: Becoming (f7e16e39-...)
+─────────────────────────────────────────────────
+ ✓  1. Crew Neck Mid Sleeve Top       DRAFT  1 doc
+ ✓  2. Double Layer Shirt             DRAFT  1 doc
+ ...
+ ✗  6. Skirt                          SKIPPED
+─────────────────────────────────────────────────
+11 SKUs processed: 10 created, 1 skipped
+```
+
+Then **always** end with this reminder — do not skip it:
+
+```
+🎉 All products have been created in DRAFT status.
+
+Next step — review & submit on Makea:
+  1. Go to app.makea.co → your collection "nAia 01: Becoming"
+  2. Open each product and verify the details look correct
+  3. Add the services you need (Manufacturing, Sourcing, etc.)
+  4. Click Submit to send each product for review
+
+Products stay in DRAFT until you submit them — nothing is sent to
+suppliers or the Makea team yet.
+```
+
+Also remind the user to delete `creds_temp.json` from the workspace if it's still there.
+
+---
+
+## Error Handling
+
+- **Token expired mid-run**: stop, ask user to re-auth, copy fresh credentials, resume.
+- **Upload fails**: log the error, ask user whether to retry or skip.
+- **Upsert returns IN_REVIEW unexpectedly**: this means `requests` was non-empty — check the payload. Do not proceed; fix the payload and retry.
+- **Collection link fails**: log it, note the product_id so the user can link manually via the app.

makea_cli-0.1.11/makea-collection-upload/scripts/create_products.py

@@ -0,0 +1,236 @@
+"""
+create_products.py — helper for makea-collection-upload skill.
+
+Usage:
+    python create_products.py --skus skus.json --pdf <path> --collection-id <id> \
+        --user-id <id> --contact-name <name> --contact-email <email> \
+        --contact-phone <phone> --street <s> --city <c> --state <s> \
+        --postal-code <z> --country <co> --moq <n> --bulk <n> \
+        [--grading] [--no-sampling]
+
+skus.json format:
+[
+  {
+    "name": "Crew Neck Mid Sleeve Top",
+    "category": "Clothing",
+    "description": "Vegan microsuede...",
+    "page_start": 3,
+    "page_end": 5,
+    "sampling_sizes": ["S","M","L"]
+  },
+  ...
+]
+
+Outputs one line per product: JSON with product_id, name, status, collection_linked.
+"""
+
+import argparse
+import json
+import os
+import re
+import subprocess
+import sys
+import tempfile
+from pathlib import Path
+
+from pypdf import PdfReader, PdfWriter
+
+CLI = Path.home() / ".local/bin/makea-cli"
+
+
+def extract_pages(pdf_path: str, page_start: int, page_end: int, out_path: str) -> None:
+    reader = PdfReader(pdf_path)
+    writer = PdfWriter()
+    for p in range(page_start - 1, page_end):  # convert to 0-indexed
+        writer.add_page(reader.pages[p])
+    with open(out_path, "wb") as f:
+        writer.write(f)
+
+
+def run_cli(args: list[str]) -> dict:
+    r = subprocess.run([str(CLI)] + args, capture_output=True, text=True)
+    if r.returncode != 0:
+        raise RuntimeError(f"CLI error: {r.stderr.strip() or r.stdout.strip()}")
+    return json.loads(r.stdout)
+
+
+def digits_only(phone: str) -> str:
+    """Strip non-digit chars; validated length 10–15."""
+    d = re.sub(r"\D", "", phone)
+    if not (10 <= len(d) <= 15):
+        raise ValueError(f"Phone '{phone}' → '{d}' is not 10–15 digits after stripping.")
+    return d
+
+
+def create_product(
+    *,
+    user_id: str,
+    sku: dict,
+    pdf_path: str,
+    collection_id: str,
+    contact_name: str,
+    contact_email: str,
+    contact_phone: str,
+    shipping_address: dict,
+    moq: int,
+    bulk: int,
+    grading_required: bool,
+    has_sampling: bool,
+) -> dict:
+    name = sku["name"]
+    page_start = sku["page_start"]
+    page_end = sku["page_end"]
+    sampling_sizes = sku.get("sampling_sizes", ["S", "M", "L"])
+
+    # 1. Extract PDF pages
+    with tempfile.NamedTemporaryFile(suffix=".pdf", delete=False) as tf:
+        sku_pdf = tf.name
+    extract_pages(pdf_path, page_start, page_end, sku_pdf)
+
+    try:
+        # 2. Upload document
+        upload_resp = run_cli(
+            [
+                "designer-upload-document",
+                "--file",
+                sku_pdf,
+                "--doc-type",
+                "TECH_PACK",
+            ]
+        )
+        product_id = upload_resp["product_id"]
+        doc_meta = upload_resp["documents"][0]
+
+        # 3. Build product payload — NO collection_id, requests=[]
+        payload = {
+            "user_id": user_id,
+            "product_id": product_id,
+            "display_name": name,
+            "product_category": sku.get("category", "Clothing"),
+            "product_subcategory": None,
+            "description": sku.get("description", ""),
+            "has_sampling": has_sampling,
+            "grading_required": grading_required,
+            "minimum_unit_requested": moq,
+            "bulk_production_size_count": bulk,
+            "sampling_size_mode": "manual",
+            "sampling_sizes": sampling_sizes,
+            "contact_name": contact_name,
+            "contact_email": contact_email,
+            "contact_phone": contact_phone,
+            "shipping_address": shipping_address,
+            "requests": [],  # MUST be empty to stay DRAFT
+            "available_documents": [doc_meta],
+        }
+
+        with tempfile.NamedTemporaryFile(mode="w", suffix=".json", delete=False) as pf:
+            json.dump(payload, pf)
+            payload_path = pf.name
+
+        try:
+            upsert_resp = run_cli(["designer-upsert-product", "--file", payload_path])
+        finally:
+            os.unlink(payload_path)
+
+        product = upsert_resp.get("product", {})
+        if product.get("status") != "DRAFT":
+            raise RuntimeError(
+                f"Expected DRAFT but got {product.get('status')} — check that requests is empty."
+            )
+
+        # 4. Link to collection
+        link_resp = run_cli(
+            [
+                "designer-link-product-to-collection",
+                product_id,
+                collection_id,
+            ]
+        )
+
+        return {
+            "name": name,
+            "product_id": product_id,
+            "status": product.get("status"),
+            "documents": len(product.get("available_documents", [])),
+            "collection_linked": link_resp.get("success", False),
+            "error": None,
+        }
+
+    except Exception as exc:
+        return {
+            "name": name,
+            "product_id": None,
+            "status": "ERROR",
+            "documents": 0,
+            "collection_linked": False,
+            "error": str(exc),
+        }
+    finally:
+        if os.path.exists(sku_pdf):
+            os.unlink(sku_pdf)
+
+
+def main() -> None:
+    p = argparse.ArgumentParser(description="Batch-create Makea products from a SKU list.")
+    p.add_argument("--skus", required=True, help="Path to skus.json")
+    p.add_argument("--pdf", required=True, help="Path to collection PDF")
+    p.add_argument("--collection-id", required=True)
+    p.add_argument("--user-id", required=True)
+    p.add_argument("--contact-name", required=True)
+    p.add_argument("--contact-email", required=True)
+    p.add_argument("--contact-phone", required=True)
+    p.add_argument("--street", required=True)
+    p.add_argument("--city", required=True)
+    p.add_argument("--state", required=True)
+    p.add_argument("--postal-code", required=True)
+    p.add_argument("--country", required=True)
+    p.add_argument("--moq", type=int, default=50)
+    p.add_argument("--bulk", type=int, default=200)
+    p.add_argument("--grading", action="store_true", default=True)
+    p.add_argument("--no-grading", dest="grading", action="store_false")
+    p.add_argument("--no-sampling", dest="sampling", action="store_false")
+    p.add_argument("--sampling", action="store_true", default=True)
+    args = p.parse_args()
+
+    skus = json.loads(Path(args.skus).read_text())
+    contact_phone = digits_only(args.contact_phone)
+    shipping_address = {
+        "street": args.street,
+        "city": args.city,
+        "state": args.state,
+        "postal_code": args.postal_code,
+        "country": args.country,
+    }
+
+    results = []
+    total = len(skus)
+    for i, sku in enumerate(skus, 1):
+        print(f"[{i}/{total}] {sku['name']} ...", file=sys.stderr)
+        result = create_product(
+            user_id=args.user_id,
+            sku=sku,
+            pdf_path=args.pdf,
+            collection_id=args.collection_id,
+            contact_name=args.contact_name,
+            contact_email=args.contact_email,
+            contact_phone=contact_phone,
+            shipping_address=shipping_address,
+            moq=args.moq,
+            bulk=args.bulk,
+            grading_required=args.grading,
+            has_sampling=args.sampling,
+        )
+        results.append(result)
+        icon = "✓" if result["error"] is None else "✗"
+        print(
+            f"  {icon} {result['name']} | {result['status']} | "
+            f"docs={result['documents']} | linked={result['collection_linked']}"
+            + (f" | ERROR: {result['error']}" if result["error"] else ""),
+            file=sys.stderr,
+        )
+
+    print(json.dumps(results, indent=2))
+
+
+if __name__ == "__main__":
+    main()

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

@@ -179,6 +179,11 @@ def get_all_users(*, limit: int | None, offset: int) -> Any:
     return get_json("/admin/users", params=params)
 
 
+def update_user_profile(*, user_id: str, body: dict[str, Any]) -> Any:
+    """PUT /admin/user-profiles/{user_id}/update — admin updates DDB profile + Cognito userType."""
+    return put_json(f"/admin/user-profiles/{user_id}/update", body)
+
+
 def get_all_suppliers() -> Any:
     return get_json("/admin/supplier/get_all_suppliers")
 
@@ -567,6 +572,23 @@ def get_all_production_orders(
     return get_json("/admin/production_orders", params=params)
 
 
+def get_all_shipping_orders(
+    *,
+    limit: int | None,
+    offset: int,
+) -> Any:
+    """GET /admin/shipping_orders — admin global shipping order list."""
+    params: dict[str, Any] = {"offset": offset}
+    if limit is not None:
+        params["limit"] = limit
+    return get_json("/admin/shipping_orders", params=params)
+
+
+def get_misc_payments_by_product(product_id: str) -> Any:
+    """GET /admin/products/{product_id}/misc-payments — misc payments for one product."""
+    return get_json(f"/admin/products/{product_id}/misc-payments")
+
+
 def get_sampling_orders_by_product(product_reference_id: str) -> Any:
     return get_json(f"/admin/products/{product_reference_id}/sampling_orders")