hap-cli 0.5.0__py3-none-any.whl

hap_cli/commands/chat_cmd.py

@@ -0,0 +1,101 @@
+"""CLI commands for chat and messaging management."""
+
+import json
+
+import click
+
+from hap_cli.context import pass_context
+from hap_cli.core import chat as chat_mod
+from hap_cli.utils.formatting import output_json, output_kv
+
+
+@click.group()
+def chat():
+    """Chat and messaging management."""
+    pass
+
+
+@chat.command("list")
+@click.option("--page-size", "-n", default=20, help="Items per page")
+@click.option("--page", "-p", default=1, help="Page number")
+@pass_context
+def chat_list(ctx, page_size, page):
+    """List recent chat sessions."""
+    try:
+        session = ctx.get_session()
+        data = chat_mod.get_chat_list(session, page_index=page, page_size=page_size)
+        ctx.output(data, lambda d: output_json(d))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@chat.command("send")
+@click.option("--to", "-t", multiple=True, required=True, help="Target user account ID (can repeat)")
+@click.option("--message", "-m", required=True, help="Message content")
+@pass_context
+def chat_send(ctx, to, message):
+    """Send a message to one or more users."""
+    try:
+        session = ctx.get_session()
+        data = chat_mod.send_message(session, list(to), message)
+        ctx.output(data, lambda d: click.echo("Message sent."))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@chat.command("send-file")
+@click.argument("chat_id")
+@click.option("--file-url", required=True, help="File URL to send")
+@pass_context
+def chat_send_file(ctx, chat_id, file_url):
+    """Send a file to a chat."""
+    try:
+        session = ctx.get_session()
+        data = chat_mod.send_file(session, chat_id, file_url)
+        ctx.output(data, lambda d: click.echo("File sent."))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@chat.command("send-card")
+@click.argument("chat_id")
+@click.option("--data", "card_data", required=True, help="Card data as JSON string")
+@pass_context
+def chat_send_card(ctx, chat_id, card_data):
+    """Send a card to a chat."""
+    try:
+        session = ctx.get_session()
+        data = chat_mod.send_card(session, chat_id, json.loads(card_data))
+        ctx.output(data, lambda d: click.echo("Card sent."))
+    except json.JSONDecodeError as e:
+        ctx.handle_error(click.UsageError(f"Invalid JSON: {e}"))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@chat.command("group-info")
+@click.argument("group_id")
+@pass_context
+def chat_group_info(ctx, group_id):
+    """Get chat group information."""
+    try:
+        session = ctx.get_session()
+        data = chat_mod.get_group_info(session, group_id)
+        ctx.output(data, lambda d: output_kv(d))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@chat.command("group-files")
+@click.argument("group_id")
+@click.option("--page-size", "-n", default=20, help="Items per page")
+@click.option("--page", "-p", default=1, help="Page number")
+@pass_context
+def chat_group_files(ctx, group_id, page_size, page):
+    """List files in a chat group."""
+    try:
+        session = ctx.get_session()
+        data = chat_mod.get_group_files(session, group_id, page_index=page, page_size=page_size)
+        ctx.output(data, lambda d: output_json(d))
+    except Exception as e:
+        ctx.handle_error(e)

hap_cli/commands/config_cmd.py

