flowbase-cli 0.1.4__tar.gz → 0.1.6__tar.gz

{flowbase_cli-0.1.4 → flowbase_cli-0.1.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flowbase-cli
-Version: 0.1.4
+Version: 0.1.6
 Summary: Command line client for the FlowBase OpenAPI
 Author: DeepFlowAI
 License: Apache-2.0

{flowbase_cli-0.1.4 → flowbase_cli-0.1.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "flowbase-cli"
-version = "0.1.4"
+version = "0.1.6"
 description = "Command line client for the FlowBase OpenAPI"
 readme = "README.md"
 requires-python = ">=3.11"

{flowbase_cli-0.1.4 → flowbase_cli-0.1.6}/src/flowbase_cli/__init__.py

@@ -1,3 +1,3 @@
 """FlowBase OpenAPI CLI."""
 
-__version__ = "0.1.4"
+__version__ = "0.1.6"

{flowbase_cli-0.1.4 → flowbase_cli-0.1.6}/src/flowbase_cli/endpoints.py

@@ -20,6 +20,86 @@ class Endpoint:
 
 
 ENDPOINTS = (
+    Endpoint("apps.list", "flowbase_apps_list", "GET", "/apps", "metadata:read", "List apps.", "flowbase apps list"),
+    Endpoint("apps.get", "flowbase_apps_get", "GET", "/apps/{app_id}", "metadata:read", "Get app metadata with groups and objects.", "flowbase apps get app_xxx"),
+    Endpoint("apps.create", "flowbase_apps_create", "POST", "/apps", "metadata:write", "Create an app draft.", "flowbase apps create --json-file app.json"),
+    Endpoint("apps.update", "flowbase_apps_update", "PUT", "/apps/{app_id}", "metadata:write", "Update an app draft.", "flowbase apps update app_xxx --label CRM --color '#2563EB'"),
+    Endpoint("apps.set-enabled", "flowbase_apps_set_enabled", "POST", "/apps/{app_id}/enabled", "metadata:write", "Enable or disable an app.", "flowbase apps set-enabled app_xxx --enabled --yes", True),
+    Endpoint("apps.delete", "flowbase_apps_delete", "DELETE", "/apps/{app_id}", "metadata:write", "Delete an app (unlinks objects).", "flowbase apps delete app_xxx --yes", True),
+    Endpoint(
+        "apps.groups.create",
+        "flowbase_apps_groups_create",
+        "POST",
+        "/apps/{app_id}/groups",
+        "metadata:write",
+        "Create an app group draft.",
+        "flowbase groups create app_xxx --name Sales --icon IconFolder",
+    ),
+    Endpoint(
+        "apps.groups.reorder",
+        "flowbase_apps_groups_reorder",
+        "PUT",
+        "/apps/{app_id}/groups/order",
+        "metadata:write",
+        "Reorder app groups.",
+        "flowbase groups reorder app_xxx --json '{\"groupIds\":[\"grp_a\",\"grp_b\"]}'",
+    ),
+    Endpoint(
+        "apps.groups.update",
+        "flowbase_apps_groups_update",
+        "PUT",
+        "/apps/{app_id}/groups/{group_id}",
+        "metadata:write",
+        "Update an app group draft.",
+        "flowbase groups update app_xxx grp_xxx --name Sales",
+    ),
+    Endpoint(
+        "apps.groups.delete",
+        "flowbase_apps_groups_delete",
+        "DELETE",
+        "/apps/{app_id}/groups/{group_id}",
+        "metadata:write",
+        "Delete an app group (objects become ungrouped).",
+        "flowbase groups delete app_xxx grp_xxx --yes",
+        True,
+    ),
+    Endpoint(
+        "apps.objects.add",
+        "flowbase_apps_objects_add",
+        "POST",
+        "/apps/{app_id}/objects",
+        "metadata:write",
+        "Add objects to an app (association only).",
+        "flowbase apps add-objects app_xxx --object-ids obj_a,obj_b",
+    ),
+    Endpoint(
+        "apps.objects.reorder",
+        "flowbase_apps_objects_reorder",
+        "PUT",
+        "/apps/{app_id}/objects/order",
+        "metadata:write",
+        "Reorder app-linked objects.",
+        "flowbase apps reorder-objects app_xxx --json '{\"objectIds\":[\"obj_a\",\"obj_b\"]}'",
+    ),
+    Endpoint(
+        "apps.objects.remove",
+        "flowbase_apps_objects_remove",
+        "DELETE",
+        "/apps/{app_id}/objects/{object_id}",
+        "metadata:write",
+        "Remove an object association from an app.",
+        "flowbase apps remove-object app_xxx obj_xxx --yes",
+        True,
+    ),
+    Endpoint(
+        "apps.objects.set-group",
+        "flowbase_apps_objects_set_group",
+        "POST",
+        "/apps/{app_id}/objects/{object_id}/group",
+        "metadata:write",
+        "Move an app-linked object into a group or ungroup it.",
+        "flowbase apps set-group app_xxx obj_xxx --group-id grp_xxx",
+    ),
     Endpoint("objects.list", "flowbase_objects_list", "GET", "/objects", "metadata:read", "List object metadata.", "flowbase objects list"),
     Endpoint("objects.get", "flowbase_objects_get", "GET", "/objects/{object_id}", "metadata:read", "Get object and field metadata.", "flowbase objects get obj_xxx"),
     Endpoint("objects.create", "flowbase_objects_create", "POST", "/objects", "metadata:write", "Create an object draft.", "flowbase objects create --json-file object.json"),
@@ -36,6 +116,14 @@ ENDPOINTS = (
     Endpoint("views.reorder", "flowbase_views_reorder", "PUT", "/objects/{object_id}/views/order", "metadata:write", "Reorder object views.", "flowbase views reorder obj_xxx --json '{\"baseRevision\":4,\"viewIds\":[\"viw_xxx\"]}'"),
     Endpoint("views.set-enabled", "flowbase_views_set_enabled", "POST", "/objects/{object_id}/views/{view_id}/enabled", "metadata:write", "Enable or disable an object view.", "flowbase views set-enabled obj_xxx viw_xxx --base-revision 4 --enabled --yes", True),
     Endpoint("views.delete", "flowbase_views_delete", "DELETE", "/objects/{object_id}/views/{view_id}", "metadata:write", "Logically delete an object view.", "flowbase views delete obj_xxx viw_xxx --base-revision 4 --yes", True),
+    Endpoint("workflows.list", "flowbase_workflows_list", "GET", "/objects/{object_id}/workflows", "metadata:read", "List object workflows.", "flowbase workflows list obj_xxx"),
+    Endpoint("workflows.get", "flowbase_workflows_get", "GET", "/objects/{object_id}/workflows/{workflow_id}", "metadata:read", "Get a workflow graph.", "flowbase workflows get obj_xxx wfl_xxx"),
+    Endpoint("workflows.create", "flowbase_workflows_create", "POST", "/objects/{object_id}/workflows", "metadata:write", "Create a workflow draft.", "flowbase workflows create obj_xxx --json-file workflow.json"),
+    Endpoint("workflows.update", "flowbase_workflows_update", "PUT", "/objects/{object_id}/workflows/{workflow_id}", "metadata:write", "Update a workflow graph.", "flowbase workflows update obj_xxx wfl_xxx --json-file workflow.json"),
+    Endpoint("workflows.reorder", "flowbase_workflows_reorder", "PUT", "/objects/{object_id}/workflows/order", "metadata:write", "Reorder object workflows.", "flowbase workflows reorder obj_xxx --json '{\"baseRevision\":4,\"workflowIds\":[\"wfl_a\",\"wfl_b\"]}'"),
+    Endpoint("workflows.set-enabled", "flowbase_workflows_set_enabled", "POST", "/objects/{object_id}/workflows/{workflow_id}/enabled", "metadata:write", "Enable or disable a workflow.", "flowbase workflows set-enabled obj_xxx wfl_xxx --base-revision 4 --enabled --yes", True),
+    Endpoint("workflows.delete", "flowbase_workflows_delete", "POST", "/objects/{object_id}/workflows/{workflow_id}/delete", "metadata:write", "Logically delete a workflow.", "flowbase workflows delete obj_xxx wfl_xxx --base-revision 4 --yes", True),
+    Endpoint("workflows.executions", "flowbase_workflows_executions", "GET", "/objects/{object_id}/workflows/{workflow_id}/executions", "metadata:read", "List workflow execution records.", "flowbase workflows executions obj_xxx wfl_xxx --result failure"),
     Endpoint("pages.list", "flowbase_pages_list", "GET", "/pages", "metadata:read", "List custom Page metadata.", "flowbase pages list --object-id obj_xxx"),
     Endpoint("pages.options", "flowbase_pages_options", "GET", "/pages/options", "metadata:read", "Get custom Page design options.", "flowbase pages options"),
     Endpoint("pages.get", "flowbase_pages_get", "GET", "/pages/{page_id}", "metadata:read", "Get a custom Page.", "flowbase pages get pag_xxx"),
@@ -97,9 +185,75 @@ ENDPOINTS = (
     ),
     Endpoint("records.list", "flowbase_records_list", "GET", "/objects/{object_id}/records", "records:read", "List records.", "flowbase records list obj_xxx --page 1"),
     Endpoint("records.get", "flowbase_records_get", "GET", "/objects/{object_id}/records/{record_id}", "records:read", "Get a record.", "flowbase records get obj_xxx rec_xxx"),
+    Endpoint("records.upload-attachment", "flowbase_records_upload_attachment", "POST", "/objects/{object_id}/fields/{field_id}/attachments", "records:write", "Upload an attachment before writing its ID to a record.", "flowbase records upload-attachment obj_xxx fld_xxx ./document.pdf"),
+    Endpoint("records.download-attachment", "flowbase_records_download_attachment", "GET", "/objects/{object_id}/records/{record_id}/attachments/{attachment_id}", "records:read", "Download an attachment bound to a record.", "flowbase records download-attachment obj_xxx rec_xxx att_xxx --output ./document.pdf"),
     Endpoint("records.create", "flowbase_records_create", "POST", "/objects/{object_id}/records", "records:write", "Create a record.", "flowbase records create obj_xxx --json-file record.json"),
     Endpoint("records.update", "flowbase_records_update", "PUT", "/objects/{object_id}/records/{record_id}", "records:write", "Replace active field values on a record.", "flowbase records update obj_xxx rec_xxx --json-file record.json"),
     Endpoint("records.delete", "flowbase_records_delete", "DELETE", "/objects/{object_id}/records/{record_id}", "records:write", "Delete a record.", "flowbase records delete obj_xxx rec_xxx --yes", True),
+    Endpoint(
+        "roles.list",
+        "flowbase_roles_list",
+        "GET",
+        "/roles",
+        "metadata:read",
+        "List organization roles.",
+        "flowbase roles list --page 1",
+        environments=("production",),
+    ),
+    Endpoint(
+        "roles.options",
+        "flowbase_roles_options",
+        "GET",
+        "/roles/options",
+        "metadata:read",
+        "List role editor option sources (apps and objects).",
+        "flowbase roles options",
+        environments=("production",),
+    ),
+    Endpoint(
+        "roles.get",
+        "flowbase_roles_get",
+        "GET",
+        "/roles/{role_id}",
+        "metadata:read",
+        "Get a role with permissions and members.",
+        "flowbase roles get rol_xxx",
+        environments=("production",),
+    ),
+    Endpoint(
+        "roles.create",
+        "flowbase_roles_create",
+        "POST",
+        "/roles",
+        "metadata:write",
+        "Create a custom role.",
+        "flowbase roles create --json-file role.json",
+        environments=("production",),
+        audit_event="role.created",
+    ),
+    Endpoint(
+        "roles.update",
+        "flowbase_roles_update",
+        "PUT",
+        "/roles/{role_id}",
+        "metadata:write",
+        "Update a custom role.",
+        "flowbase roles update rol_xxx --json-file role.json",
+        environments=("production",),
+        audit_event="role.updated",
+    ),
+    Endpoint(
+        "roles.delete",
+        "flowbase_roles_delete",
+        "DELETE",
+        "/roles/{role_id}",
+        "metadata:write",
+        "Delete a custom role.",
+        "flowbase roles delete rol_xxx --yes",
+        True,
+        environments=("production",),
+        audit_event="role.deleted",
+    ),
 )
 
 ENDPOINT_BY_KEY = {endpoint.key: endpoint for endpoint in ENDPOINTS}

{flowbase_cli-0.1.4 → flowbase_cli-0.1.6}/src/flowbase_cli/main.py

@@ -4,7 +4,9 @@ from __future__ import annotations
 import argparse
 from decimal import Decimal
 import json
+import mimetypes
 import os
+import secrets
 import sys
 from pathlib import Path
 from typing import Any
@@ -97,20 +99,27 @@ class OpenApiClient:
         path_params: dict[str, Any] | None = None,
         query: dict[str, Any] | None = None,
         body: dict[str, Any] | None = None,
+        raw_body: bytes | None = None,
+        content_type: str | None = None,
+        accept: str = "application/json",
     ) -> bytes:
         endpoint = get_endpoint(endpoint_key)
         if not self.api_key:
             raise CliError(f"Missing API key. Set {ENV_API_KEY} or pass --api-key.")
         url = self.build_url(endpoint, path_params, query)
         headers = {
-            "Accept": "application/json",
+            "Accept": accept,
             "Authorization": f"Bearer {self.api_key}",
             "X-FlowBase-Channel": "cli",
         }
-        data = None
+        if body is not None and raw_body is not None:
+            raise CliError("JSON and raw request bodies cannot be used together.")
+        data = raw_body
         if body is not None:
             data = exact_json_dumps(body).encode("utf-8")
             headers["Content-Type"] = "application/json"
+        elif raw_body is not None and content_type:
+            headers["Content-Type"] = content_type
         request = Request(url, data=data, headers=headers, method=endpoint.method)
         try:
             with urlopen(request) as response:  # noqa: S310 - the user selects the FlowBase host.
@@ -164,6 +173,30 @@ def exact_json_dumps(value: Any) -> str:
     raise CliError(f"Unsupported JSON value: {type(value).__name__}")
 
 
+def multipart_upload(path_value: str) -> tuple[bytes, str]:
+    path = Path(path_value)
+    try:
+        content = path.read_bytes()
+    except OSError as exc:
+        raise CliError(f"Cannot read attachment: {exc}") from exc
+    filename = path.name.replace('"', "_").replace("\r", "_").replace("\n", "_") or "file"
+    boundary = f"flowbase-{secrets.token_hex(16)}"
+    content_type = mimetypes.guess_type(filename)[0] or "application/octet-stream"
+    ascii_name = filename.encode("ascii", errors="replace").decode("ascii")
+    disposition = (
+        f'Content-Disposition: form-data; name="upload"; filename="{ascii_name}"; '
+        f"filename*=UTF-8''{quote(filename, safe='')}\r\n"
+    ).encode("ascii")
+    payload = b"".join([
+        f"--{boundary}\r\n".encode("ascii"),
+        disposition,
+        f"Content-Type: {content_type}\r\n\r\n".encode("ascii"),
+        content,
+        f"\r\n--{boundary}--\r\n".encode("ascii"),
+    ])
+    return payload, f"multipart/form-data; boundary={boundary}"
+
+
 def print_output(data: bytes, *, pretty: bool, raw: bool) -> None:
     text = data.decode("utf-8", errors="replace")
     if raw:
@@ -276,6 +309,90 @@ def _payload_from_args(args: argparse.Namespace, direct: dict[str, Any], require
     return payload
 
 
+def handle_apps(args: argparse.Namespace) -> int:
+    action = args.apps_action
+    if action == "list":
+        return run_request(args, "apps.list")
+    if action == "get":
+        return run_request(args, "apps.get", path_params={"app_id": args.app_id})
+    if action == "create":
+        body = _payload_from_args(
+            args,
+            {"label": args.label, "key": args.key, "icon": args.icon, "color": args.color},
+            ("label", "key"),
+        )
+        return run_request(args, "apps.create", body=body)
+    if action == "update":
+        body = _payload_from_args(
+            args,
+            {"label": args.label, "icon": args.icon, "color": args.color},
+            ("label", "icon", "color"),
+        )
+        return run_request(args, "apps.update", path_params={"app_id": args.app_id}, body=body)
+    if action == "set-enabled":
+        return run_request(
+            args,
+            "apps.set-enabled",
+            path_params={"app_id": args.app_id},
+            body={"enabled": args.enabled},
+        )
+    if action == "add-objects":
+        ids = [item.strip() for item in (args.object_ids or "").split(",") if item.strip()]
+        if not ids:
+            raise CliError("Provide --object-ids as a comma-separated list.")
+        return run_request(
+            args,
+            "apps.objects.add",
+            path_params={"app_id": args.app_id},
+            body={"objectIds": ids},
+        )
+    if action == "remove-object":
+        return run_request(
+            args,
+            "apps.objects.remove",
+            path_params={"app_id": args.app_id, "object_id": args.object_id},
+        )
+    if action == "set-group":
+        if args.ungrouped:
+            body = {"groupId": None}
+        elif args.group_id is not None:
+            body = {"groupId": args.group_id}
+        else:
+            raise CliError("Provide --group-id or --ungrouped.")
+        return run_request(
+            args,
+            "apps.objects.set-group",
+            path_params={"app_id": args.app_id, "object_id": args.object_id},
+            body=body,
+        )
+    if action == "reorder-objects":
+        body = _payload_from_args(args, {}, ("objectIds",))
+        return run_request(
+            args,
+            "apps.objects.reorder",
+            path_params={"app_id": args.app_id},
+            body=body,
+        )
+    return run_request(args, "apps.delete", path_params={"app_id": args.app_id})
+
+
+def handle_groups(args: argparse.Namespace) -> int:
+    action = args.groups_action
+    path = {"app_id": args.app_id}
+    if action == "create":
+        body = _payload_from_args(args, {"name": args.name, "icon": args.icon}, ("name",))
+        return run_request(args, "apps.groups.create", path_params=path, body=body)
+    if action == "reorder":
+        body = _payload_from_args(args, {}, ("groupIds",))
+        return run_request(args, "apps.groups.reorder", path_params=path, body=body)
+    if action == "update":
+        path["group_id"] = args.group_id
+        body = _payload_from_args(args, {"name": args.name, "icon": args.icon}, ("name", "icon"))
+        return run_request(args, "apps.groups.update", path_params=path, body=body)
+    path["group_id"] = args.group_id
+    return run_request(args, "apps.groups.delete", path_params=path)
+
+
 def handle_objects(args: argparse.Namespace) -> int:
     action = args.objects_action
     if action == "list":
@@ -285,12 +402,23 @@ def handle_objects(args: argparse.Namespace) -> int:
     if action == "create":
         body = _payload_from_args(
             args,
-            {"label": args.label, "key": args.key, "description": args.description},
+            {
+                "label": args.label,
+                "key": args.key,
+                "description": args.description,
+            },
             ("label", "key", "description"),
         )
         return run_request(args, "objects.create", body=body)
     if action == "update":
-        body = _payload_from_args(args, {"label": args.label, "description": args.description}, ("label", "description"))
+        body = _payload_from_args(
+            args,
+            {
+                "label": args.label,
+                "description": args.description,
+            },
+            ("label", "description"),
+        )
         return run_request(args, "objects.update", path_params={"object_id": args.object_id}, body=body)
     return run_request(args, f"objects.{action}", path_params={"object_id": args.object_id})
 
@@ -346,6 +474,46 @@ def handle_views(args: argparse.Namespace) -> int:
     )
 
 
+def handle_workflows(args: argparse.Namespace) -> int:
+    action = args.workflows_action
+    path = {"object_id": args.object_id}
+    if hasattr(args, "workflow_id"):
+        path["workflow_id"] = args.workflow_id
+    if action == "list":
+        return run_request(args, "workflows.list", path_params=path)
+    if action == "get":
+        return run_request(args, "workflows.get", path_params=path)
+    if action == "executions":
+        return run_request(
+            args,
+            "workflows.executions",
+            path_params=path,
+            query={"result": args.result},
+        )
+    if action in ("create", "update"):
+        body = load_json_payload(args.json, args.json_file)
+        require_fields(body, "label")
+        return run_request(args, f"workflows.{action}", path_params=path, body=body)
+    if action == "reorder":
+        body = load_json_payload(args.json, args.json_file)
+        require_fields(body, "baseRevision", "workflowIds")
+        if not isinstance(body["workflowIds"], list):
+            raise CliError("Request field 'workflowIds' must be an array.")
+        return run_request(args, "workflows.reorder", path_params=path, body=body)
+    if action == "set-enabled":
+        body = {
+            "baseRevision": args.base_revision,
+            "enabled": args.enabled,
+        }
+        return run_request(args, "workflows.set-enabled", path_params=path, body=body)
+    return run_request(
+        args,
+        "workflows.delete",
+        path_params=path,
+        body={"baseRevision": args.base_revision},
+    )
+
+
 def handle_pages(args: argparse.Namespace) -> int:
     action = args.pages_action
     if action == "list":
@@ -513,6 +681,31 @@ def handle_environments(args: argparse.Namespace) -> int:
 def handle_records(args: argparse.Namespace) -> int:
     action = args.records_action
     path = {"object_id": args.object_id}
+    if action == "upload-attachment":
+        body, content_type = multipart_upload(args.file)
+        data = client_from_args(args).request(
+            "records.upload-attachment",
+            path_params={**path, "field_id": args.field_id},
+            raw_body=body,
+            content_type=content_type,
+        )
+        print_output(data, pretty=args.pretty, raw=args.raw)
+        return 0
+    if action == "download-attachment":
+        data = client_from_args(args).request(
+            "records.download-attachment",
+            path_params={
+                **path,
+                "record_id": args.record_id,
+                "attachment_id": args.attachment_id,
+            },
+            accept="application/octet-stream",
+        )
+        try:
+            Path(args.output).write_bytes(data)
+        except OSError as exc:
+            raise CliError(f"Cannot write attachment: {exc}") from exc
+        return 0
     if hasattr(args, "record_id"):
         path["record_id"] = args.record_id
     if action == "list":
@@ -526,6 +719,27 @@ def handle_records(args: argparse.Namespace) -> int:
     return run_request(args, f"records.{action}", path_params=path, body=body)
 
 
+def handle_roles(args: argparse.Namespace) -> int:
+    action = args.roles_action
+    if action == "list":
+        return run_request(args, "roles.list", query={"q": args.q or "", "page": args.page})
+    if action == "options":
+        return run_request(args, "roles.options")
+    if action == "get":
+        return run_request(args, "roles.get", path_params={"role_id": args.role_id})
+    if action == "delete":
+        return run_request(args, "roles.delete", path_params={"role_id": args.role_id})
+    body = load_json_payload(args.json, args.json_file)
+    require_fields(body, "name", "permissions")
+    if not isinstance(body["permissions"], dict):
+        raise CliError("Request field 'permissions' must be an object.")
+    if action == "create":
+        return run_request(args, "roles.create", body=body)
+    if "updatedAt" not in body and "updated_at" not in body:
+        raise CliError("Missing request field(s): updatedAt")
+    return run_request(args, "roles.update", path_params={"role_id": args.role_id}, body=body)
+
+
 def add_json_args(parser: argparse.ArgumentParser) -> None:
     group = parser.add_mutually_exclusive_group()
     group.add_argument("--json", help="Request body as a JSON object.")
@@ -560,6 +774,77 @@ def build_parser() -> argparse.ArgumentParser:
     docs_show.add_argument("endpoint", choices=sorted(ENDPOINT_BY_KEY))
     docs.set_defaults(handler=handle_docs)
 
+    apps = groups.add_parser("apps", help="Manage app metadata.")
+    app_actions = apps.add_subparsers(dest="apps_action", required=True)
+    app_actions.add_parser("list")
+    app_get = app_actions.add_parser("get")
+    app_get.add_argument("app_id")
+    app_create = app_actions.add_parser("create")
+    app_create.add_argument("--label")
+    app_create.add_argument("--key")
+    app_create.add_argument("--icon")
+    app_create.add_argument("--color")
+    add_json_args(app_create)
+    app_update = app_actions.add_parser("update")
+    app_update.add_argument("app_id")
+    app_update.add_argument("--label")
+    app_update.add_argument("--icon")
+    app_update.add_argument("--color")
+    add_json_args(app_update)
+    app_enabled = app_actions.add_parser("set-enabled")
+    app_enabled.add_argument("app_id")
+    app_enabled.add_argument(
+        "--enabled",
+        action=argparse.BooleanOptionalAction,
+        required=True,
+    )
+    add_yes(app_enabled)
+    app_delete = app_actions.add_parser("delete")
+    app_delete.add_argument("app_id")
+    add_yes(app_delete)
+    app_add_objects = app_actions.add_parser("add-objects")
+    app_add_objects.add_argument("app_id")
+    app_add_objects.add_argument("--object-ids", required=True, help="Comma-separated object IDs.")
+    app_remove_object = app_actions.add_parser("remove-object")
+    app_remove_object.add_argument("app_id")
+    app_remove_object.add_argument("object_id")
+    add_yes(app_remove_object)
+    app_set_group = app_actions.add_parser("set-group")
+    app_set_group.add_argument("app_id")
+    app_set_group.add_argument("object_id")
+    app_set_group.add_argument("--group-id", help="Target group ID. Omit with --ungrouped.")
+    app_set_group.add_argument(
+        "--ungrouped",
+        action="store_true",
+        help="Remove the object from its current group in this app.",
+    )
+    app_reorder_objects = app_actions.add_parser("reorder-objects")
+    app_reorder_objects.add_argument("app_id")
+    add_json_args(app_reorder_objects)
+    apps.set_defaults(handler=handle_apps)
+
+    app_groups = groups.add_parser("groups", help="Manage app object groups.")
+    group_actions = app_groups.add_subparsers(dest="groups_action", required=True)
+    group_create = group_actions.add_parser("create")
+    group_create.add_argument("app_id")
+    group_create.add_argument("--name")
+    group_create.add_argument("--icon")
+    add_json_args(group_create)
+    group_reorder = group_actions.add_parser("reorder")
+    group_reorder.add_argument("app_id")
+    add_json_args(group_reorder)
+    group_update = group_actions.add_parser("update")
+    group_update.add_argument("app_id")
+    group_update.add_argument("group_id")
+    group_update.add_argument("--name")
+    group_update.add_argument("--icon")
+    add_json_args(group_update)
+    group_delete = group_actions.add_parser("delete")
+    group_delete.add_argument("app_id")
+    group_delete.add_argument("group_id")
+    add_yes(group_delete)
+    app_groups.set_defaults(handler=handle_groups)
+
     objects = groups.add_parser("objects", help="Manage object metadata.")
     object_actions = objects.add_subparsers(dest="objects_action", required=True)
     object_list = object_actions.add_parser("list")
@@ -622,6 +907,42 @@ def build_parser() -> argparse.ArgumentParser:
     add_yes(view_delete)
     views.set_defaults(handler=handle_views)
 
+    workflows = groups.add_parser("workflows", help="Manage object workflow metadata.")
+    workflow_actions = workflows.add_subparsers(dest="workflows_action", required=True)
+    workflow_list = workflow_actions.add_parser("list")
+    workflow_list.add_argument("object_id")
+    workflow_get = workflow_actions.add_parser("get")
+    workflow_get.add_argument("object_id")
+    workflow_get.add_argument("workflow_id")
+    for action in ("create", "reorder"):
+        item = workflow_actions.add_parser(action)
+        item.add_argument("object_id")
+        add_json_args(item)
+    workflow_update = workflow_actions.add_parser("update")
+    workflow_update.add_argument("object_id")
+    workflow_update.add_argument("workflow_id")
+    add_json_args(workflow_update)
+    workflow_enabled = workflow_actions.add_parser("set-enabled")
+    workflow_enabled.add_argument("object_id")
+    workflow_enabled.add_argument("workflow_id")
+    workflow_enabled.add_argument("--base-revision", required=True, type=int)
+    workflow_enabled.add_argument(
+        "--enabled",
+        action=argparse.BooleanOptionalAction,
+        required=True,
+    )
+    add_yes(workflow_enabled)
+    workflow_delete = workflow_actions.add_parser("delete")
+    workflow_delete.add_argument("object_id")
+    workflow_delete.add_argument("workflow_id")
+    workflow_delete.add_argument("--base-revision", required=True, type=int)
+    add_yes(workflow_delete)
+    workflow_executions = workflow_actions.add_parser("executions")
+    workflow_executions.add_argument("object_id")
+    workflow_executions.add_argument("workflow_id")
+    workflow_executions.add_argument("--result", choices=("success", "failure"))
+    workflows.set_defaults(handler=handle_workflows)
+
     pages = groups.add_parser("pages", help="Manage custom Page metadata.")
     page_actions = pages.add_subparsers(dest="pages_action", required=True)
     page_list = page_actions.add_parser("list")
@@ -693,6 +1014,15 @@ def build_parser() -> argparse.ArgumentParser:
     record_get = record_actions.add_parser("get")
     record_get.add_argument("object_id")
     record_get.add_argument("record_id")
+    record_upload = record_actions.add_parser("upload-attachment")
+    record_upload.add_argument("object_id")
+    record_upload.add_argument("field_id")
+    record_upload.add_argument("file")
+    record_download = record_actions.add_parser("download-attachment")
+    record_download.add_argument("object_id")
+    record_download.add_argument("record_id")
+    record_download.add_argument("attachment_id")
+    record_download.add_argument("--output", required=True)
     record_create = record_actions.add_parser("create")
     record_create.add_argument("object_id")
     add_json_args(record_create)
@@ -705,6 +1035,24 @@ def build_parser() -> argparse.ArgumentParser:
     record_delete.add_argument("record_id")
     add_yes(record_delete)
     records.set_defaults(handler=handle_records)
+
+    roles = groups.add_parser("roles", help="Manage organization roles (production Host only).")
+    role_actions = roles.add_subparsers(dest="roles_action", required=True)
+    role_list = role_actions.add_parser("list")
+    role_list.add_argument("--q", default="", help="Filter by role name.")
+    role_list.add_argument("--page", type=int, default=1)
+    role_actions.add_parser("options")
+    role_get = role_actions.add_parser("get")
+    role_get.add_argument("role_id")
+    role_create = role_actions.add_parser("create")
+    add_json_args(role_create)
+    role_update = role_actions.add_parser("update")
+    role_update.add_argument("role_id")
+    add_json_args(role_update)
+    role_delete = role_actions.add_parser("delete")
+    role_delete.add_argument("role_id")
+    add_yes(role_delete)
+    roles.set_defaults(handler=handle_roles)
     return parser
 
 

{flowbase_cli-0.1.4 → flowbase_cli-0.1.6}/src/flowbase_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flowbase-cli
-Version: 0.1.4
+Version: 0.1.6
 Summary: Command line client for the FlowBase OpenAPI
 Author: DeepFlowAI
 License: Apache-2.0

{flowbase_cli-0.1.4 → flowbase_cli-0.1.6}/tests/test_cli.py

@@ -89,6 +89,9 @@ class FlowBaseCliTest(unittest.TestCase):
         self.assertTrue(any(item["key"] == "versions.get" for item in payload))
         self.assertTrue(any(item["key"] == "pages.create" for item in payload))
         self.assertTrue(any(item["key"] == "views.create" for item in payload))
+        self.assertTrue(any(item["key"] == "roles.create" for item in payload))
+        role_create = next(item for item in payload if item["key"] == "roles.create")
+        self.assertEqual(role_create["environments"], ["production"])
 
     def test_view_create_sends_complete_snapshot(self):
         body = {
@@ -227,6 +230,106 @@ class FlowBaseCliTest(unittest.TestCase):
         self.assertEqual(code, 1)
         self.assertIn("description", stderr.getvalue())
 
+    def test_object_create_without_app_id(self):
+        with patch(
+            "flowbase_cli.main.OpenApiClient.request",
+            return_value=b'{"objectId":"obj_1","draftRevision":2}',
+        ) as request:
+            code = main([
+                "--api-key",
+                "fbk_test",
+                "objects",
+                "create",
+                "--label",
+                "Customer",
+                "--key",
+                "customer",
+                "--description",
+                "Customer records",
+            ])
+        self.assertEqual(code, 0)
+        self.assertEqual(request.call_args.args[0], "objects.create")
+        self.assertEqual(
+            request.call_args.kwargs["body"],
+            {
+                "label": "Customer",
+                "key": "customer",
+                "description": "Customer records",
+            },
+        )
+
+    def test_group_create_and_app_set_group(self):
+        with patch(
+            "flowbase_cli.main.OpenApiClient.request",
+            return_value=b'{"groupId":"grp_1","draftRevision":3}',
+        ) as request:
+            code = main([
+                "--api-key",
+                "fbk_test",
+                "groups",
+                "create",
+                "app_1",
+                "--name",
+                "Sales",
+                "--icon",
+                "IconFolder",
+            ])
+        self.assertEqual(code, 0)
+        self.assertEqual(request.call_args.args[0], "apps.groups.create")
+        self.assertEqual(request.call_args.kwargs["path_params"], {"app_id": "app_1"})
+        self.assertEqual(
+            request.call_args.kwargs["body"],
+            {"name": "Sales", "icon": "IconFolder"},
+        )
+
+        with patch(
+            "flowbase_cli.main.OpenApiClient.request",
+            return_value=b'{"ok":true,"draftRevision":4}',
+        ) as request:
+            code = main([
+                "--api-key",
+                "fbk_test",
+                "apps",
+                "set-group",
+                "app_1",
+                "obj_1",
+                "--group-id",
+                "grp_1",
+            ])
+        self.assertEqual(code, 0)
+        self.assertEqual(request.call_args.args[0], "apps.objects.set-group")
+        self.assertEqual(
+            request.call_args.kwargs["path_params"],
+            {"app_id": "app_1", "object_id": "obj_1"},
+        )
+        self.assertEqual(
+            request.call_args.kwargs["body"],
+            {"groupId": "grp_1"},
+        )
+
+        with patch(
+            "flowbase_cli.main.OpenApiClient.request",
+            return_value=b'{"ok":true,"draftRevision":5}',
+        ) as request:
+            code = main([
+                "--api-key",
+                "fbk_test",
+                "apps",
+                "set-group",
+                "app_1",
+                "obj_1",
+                "--ungrouped",
+            ])
+        self.assertEqual(code, 0)
+        self.assertEqual(request.call_args.kwargs["body"], {"groupId": None})
+
+    def test_group_delete_requires_yes(self):
+        stderr = io.StringIO()
+        with patch("sys.stderr", stderr), patch("sys.stdin.isatty", return_value=False):
+            code = main(["--api-key", "fbk_test", "groups", "delete", "app_1", "grp_1"])
+        self.assertEqual(code, 1)
+        self.assertIn("without --yes", stderr.getvalue())
+
     def test_noninteractive_delete_requires_yes(self):
         stderr = io.StringIO()
         with patch("sys.stderr", stderr), patch("sys.stdin.isatty", return_value=False):
@@ -234,6 +337,44 @@ class FlowBaseCliTest(unittest.TestCase):
         self.assertEqual(code, 1)
         self.assertIn("without --yes", stderr.getvalue())
 
+    def test_record_attachment_upload_sends_multipart_body(self):
+        with TemporaryDirectory() as directory:
+            path = Path(directory) / "note.txt"
+            path.write_text("hello", encoding="utf-8")
+            with patch(
+                "flowbase_cli.main.OpenApiClient.request",
+                return_value=b'{"id":"att_1"}',
+            ) as request:
+                code = main([
+                    "--api-key", "fbk_test", "records", "upload-attachment",
+                    "obj_1", "fld_1", str(path),
+                ])
+        self.assertEqual(code, 0)
+        self.assertEqual(request.call_args.args[0], "records.upload-attachment")
+        self.assertEqual(
+            request.call_args.kwargs["path_params"],
+            {"object_id": "obj_1", "field_id": "fld_1"},
+        )
+        self.assertTrue(request.call_args.kwargs["content_type"].startswith("multipart/form-data; boundary="))
+        self.assertIn(b'name="upload"', request.call_args.kwargs["raw_body"])
+        self.assertIn(b"hello", request.call_args.kwargs["raw_body"])
+
+    def test_record_attachment_download_writes_exact_bytes(self):
+        with TemporaryDirectory() as directory:
+            output = Path(directory) / "download.pdf"
+            with patch(
+                "flowbase_cli.main.OpenApiClient.request",
+                return_value=b"%PDF-1.7",
+            ) as request:
+                code = main([
+                    "--api-key", "fbk_test", "records", "download-attachment",
+                    "obj_1", "rec_1", "att_1", "--output", str(output),
+                ])
+            self.assertEqual(output.read_bytes(), b"%PDF-1.7")
+        self.assertEqual(code, 0)
+        self.assertEqual(request.call_args.args[0], "records.download-attachment")
+        self.assertEqual(request.call_args.kwargs["accept"], "application/octet-stream")
+
     def test_noninteractive_commit_requires_yes(self):
         stderr = io.StringIO()
         with patch("sys.stderr", stderr), patch("sys.stdin.isatty", return_value=False):