hap-cli 0.5.0__py3-none-any.whl

hap_cli/core/record.py

@@ -0,0 +1,268 @@
+"""Record CRUD module for MingDAO HAP."""
+
+from typing import Any, Optional
+
+from hap_cli.core.session import Session
+
+
+def get_records(
+    session: Session,
+    worksheet_id: str,
+    view_id: str = "",
+    page_size: int = 50,
+    page_index: int = 1,
+    sort_id: str = "",
+    is_asc: bool = False,
+    keywords: str = "",
+    filters: Optional[list] = None,
+    search_type: int = 1,
+) -> dict[str, Any]:
+    """Query records with filtering and pagination.
+
+    Args:
+        session: Active session
+        worksheet_id: Worksheet ID
+        view_id: Optional view ID
+        page_size: Number of records per page (max 1000)
+        page_index: Page number (1-based)
+        sort_id: Field ID to sort by
+        is_asc: Sort ascending
+        keywords: Search keywords
+        filters: Filter conditions list
+        search_type: Search type (1=default)
+
+    Returns:
+        Dict with 'data' (records list) and 'count' (total)
+    """
+    data: dict[str, Any] = {
+        "worksheetId": worksheet_id,
+        "pageSize": min(page_size, 1000),
+        "pageIndex": page_index,
+        "searchType": search_type,
+    }
+    if view_id:
+        data["viewId"] = view_id
+    if sort_id:
+        data["sortId"] = sort_id
+        data["isAsc"] = is_asc
+    if keywords:
+        data["keyWords"] = keywords
+    if filters:
+        data["filterControls"] = filters
+
+    result = session.api_call("Worksheet", "GetFilterRows", data)
+    return {
+        "data": result.get("data", result.get("rows", [])),
+        "count": result.get("count", result.get("total", 0)),
+    }
+
+
+def get_record(
+    session: Session,
+    worksheet_id: str,
+    row_id: str,
+    view_id: str = "",
+) -> dict[str, Any]:
+    """Get a single record by ID.
+
+    Args:
+        session: Active session
+        worksheet_id: Worksheet ID
+        row_id: Record/row ID
+        view_id: Optional view ID
+
+    Returns:
+        Record detail dict
+    """
+    data: dict[str, Any] = {
+        "worksheetId": worksheet_id,
+        "rowId": row_id,
+    }
+    if view_id:
+        data["viewId"] = view_id
+    return session.api_call("Worksheet", "GetRowDetail", data)
+
+
+def create_record(
+    session: Session,
+    worksheet_id: str,
+    controls: list[dict[str, Any]],
+    trigger_workflow: bool = True,
+) -> dict[str, Any]:
+    """Create a new record.
+
+    Args:
+        session: Active session
+        worksheet_id: Worksheet ID
+        controls: List of {controlId, value} dicts
+        trigger_workflow: Whether to trigger workflows
+
+    Returns:
+        Created record info
+    """
+    return session.api_call(
+        "Worksheet",
+        "AddWorksheetRow",
+        {
+            "worksheetId": worksheet_id,
+            "receiveControls": controls,
+            "triggerWorkflow": trigger_workflow,
+        },
+    )
+
+
+def update_record(
+    session: Session,
+    worksheet_id: str,
+    row_id: str,
+    controls: list[dict[str, Any]],
+    trigger_workflow: bool = True,
+) -> dict[str, Any]:
+    """Update an existing record.
+
+    Args:
+        session: Active session
+        worksheet_id: Worksheet ID
+        row_id: Record/row ID
+        controls: List of {controlId, value} dicts
+        trigger_workflow: Whether to trigger workflows
+
+    Returns:
+        Update result
+    """
+    return session.api_call(
+        "Worksheet",
+        "UpdateWorksheetRow",
+        {
+            "worksheetId": worksheet_id,
+            "rowId": row_id,
+            "newOldControl": controls,
+            "triggerWorkflow": trigger_workflow,
+        },
+    )
+
+
+def delete_records(
+    session: Session,
+    worksheet_id: str,
+    row_ids: list[str],
+) -> dict[str, Any]:
+    """Delete records by IDs.
+
+    Args:
+        session: Active session
+        worksheet_id: Worksheet ID
+        row_ids: List of record/row IDs to delete
+
+    Returns:
+        Deletion result
+    """
+    return session.api_call(
+        "Worksheet",
+        "DeleteWorksheetRows",
+        {
+            "worksheetId": worksheet_id,
+            "rowIds": row_ids,
+        },
+    )
+
+
+# ── Discussion ───────────────────────────────────────────────────────────
+
+
+def get_discussions(
+    session: Session,
+    source_id: str,
+    source_type: int = 7,
+    page_index: int = 1,
+    page_size: int = 20,
+    keywords: str = "",
+) -> dict[str, Any]:
+    """Get discussions for a record.
+
+    Args:
+        source_type: 7=worksheet record (default)
+    """
+    data: dict[str, Any] = {
+        "sourceId": source_id,
+        "sourceType": source_type,
+        "pageIndex": page_index,
+        "pageSize": page_size,
+    }
+    if keywords:
+        data["keywords"] = keywords
+    return session.api_call("Discussion", "GetDiscussions", data)
+
+
+def add_discussion(
+    session: Session,
+    source_id: str,
+    message: str,
+    source_type: int = 7,
+    reply_id: str = "",
+    app_id: str = "",
+) -> dict[str, Any]:
+    """Add a discussion/comment to a record."""
+    data: dict[str, Any] = {
+        "sourceId": source_id,
+        "sourceType": source_type,
+        "message": message,
+    }
+    if reply_id:
+        data["replyId"] = reply_id
+    if app_id:
+        data["appId"] = app_id
+    return session.api_call("Discussion", "AddDiscussion", data)
+
+
+def remove_discussion(
+    session: Session, discussion_id: str, source_type: int = 7,
+) -> dict[str, Any]:
+    """Remove a discussion/comment."""
+    return session.api_call(
+        "Discussion", "RemoveDiscussion",
+        {"discussionId": discussion_id, "sourceType": source_type},
+    )
+
+
+# ── Pivot / Report ───────────────────────────────────────────────────────
+
+
+def get_pivot_data(
+    session: Session,
+    worksheet_id: str,
+    view_id: str = "",
+    app_id: str = "",
+    filters: Optional[list] = None,
+) -> dict[str, Any]:
+    """Get pivot table / report data for a worksheet."""
+    data: dict[str, Any] = {"worksheetId": worksheet_id}
+    if view_id:
+        data["viewId"] = view_id
+    if app_id:
+        data["appId"] = app_id
+    if filters:
+        data["filterControls"] = filters
+    return session.api_call("Worksheet", "GetFilterRowsReport", data)
+
+
+# ── Record Logs ──────────────────────────────────────────────────────────
+
+
+def get_record_logs(
+    session: Session,
+    worksheet_id: str,
+    row_id: str,
+    page_index: int = 1,
+    page_size: int = 50,
+) -> dict[str, Any]:
+    """Get operation logs for a specific record."""
+    return session.api_call(
+        "Worksheet", "GetLogs",
+        {
+            "worksheetId": worksheet_id,
+            "rowId": row_id,
+            "pageIndex": page_index,
+            "pageSize": page_size,
+        },
+    )