@@ -0,0 +1,169 @@
+"""CLI commands for server configuration and authentication."""
+
+import click
+
+from hap_cli.context import pass_context
+from hap_cli.core.session import Session, SessionError
+from hap_cli.core import auth as auth_mod
+from hap_cli.utils.formatting import output_json, output_kv
+
+
+SERVER_HELP = (
+    "Server: 'mingdao', 'nocoly', or self-hosted URL "
+    "(e.g. https://hap.example.com)"
+)
+
+
+@click.group()
+def config():
+    """Manage server connection and authentication."""
+    pass
+
+
+@config.command("set")
+@click.option("--server", "-s", required=True, help="MingDAO server URL")
+@click.option("--token", "-t", required=True, help="Authentication token (md_pss_id)")
+@click.option("--app-id", "-a", default="", help="Default application ID")
+@click.option("--project-id", "-p", default="", help="Default project/org ID")
+@pass_context
+def config_set(ctx, server, token, app_id, project_id):
+    """Set server URL and authentication token."""
+    session = Session(server_url=server, auth_token=token)
+    session.default_app_id = app_id
+    session.default_project_id = project_id
+    session.save()
+    ctx.output(
+        {"status": "ok", "server": server},
+        lambda d: click.echo(f"Config saved. Server: {server}"),
+    )
+
+
+@config.command("show")
+@pass_context
+def config_show(ctx):
+    """Show current configuration."""
+    session = ctx.get_session()
+    data = {
+        "server_url": session.server_url,
+        "auth_token": session.auth_token[:8] + "..." if session.auth_token else "",
+        "default_app_id": session.default_app_id,
+        "default_project_id": session.default_project_id,
+        "configured": session.is_configured(),
+    }
+    ctx.output(
+        data,
+        lambda d: output_kv(d, labels={
+            "server_url": "Server URL",
+            "auth_token": "Auth Token",
+            "default_app_id": "Default App ID",
+            "default_project_id": "Default Project ID",
+            "configured": "Configured",
+        }),
+    )
+
+
+@config.command("login")
+@click.argument("server", default="mingdao")
+@click.option("--timeout", "-t", default=300, help="Login timeout in seconds")
+@pass_context
+def config_login(ctx, server, timeout):
+    """Login via browser. Opens HAP login page and captures token.
+
+    SERVER can be 'mingdao', 'nocoly', or a self-hosted URL.
+    Default is 'mingdao'.
+    """
+    try:
+        api_host, webui = auth_mod.resolve_server(server)
+        port = auth_mod.get_available_port()
+        auth_url = auth_mod.build_auth_url(webui, port)
+
+        if not ctx.json_mode:
+            click.echo(f"Opening browser for login...")
+            click.echo(f"  Server: {webui}")
+            click.echo(f"  If browser doesn't open, visit:")
+            click.echo(f"  {auth_url}")
+            click.echo(f"  Waiting for login (timeout: {timeout}s)...")
+
+        token, api_host, user_info = auth_mod.login(server, timeout=timeout)
+
+        # Save to config
+        session = ctx.get_session()
+        session.server_url = api_host
+        session.auth_token = token
+        session.save()
+
+        data = {
+            "status": "ok",
+            "server_url": api_host,
+            "user": user_info,
+        }
+        ctx.output(
+            data,
+            lambda d: click.echo(
+                f"Logged in as: {user_info.get('name', '')} "
+                f"({user_info.get('email', '')})\n"
+                f"Server: {api_host}"
+            ),
+        )
+    except TimeoutError:
+        ctx.handle_error(SessionError("Login timed out. Please try again."))
+    except ImportError as e:
+        ctx.handle_error(SessionError(str(e)))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@config.command("logout")
+@pass_context
+def config_logout(ctx):
+    """Clear saved authentication token."""
+    session = ctx.get_session()
+    old_server = session.server_url
+    session.auth_token = ""
+    session.save()
+    ctx.output(
+        {"status": "ok", "server_url": old_server},
+        lambda d: click.echo(f"Logged out. Token cleared."),
+    )
+
+
+@config.command("orgs")
+@pass_context
+def config_orgs(ctx):
+    """List all organizations the current user belongs to."""
+    try:
+        session = ctx.get_session()
+        data = session.api_call("Account", "GetProjectList", {})
+        def _table(d):
+            projects = d if isinstance(d, list) else d.get("list", [d])
+            for p in projects:
+                pid = p.get("projectId", "")
+                name = p.get("companyName", p.get("name", ""))
+                role = p.get("roleName", "")
+                click.echo(f"{pid}  {name}  {role}")
+        ctx.output(data, _table)
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@config.command("whoami")
+@pass_context
+def config_whoami(ctx):
+    """Show current logged-in user info."""
+    try:
+        session = ctx.get_session()
+        if not session.is_configured():
+            raise SessionError("Not logged in. Run 'config login' first.")
+
+        user_info = auth_mod.get_user_info(session.server_url, session.auth_token)
+        ctx.output(
+            user_info,
+            lambda d: output_kv(d, labels={
+                "id": "Account ID",
+                "name": "Name",
+                "email": "Email",
+                "lang": "Language",
+            }),
+        )
+    except Exception as e:
+        ctx.handle_error(e)

hap_cli/commands/contact_cmd.py

