makea-cli 0.2.30__tar.gz → 0.2.31__tar.gz

{makea_cli-0.2.30 → makea_cli-0.2.31}/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.2.31
+
+Beeboo files what a brand hands it in the chat (TECH-150).
+
+- `designer create pack-file --product <id> --document <document_id>` puts an
+  uploaded file on a tech pack section, named as `get tech-pack --readable`
+  shows it. A pattern file (DXF, RUL, PLT) goes on Patterns when no section is
+  named. A refusal lists the sections or rows that exist.
+- `designer get library-schema` and `designer create library-element` add a
+  fabric, trim or other part to the brand's library, with `--document` for a
+  photo or data sheet and `--draft` when required fields are still unknown.
+
 ## 0.2.30
 
 Read HP-GL plot files (.plt), the pattern or marker a CAD sends to a cutting

{makea_cli-0.2.30 → makea_cli-0.2.31}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: makea-cli
-Version: 0.2.30
+Version: 0.2.31
 Summary: Makea admin CLI (browser login + Makea admin HTTP API)
 Requires-Python: >=3.10
 Requires-Dist: click<9,>=8.1
@@ -199,7 +199,9 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 |---|---|---|---|---|
 | `makea-cli designer create checkout` | write（ask） | `POST /designer/payments/basket/create-session` | a Stripe checkout link for one or more charges. --key repeats: sampling:<sampling_order_id>, production:<production_o… | — |
 | `makea-cli designer create collection` | write（auto） | `POST /designer/collections/create` | create or update a designer collection. | `designer-create-collection` |
+| `makea-cli designer create library-element` | write（auto） | `POST /designer/library_components` | add a fabric, trim or other part to the brand's library; --document attaches a photo or data sheet, --draft when required fields are unknown. | — |
 | `makea-cli designer create note` | write（ask） | `POST /designer/products/{product_id}/notes` | post a message into a product's conversation. | — |
+| `makea-cli designer create pack-file` | write（auto） | `POST /designer/products/{product_id}/tech_spec/files` | put an uploaded file on a tech pack section; a pattern file (DXF, RUL, PLT) goes on Patterns when no section is named. | — |
 | `makea-cli designer create product` | write（ask） | `POST /designer/product/create_or_update_product` | payload must match manufacture/specifications (all frontend fields; categories/subcategories + collection_id in --hel… | `designer-upsert-product` |
 | `makea-cli designer create quote-award` | write（ask） | `POST /designer/quotes/group_pay_prepare` | choose the supplier quote to sample with. --quote is the supplier link id from `designer list supplier-link`; repeat … | — |
 | `makea-cli designer create rfq` | write（ask） | `POST /designer/product/send_rfq` | ask the chosen suppliers to quote on a product. --supplier repeats; --makea-sourcing also asks Makea to source. | — |
@@ -209,6 +211,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli designer download document` | read | `GET /designer/document/download` | save bytes for user_id + document_id (designer-authenticated; same query contract as admin document download). | `designer-download-document` |
 | `makea-cli designer get file` | read | local (makea_cli.file_reader) | read a pattern (DXF/RUL/PLT), artwork (AI/EPS/PSD/SVG), embroidery (PES/DST/EMB), ZIP or AVIF/TIFF file on this machine; saves PNG pictures of what it draws next to it. No API call. | — |
 | `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 library-schema` | read | `GET /designer/library_components/schema` | the library's sections and each one's field keys, options and required fields. | — |
 | `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-0.2.30 → makea_cli-0.2.31}/README.md

@@ -183,7 +183,9 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 |---|---|---|---|---|
 | `makea-cli designer create checkout` | write（ask） | `POST /designer/payments/basket/create-session` | a Stripe checkout link for one or more charges. --key repeats: sampling:<sampling_order_id>, production:<production_o… | — |
 | `makea-cli designer create collection` | write（auto） | `POST /designer/collections/create` | create or update a designer collection. | `designer-create-collection` |
+| `makea-cli designer create library-element` | write（auto） | `POST /designer/library_components` | add a fabric, trim or other part to the brand's library; --document attaches a photo or data sheet, --draft when required fields are unknown. | — |
 | `makea-cli designer create note` | write（ask） | `POST /designer/products/{product_id}/notes` | post a message into a product's conversation. | — |