hap_cli/core/role.py

@@ -0,0 +1,227 @@
+"""Role management module for MingDAO HAP."""
+
+from typing import Any, Optional
+
+from hap_cli.core.session import Session
+
+
+def get_roles(
+    session: Session,
+    app_id: str,
+) -> list[dict[str, Any]]:
+    """List roles for an application.
+
+    Args:
+        session: Active session
+        app_id: Application ID
+
+    Returns:
+        List of role dicts
+    """
+    result = session.api_call("AppManagement", "GetRoleList", {"appId": app_id})
+    if isinstance(result, list):
+        return result
+    return result.get("list", result.get("roles", []))
+
+
+def create_role(
+    session: Session,
+    app_id: str,
+    name: str,
+    description: str = "",
+    permission_way: int = 10,
+    project_id: str = "",
+) -> dict[str, Any]:
+    """Create a new role.
+
+    Args:
+        session: Active session
+        app_id: Application ID
+        name: Role name
+        description: Role description
+        permission_way: Permission type (0=custom, 10=readonly, 50=member, 100=admin)
+        project_id: Project/organization ID
+
+    Returns:
+        Created role info
+    """
+    data: dict[str, Any] = {
+        "appId": app_id,
+        "name": name,
+        "permissionWay": permission_way,
+    }
+    if description:
+        data["description"] = description
+    if project_id:
+        data["projectId"] = project_id
+    return session.api_call("AppManagement", "AddRole", data)
+
+
+def delete_role(
+    session: Session,
+    app_id: str,
+    role_id: str,
+    target_role_id: str = "",
+    project_id: str = "",
+) -> dict[str, Any]:
+    """Delete a role and optionally move members.
+
+    Args:
+        session: Active session
+        app_id: Application ID
+        role_id: Role ID to delete
+        target_role_id: Move members to this role
+        project_id: Project/organization ID
+
+    Returns:
+        Deletion result
+    """
+    data: dict[str, Any] = {"appId": app_id, "roleId": role_id}
+    if target_role_id:
+        data["resultRoleId"] = target_role_id
+    if project_id:
+        data["projectId"] = project_id
+    return session.api_call("AppManagement", "RemoveRole", data)
+
+
+def add_role_members(
+    session: Session,
+    app_id: str,
+    role_id: str,
+    user_ids: Optional[list[str]] = None,
+    department_ids: Optional[list[str]] = None,
+    project_id: str = "",
+) -> dict[str, Any]:
+    """Add members to a role.
+
+    Args:
+        session: Active session
+        app_id: Application ID
+        role_id: Role ID
+        user_ids: User IDs to add
+        department_ids: Department IDs to add
+        project_id: Project/organization ID
+
+    Returns:
+        Result
+    """
+    data: dict[str, Any] = {"appId": app_id, "roleId": role_id}
+    if user_ids:
+        data["userIds"] = user_ids
+    if department_ids:
+        data["departmentIds"] = department_ids
+    if project_id:
+        data["projectId"] = project_id
+    return session.api_call("AppManagement", "AddRoleMembers", data)
+
+
+def remove_role_members(
+    session: Session,
+    app_id: str,
+    role_id: str,
+    user_ids: Optional[list[str]] = None,
+    department_ids: Optional[list[str]] = None,
+    project_id: str = "",
+) -> dict[str, Any]:
+    """Remove members from a role.
+
+    Args:
+        session: Active session
+        app_id: Application ID
+        role_id: Role ID
+        user_ids: User IDs to remove
+        department_ids: Department IDs to remove
+        project_id: Project/organization ID
+
+    Returns:
+        Result
+    """
+    data: dict[str, Any] = {"appId": app_id, "roleId": role_id}
+    if user_ids:
+        data["userIds"] = user_ids
+    if department_ids:
+        data["departmentIds"] = department_ids
+    if project_id:
+        data["projectId"] = project_id
+    return session.api_call("AppManagement", "RemoveRoleMembers", data)
+
+
+# ── Role permissions ─────────────────────────────────────────────────────
+
+
+def get_role_detail(
+    session: Session, app_id: str, role_id: str,
+) -> dict[str, Any]:
+    """Get role detail including permissions."""
+    return session.api_call(
+        "AppManagement", "GetRoleDetail",
+        {"appId": app_id, "roleId": role_id},
+    )
+
+
+def edit_role(
+    session: Session,
+    app_id: str,
+    role_id: str,
+    permission_way: int = 0,
+    permissions: Optional[list[dict]] = None,
+) -> dict[str, Any]:
+    """Edit role permissions."""
+    data: dict[str, Any] = {
+        "appId": app_id,
+        "roleId": role_id,
+        "permissionWay": permission_way,
+    }
+    if permissions:
+        data["permissions"] = permissions
+    return session.api_call("AppManagement", "EditRole", data)
+
+
+def rename_role(
+    session: Session, app_id: str, role_id: str, name: str,
+) -> dict[str, Any]:
+    """Rename a role."""
+    return session.api_call(
+        "AppManagement", "EditRoleName",
+        {"appId": app_id, "roleId": role_id, "name": name},
+    )
+
+
+def apply_role(
+    session: Session, app_id: str, role_id: str,
+) -> dict[str, Any]:
+    """Apply to join a role."""
+    return session.api_call(
+        "AppManagement", "ApplyRole",
+        {"appId": app_id, "roleId": role_id},
+    )
+
+
+def approve_role_apply(
+    session: Session, app_id: str, role_id: str, account_id: str,
+) -> dict[str, Any]:
+    """Approve a user's role application."""
+    return session.api_call(
+        "AppManagement", "AgreeUserToRole",
+        {"appId": app_id, "roleId": role_id, "accountId": account_id},
+    )
+
+
+def reject_role_apply(
+    session: Session, app_id: str, role_id: str, account_id: str,
+) -> dict[str, Any]:
+    """Reject a user's role application."""
+    return session.api_call(
+        "AppManagement", "RefuseUserToRole",
+        {"appId": app_id, "roleId": role_id, "accountId": account_id},
+    )
+
+
+def get_pending_role_users(
+    session: Session, app_id: str,
+) -> dict[str, Any]:
+    """Get users with pending role applications."""
+    return session.api_call(
+        "AppManagement", "GetUnauditedUserDetail",
+        {"appId": app_id},
+    )