@@ -0,0 +1,125 @@
+"""CLI commands for address book and contact management."""
+
+import click
+
+from hap_cli.context import pass_context
+from hap_cli.core import contact as contact_mod
+from hap_cli.utils.formatting import output_json, output_table, output_kv
+
+
+@click.group()
+def contact():
+    """Address book and contact management."""
+    pass
+
+
+@contact.command("search")
+@click.argument("keywords")
+@click.option("--project-id", "-p", default="", help="Project/org ID")
+@pass_context
+def contact_search(ctx, keywords, project_id):
+    """Search contacts and departments."""
+    try:
+        session = ctx.get_session()
+        pid = project_id or session.default_project_id
+        data = contact_mod.search_contacts(session, keywords, project_id=pid)
+        ctx.output(data, lambda d: output_json(d))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@contact.command("get")
+@click.argument("account_id")
+@pass_context
+def contact_get(ctx, account_id):
+    """Get user account details."""
+    try:
+        session = ctx.get_session()
+        data = contact_mod.get_account_detail(session, account_id)
+        ctx.output(data, lambda d: output_kv(d))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@contact.command("friends")
+@click.option("--page-size", "-n", default=20, help="Items per page")
+@click.option("--page", "-p", default=1, help="Page number")
+@pass_context
+def contact_friends(ctx, page_size, page):
+    """List friends/contacts in address book."""
+    try:
+        session = ctx.get_session()
+        data = contact_mod.get_friends(session, page_index=page, page_size=page_size)
+        ctx.output(data, lambda d: output_json(d))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@contact.command("add-friend")
+@click.argument("account_id")
+@click.option("--message", "-m", default="", help="Request message")
+@pass_context
+def contact_add_friend(ctx, account_id, message):
+    """Send a friend request."""
+    try:
+        session = ctx.get_session()
+        data = contact_mod.add_friend(session, account_id, message=message)
+        ctx.output(data, lambda d: click.echo("Friend request sent."))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@contact.command("remove-friend")
+@click.argument("account_id")
+@click.option("--yes", "-y", is_flag=True, help="Skip confirmation")
+@pass_context
+def contact_remove_friend(ctx, account_id, yes):
+    """Remove a friend from address book."""
+    try:
+        if not yes:
+            click.confirm(f"Remove friend {account_id}?", abort=True)
+        session = ctx.get_session()
+        data = contact_mod.remove_friend(session, account_id)
+        ctx.output(data, lambda d: click.echo("Friend removed."))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@contact.command("friend-requests")
+@click.option("--page-size", "-n", default=20, help="Items per page")
+@click.option("--page", "-p", default=1, help="Page number")
+@pass_context
+def contact_friend_requests(ctx, page_size, page):
+    """List pending friend requests."""
+    try:
+        session = ctx.get_session()
+        data = contact_mod.get_friend_requests(session, page_index=page, page_size=page_size)
+        ctx.output(data, lambda d: output_json(d))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@contact.command("accept-friend")
+@click.argument("account_id")
+@pass_context
+def contact_accept_friend(ctx, account_id):
+    """Accept a friend request."""
+    try:
+        session = ctx.get_session()
+        data = contact_mod.accept_friend(session, account_id)
+        ctx.output(data, lambda d: click.echo("Friend request accepted."))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@contact.command("reject-friend")
+@click.argument("account_id")
+@pass_context
+def contact_reject_friend(ctx, account_id):
+    """Reject a friend request."""
+    try:
+        session = ctx.get_session()
+        data = contact_mod.reject_friend(session, account_id)
+        ctx.output(data, lambda d: click.echo("Friend request rejected."))
+    except Exception as e:
+        ctx.handle_error(e)

hap_cli/commands/department_cmd.py