+| `makea-cli designer create pack-file` | write（auto） | `POST /designer/products/{product_id}/tech_spec/files` | put an uploaded file on a tech pack section; a pattern file (DXF, RUL, PLT) goes on Patterns when no section is named. | — |
 | `makea-cli designer create product` | write（ask） | `POST /designer/product/create_or_update_product` | payload must match manufacture/specifications (all frontend fields; categories/subcategories + collection_id in --hel… | `designer-upsert-product` |
 | `makea-cli designer create quote-award` | write（ask） | `POST /designer/quotes/group_pay_prepare` | choose the supplier quote to sample with. --quote is the supplier link id from `designer list supplier-link`; repeat … | — |
 | `makea-cli designer create rfq` | write（ask） | `POST /designer/product/send_rfq` | ask the chosen suppliers to quote on a product. --supplier repeats; --makea-sourcing also asks Makea to source. | — |
@@ -193,6 +195,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli designer download document` | read | `GET /designer/document/download` | save bytes for user_id + document_id (designer-authenticated; same query contract as admin document download). | `designer-download-document` |
 | `makea-cli designer get file` | read | local (makea_cli.file_reader) | read a pattern (DXF/RUL/PLT), artwork (AI/EPS/PSD/SVG), embroidery (PES/DST/EMB), ZIP or AVIF/TIFF file on this machine; saves PNG pictures of what it draws next to it. No API call. | — |
 | `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 library-schema` | read | `GET /designer/library_components/schema` | the library's sections and each one's field keys, options and required fields. | — |
 | `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-0.2.31/makea_cli/__init__.py

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

{makea_cli-0.2.30 → makea_cli-0.2.31}/makea_cli/api_client.py

@@ -1871,6 +1871,21 @@ def designer_create_proposals(product_id: str, proposals: list[dict[str, Any]])
     )
 
 