@@ -0,0 +1,168 @@
+"""CLI commands for department management."""
+
+import click
+
+from hap_cli.context import pass_context
+from hap_cli.core import department as dept_mod
+from hap_cli.utils.formatting import output_json, output_table, output_kv
+
+
+@click.group()
+def department():
+    """Department management."""
+    pass
+
+
+@department.command("list")
+@click.option("--project-id", "-p", default="", help="Project/org ID")
+@click.option("--parent-id", default="", help="Parent department ID")
+@click.option("--page-size", "-n", default=50, help="Items per page")
+@click.option("--page", default=1, help="Page number")
+@pass_context
+def department_list(ctx, project_id, parent_id, page_size, page):
+    """List sub-departments."""
+    try:
+        session = ctx.get_session()
+        pid = project_id or session.default_project_id
+        if not pid:
+            raise click.UsageError("Project ID required.")
+        data = dept_mod.list_departments(session, pid, parent_id=parent_id, page_index=page, page_size=page_size)
+        ctx.output(data, lambda d: output_json(d))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@department.command("tree")
+@click.option("--project-id", "-p", default="", help="Project/org ID")
+@click.option("--department-id", "-d", default="", help="Root department ID")
+@pass_context
+def department_tree(ctx, project_id, department_id):
+    """Get the full department tree."""
+    try:
+        session = ctx.get_session()
+        pid = project_id or session.default_project_id
+        if not pid:
+            raise click.UsageError("Project ID required.")
+        data = dept_mod.get_department_tree(session, pid, department_id=department_id)
+        ctx.output(data, lambda d: output_json(d))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@department.command("info")
+@click.argument("department_id")
+@pass_context
+def department_info(ctx, department_id):
+    """Get department details."""
+    try:
+        session = ctx.get_session()
+        data = dept_mod.get_department_info(session, department_id)
+        ctx.output(data, lambda d: output_kv(d))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@department.command("create")
+@click.option("--project-id", "-p", default="", help="Project/org ID")
+@click.option("--name", "-n", required=True, help="Department name")
+@click.option("--parent-id", default="", help="Parent department ID")
+@pass_context
+def department_create(ctx, project_id, name, parent_id):
+    """Create a new department."""
+    try:
+        session = ctx.get_session()
+        pid = project_id or session.default_project_id
+        if not pid:
+            raise click.UsageError("Project ID required.")
+        data = dept_mod.create_department(session, pid, name, parent_id=parent_id)
+        ctx.output(data, lambda d: click.echo(f"Department created: {d}"))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@department.command("update")
+@click.argument("department_id")
+@click.option("--name", "-n", required=True, help="New department name")
+@pass_context
+def department_update(ctx, department_id, name):
+    """Update department name."""
+    try:
+        session = ctx.get_session()
+        data = dept_mod.update_department(session, department_id, name)
+        ctx.output(data, lambda d: click.echo("Department updated."))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@department.command("delete")
+@click.argument("department_ids", nargs=-1, required=True)
+@click.option("--project-id", "-p", default="", help="Project/org ID")
+@click.option("--yes", "-y", is_flag=True, help="Skip confirmation")
+@pass_context
+def department_delete(ctx, department_ids, project_id, yes):
+    """Delete one or more departments."""
+    try:
+        if not yes:
+            click.confirm(f"Delete {len(department_ids)} department(s)?", abort=True)
+        session = ctx.get_session()
+        pid = project_id or session.default_project_id
+        if not pid:
+            raise click.UsageError("Project ID required.")
+        data = dept_mod.delete_departments(session, pid, list(department_ids))
+        ctx.output(data, lambda d: click.echo(f"Deleted {len(department_ids)} department(s)."))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@department.command("members")
+@click.argument("department_id")
+@click.option("--project-id", "-p", default="", help="Project/org ID")
+@click.option("--page-size", "-n", default=50, help="Items per page")
+@click.option("--page", default=1, help="Page number")
+@pass_context
+def department_members(ctx, department_id, project_id, page_size, page):
+    """Get members of a department."""
+    try:
+        session = ctx.get_session()
+        pid = project_id or session.default_project_id
+        if not pid:
+            raise click.UsageError("Project ID required.")
+        data = dept_mod.get_department_users(session, pid, department_id, page_index=page, page_size=page_size)
+        ctx.output(data, lambda d: output_json(d))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@department.command("search")
+@click.argument("keywords")
+@click.option("--project-id", "-p", default="", help="Project/org ID")
+@pass_context
+def department_search(ctx, keywords, project_id):
+    """Search departments and users."""
+    try:
+        session = ctx.get_session()
+        pid = project_id or session.default_project_id
+        if not pid:
+            raise click.UsageError("Project ID required.")
+        data = dept_mod.search_dept_and_users(session, pid, keywords)
+        ctx.output(data, lambda d: output_json(d))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@department.command("move")
+@click.argument("department_id")
+@click.argument("target_dept_id")
+@click.option("--project-id", "-p", default="", help="Project/org ID")
+@pass_context
+def department_move(ctx, department_id, target_dept_id, project_id):
+    """Move a department under a new parent."""
+    try:
+        session = ctx.get_session()
+        pid = project_id or session.default_project_id
+        if not pid:
+            raise click.UsageError("Project ID required.")
+        data = dept_mod.move_department(session, pid, department_id, target_dept_id)
+        ctx.output(data, lambda d: click.echo("Department moved."))
+    except Exception as e:
+        ctx.handle_error(e)

hap_cli/commands/group_cmd.py

@@ -0,0 +1,128 @@
+"""CLI commands for group management."""
+
+import click
+
+from hap_cli.context import pass_context
+from hap_cli.core import group as group_mod
+from hap_cli.utils.formatting import output_json, output_kv
+
+
+@click.group()
+def group():
+    """Group management."""
+    pass
+
+
+@group.command("list")
+@click.option("--project-id", "-p", default="", help="Project/org ID")
+@click.option("--page-size", "-n", default=50, help="Items per page")
+@click.option("--page", default=1, help="Page number")
+@pass_context
+def group_list(ctx, project_id, page_size, page):
+    """List groups."""
+    try:
+        session = ctx.get_session()
+        pid = project_id or session.default_project_id
+        if not pid:
+            raise click.UsageError("Project ID required.")
+        data = group_mod.get_groups(session, pid, page_index=page, page_size=page_size)
+        ctx.output(data, lambda d: output_json(d))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@group.command("info")
+@click.argument("group_id")
+@pass_context
+def group_info(ctx, group_id):
+    """Get group information."""
+    try:
+        session = ctx.get_session()
+        data = group_mod.get_group_info(session, group_id)
+        ctx.output(data, lambda d: output_kv(d))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@group.command("create")
+@click.option("--project-id", "-p", default="", help="Project/org ID")
+@click.option("--name", "-n", required=True, help="Group name")
+@click.option("--about", "-a", default="", help="Group announcement")
+@click.option("--member", "-m", multiple=True, help="Initial member account IDs")
+@pass_context
+def group_create(ctx, project_id, name, about, member):
+    """Create a new group."""
+    try:
+        session = ctx.get_session()
+        pid = project_id or session.default_project_id
+        if not pid:
+            raise click.UsageError("Project ID required.")
+        data = group_mod.add_group(session, pid, name, about=about, member_ids=list(member) or None)
+        ctx.output(data, lambda d: click.echo(f"Group created: {d}"))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@group.command("delete")
+@click.argument("group_id")
+@click.option("--yes", "-y", is_flag=True, help="Skip confirmation")
+@pass_context
+def group_delete(ctx, group_id, yes):
+    """Delete/disband a group."""
+    try:
+        if not yes:
+            click.confirm(f"Delete group {group_id}?", abort=True)
+        session = ctx.get_session()
+        data = group_mod.remove_group(session, group_id)
+        ctx.output(data, lambda d: click.echo("Group deleted."))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@group.command("members")
+@click.argument("group_id")
+@click.option("--page-size", "-n", default=50, help="Items per page")
+@click.option("--page", default=1, help="Page number")
+@pass_context
+def group_members(ctx, group_id, page_size, page):
+    """List group members."""
+    try:
+        session = ctx.get_session()
+        data = group_mod.get_group_users(session, group_id, page_index=page, page_size=page_size)
+        ctx.output(data, lambda d: output_json(d))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@group.command("remove-member")
+@click.argument("group_id")
+@click.argument("account_id")
+@pass_context
+def group_remove_member(ctx, group_id, account_id):
+    """Remove a member from a group."""
+    try:
+        session = ctx.get_session()
+        data = group_mod.remove_user(session, group_id, account_id)
+        ctx.output(data, lambda d: click.echo("Member removed."))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@group.command("update")
+@click.argument("group_id")
+@click.option("--name", "-n", default="", help="New group name")
+@click.option("--about", "-a", default="", help="New group announcement")
+@pass_context
+def group_update(ctx, group_id, name, about):
+    """Update group name and/or announcement."""
+    try:
+        session = ctx.get_session()
+        if name:
+            data = group_mod.update_group_name(session, group_id, name)
+        if about:
+            data = group_mod.update_group_about(session, group_id, about)
+        if not name and not about:
+            raise click.UsageError("Provide --name or --about to update.")
+        ctx.output(data, lambda d: click.echo("Group updated."))
+    except Exception as e:
+        ctx.handle_error(e)