+def designer_create_pack_file(product_id: str, body: dict[str, Any]) -> Any:
+    """POST /designer/products/{id}/tech_spec/files — put an uploaded file on a pack section."""
+    return post_json(f"/designer/products/{product_id}/tech_spec/files", body)
+
+
+def designer_library_schema() -> Any:
+    """GET /designer/library_components/schema — library sections and their field keys."""
+    return get_json("/designer/library_components/schema")
+
+
+def designer_create_library_component(body: dict[str, Any]) -> Any:
+    """POST /designer/library_components — {section, name?, values, document_ids?, draft?}."""
+    return post_json("/designer/library_components", body)
+
+
 def designer_bulk_accept_actions(channel_id: str, actions: list[dict[str, str]]) -> Any:
     """POST /designer/channels/{id}/suggested_actions/bulk_accept — accept several at once."""
     return post_json(

{makea_cli-0.2.30 → makea_cli-0.2.31}/makea_cli/commands/brand/cmd.py

@@ -750,6 +750,121 @@ def register(app: typer.Typer) -> None:
             items = [{k: v for k, v in one.items() if v is not None}]
         print_json_or_exit(console, lambda: api_client.designer_create_proposals(product, items))
 
+    @command(
+        app,
+        "designer",
+        "create",
+        "pack-file",
+        api="POST /designer/products/{product_id}/tech_spec/files",
+        side_effects=["adds the file to the tech pack section and to the product's documents"],
+        approval="auto",
+        help=(
+            "POST /designer/products/{id}/tech_spec/files — put a file the user uploaded (a "
+            "document_id) on a tech pack section. Pattern files (DXF, RUL, PLT, AAMA/ASTM) go "
+            "on Patterns, which is the default for them. Name the section as `get tech-pack "
+            '--readable` shows it ("Patterns", "Main fabric", "Additional notes"); pick a row '
+            "with --item or --entry. A refusal lists the sections that exist."
+        ),
+    )
+    def create_pack_file(
+        product: str = typer.Option(..., "--product", "-p", help="Product id."),
+        document: list[str] = typer.Option(
+            ..., "--document", "-d", help="document_id of the uploaded file (repeat)."
+        ),
+        section: str | None = typer.Option(
+            None,
+            "--section",
+            help="Section, by label or key. Omit for a pattern file (goes on Patterns).",
+        ),
+        entry: int | None = typer.Option(
+            None, "--entry", help="Row number in a repeating section, 0 = first."
+        ),
+        item: str | None = typer.Option(
+            None, "--item", help='Pick the row that holds this value now (e.g. "silk crepe").'
+        ),
+    ) -> None:
+        """Put uploaded files on a tech pack section."""
+        body: dict[str, Any] = {"document_ids": list(document)}
+        if section:
+            body["section"] = section
+        if entry is not None:
+            body["entry"] = entry
+        if item:
+            body["item"] = item
+        print_json_or_exit(console, lambda: api_client.designer_create_pack_file(product, body))
+
+    @command(
+        app,
+        "designer",
+        "get",
+        "library-schema",
+        api="GET /designer/library_components/schema",
+        help=(
+            "GET /designer/library_components/schema — the library's sections (fabrics, trims, "
+            "colours…) and, for each, its field keys, labels, options and which are required. "
+            "Read it before `create library-element`."
+        ),
+    )
+    def get_library_schema() -> None:
+        """Print the library sections and their fields."""
+        print_json_or_exit(console, api_client.designer_library_schema)
+
+    @command(
+        app,
+        "designer",
+        "create",
+        "library-element",
+        api="POST /designer/library_components",
+        side_effects=["adds the element to the brand's library, shared with their team"],
+        approval="auto",
+        help=(
+            "POST /designer/library_components — add a fabric, trim or other part to the brand's "
+            "library. --section and the --values keys come from `get library-schema`. --document "
+            "attaches an uploaded photo or data sheet. When required fields are unknown, pass "
+            "--draft: it is saved as a draft for the brand to finish."
+        ),
+    )
+    def create_library_element(
+        section: str = typer.Option(..., "--section", "-s", help="Section key, e.g. MAIN_FABRIC."),
+        values: str | None = typer.Option(
+            None, "--values", help="JSON object of {field key: value} from get library-schema."
+        ),
+        values_file: Path | None = typer.Option(
+            None,
+            "--values-file",
+            "-f",
+            exists=True,
+            dir_okay=False,
+            help="JSON file holding the values object (instead of --values).",
+        ),
+        name: str | None = typer.Option(
+            None, "--name", "-n", help="Display name (defaults to the name field)."
+        ),
+        document: list[str] = typer.Option(
+            [], "--document", "-d", help="document_id of a photo or data sheet (repeat)."
+        ),
+        product: str | None = typer.Option(
+            None, "--product", "-p", help="The product it was made for, if any."
+        ),
+        draft: bool = typer.Option(
+            False, "--draft", help="Save as a draft when required fields are still unknown."
+        ),
+    ) -> None:
+        """Add an element to the brand's library."""
+        body: dict[str, Any] = {
+            "section": section,
+            "values": _json_object(values, values_file, "values"),
+        }
+        if name:
+            body["name"] = name
+        if document:
+            body["document_ids"] = list(document)
+        if product:
+            body["product_reference_id"] = product
+        if draft:
+            body["draft"] = True
+        print_json_or_exit(console, lambda: api_client.designer_create_library_component(body))
+
     @command(
         app,
         "designer",

{makea_cli-0.2.30 → makea_cli-0.2.31}/pyproject.toml

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

{makea_cli-0.2.30 → makea_cli-0.2.31}/tests/golden_manifest.json

@@ -8290,6 +8290,116 @@
         }
       ]
     },
+    {
+      "name": "designer create library-element",
+      "persona": "designer",
+      "verb": "create",
+      "noun": "library-element",
+      "access": "write",
+      "api": "POST /designer/library_components",
+      "external": null,
+      "side_effects": [
+        "adds the element to the brand's library, shared with their team"
+      ],
+      "approval": "auto",
+      "reversible": null,
+      "idempotent": null,
+      "limit": null,
+      "legacy": [],
+      "help": "POST /designer/library_components — add a fabric, trim or other part to the brand's library. --section and the --values keys come from `get library-schema`. --document attaches an uploaded photo or data sheet. When required fields are unknown, pass --draft: it is saved as a draft for the brand to finish.",
+      "function": "makea_cli.commands.brand.cmd.register.<locals>.create_library_element",
+      "flags": [
+        {
+          "name": "section",
+          "kind": "option",
+          "opts": [
+            "--section",
+            "-s"
+          ],
+          "type": "text",
+          "required": true,
+          "multiple": false,
+          "default": null,
+          "help": "Section key, e.g. MAIN_FABRIC."
+        },
+        {
+          "name": "values",
+          "kind": "option",
+          "opts": [
+            "--values"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "JSON object of {field key: value} from get library-schema."
+        },
+        {
+          "name": "values_file",
+          "kind": "option",
+          "opts": [
+            "--values-file",
+            "-f"
+          ],
+          "type": "file",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "JSON file holding the values object (instead of --values)."
+        },
+        {
+          "name": "name",
+          "kind": "option",
+          "opts": [
+            "--name",
+            "-n"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "Display name (defaults to the name field)."
+        },
+        {
+          "name": "document",
+          "kind": "option",
+          "opts": [
+            "--document",
+            "-d"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": true,
+          "default": [],
+          "help": "document_id of a photo or data sheet (repeat)."
+        },
+        {
+          "name": "product",
+          "kind": "option",
+          "opts": [
+            "--product",
+            "-p"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "The product it was made for, if any."
+        },
+        {
+          "name": "draft",
+          "kind": "option",
+          "opts": [
+            "--draft"
+          ],
+          "type": "flag",
+          "required": false,
+          "multiple": false,
+          "default": false,
+          "help": "Save as a draft when required fields are still unknown."
+        }
+      ]
+    },
     {
       "name": "designer create note",
       "persona": "designer",
@@ -8348,6 +8458,89 @@
         }
       ]
     },
+    {
+      "name": "designer create pack-file",
+      "persona": "designer",
+      "verb": "create",
+      "noun": "pack-file",
+      "access": "write",
+      "api": "POST /designer/products/{product_id}/tech_spec/files",
+      "external": null,
+      "side_effects": [
+        "adds the file to the tech pack section and to the product's documents"
+      ],
+      "approval": "auto",
+      "reversible": null,
+      "idempotent": null,
+      "limit": null,
+      "legacy": [],
+      "help": "POST /designer/products/{id}/tech_spec/files — put a file the user uploaded (a document_id) on a tech pack section. Pattern files (DXF, RUL, PLT, AAMA/ASTM) go on Patterns, which is the default for them. Name the section as `get tech-pack --readable` shows it (\"Patterns\", \"Main fabric\", \"Additional notes\"); pick a row with --item or --entry. A refusal lists the sections that exist.",
+      "function": "makea_cli.commands.brand.cmd.register.<locals>.create_pack_file",
+      "flags": [
+        {
+          "name": "product",
+          "kind": "option",
+          "opts": [
+            "--product",
+            "-p"
+          ],
+          "type": "text",
+          "required": true,
+          "multiple": false,
+          "default": null,
+          "help": "Product id."
+        },
+        {
+          "name": "document",
+          "kind": "option",
+          "opts": [
+            "--document",
+            "-d"
+          ],
+          "type": "text",
+          "required": true,
+          "multiple": true,
+          "default": null,
+          "help": "document_id of the uploaded file (repeat)."
+        },
+        {
+          "name": "section",
+          "kind": "option",
+          "opts": [
+            "--section"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "Section, by label or key. Omit for a pattern file (goes on Patterns)."
+        },
+        {
+          "name": "entry",
+          "kind": "option",
+          "opts": [
+            "--entry"
+          ],
+          "type": "integer",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "Row number in a repeating section, 0 = first."
+        },
+        {
+          "name": "item",
+          "kind": "option",
+          "opts": [
+            "--item"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "Pick the row that holds this value now (e.g. \"silk crepe\")."
+        }
+      ]
+    },
     {
       "name": "designer create product",
       "persona": "designer",
@@ -9046,6 +9239,24 @@
         }
       ]
     },
+    {
+      "name": "designer get library-schema",
+      "persona": "designer",
+      "verb": "get",
+      "noun": "library-schema",
+      "access": "read",
+      "api": "GET /designer/library_components/schema",
+      "external": null,
+      "side_effects": [],
+      "approval": "auto",
+      "reversible": null,
+      "idempotent": null,
+      "limit": null,
+      "legacy": [],
+      "help": "GET /designer/library_components/schema — the library's sections (fabrics, trims, colours…) and, for each, its field keys, labels, options and which are required. Read it before `create library-element`.",
+      "function": "makea_cli.commands.brand.cmd.register.<locals>.get_library_schema",
+      "flags": []
+    },
     {
       "name": "designer get lifecycle",
       "persona": "designer",

makea_cli-0.2.30/makea_cli/__init__.py

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