akkoma/lib/pleroma/web/api_spec/schemas/account.ex

# Pleroma: A lightweight social networking server
# Copyright © 2017-2021 Pleroma Authors <https://pleroma.social/>
# SPDX-License-Identifier: AGPL-3.0-only

defmodule Pleroma.Web.ApiSpec.Schemas.Account do
  alias OpenApiSpex.Schema
  alias Pleroma.Web.ApiSpec.Schemas.AccountField
  alias Pleroma.Web.ApiSpec.Schemas.AccountRelationship
  alias Pleroma.Web.ApiSpec.Schemas.ActorType
  alias Pleroma.Web.ApiSpec.Schemas.Emoji
  alias Pleroma.Web.ApiSpec.Schemas.FlakeID
  alias Pleroma.Web.ApiSpec.Schemas.VisibilityScope

  require OpenApiSpex

  OpenApiSpex.schema(%{
    title: "Account",
    description: "Response schema for an account",
    type: :object,
    properties: %{
      acct: %Schema{type: :string},
      avatar_static: %Schema{type: :string, format: :uri},
      avatar: %Schema{type: :string, format: :uri},
      bot: %Schema{type: :boolean},
      created_at: %Schema{type: :string, format: "date-time"},
      display_name: %Schema{type: :string},
      emojis: %Schema{type: :array, items: Emoji},
      fields: %Schema{type: :array, items: AccountField},
      follow_requests_count: %Schema{type: :integer},
      followers_count: %Schema{type: :integer},
      following_count: %Schema{type: :integer},
      header_static: %Schema{type: :string, format: :uri},
      header: %Schema{type: :string, format: :uri},
      id: FlakeID,
      locked: %Schema{type: :boolean},
      note: %Schema{type: :string, format: :html},
      statuses_count: %Schema{type: :integer},
      url: %Schema{type: :string, format: :uri},
      username: %Schema{type: :string},
      pleroma: %Schema{
        type: :object,
        properties: %{
          ap_id: %Schema{type: :string},
          also_known_as: %Schema{type: :array, items: %Schema{type: :string}},
          allow_following_move: %Schema{
            type: :boolean,
            description: "whether the user allows automatically follow moved following accounts"
          },
          background_image: %Schema{type: :string, nullable: true, format: :uri},
          is_confirmed: %Schema{
            type: :boolean,
            description:
              "whether the user account is waiting on email confirmation to be activated"
          },
          hide_favorites: %Schema{type: :boolean},
          hide_followers_count: %Schema{
            type: :boolean,
            description: "whether the user has follower stat hiding enabled"
          },
          hide_followers: %Schema{
            type: :boolean,
            description: "whether the user has follower hiding enabled"
          },
          hide_follows_count: %Schema{
            type: :boolean,
            description: "whether the user has follow stat hiding enabled"
          },
          hide_follows: %Schema{
            type: :boolean,
            description: "whether the user has follow hiding enabled"
          },
          is_admin: %Schema{
            type: :boolean,
            description: "whether the user is an admin of the local instance"
          },
          is_moderator: %Schema{
            type: :boolean,
            description: "whether the user is a moderator of the local instance"
          },
          skip_thread_containment: %Schema{type: :boolean},
          tags: %Schema{
            type: :array,
            items: %Schema{type: :string},
            description:
              "List of tags being used for things like extra roles or moderation(ie. marking all media as nsfw all)."
          },
          unread_conversation_count: %Schema{
            type: :integer,
            description: "The count of unread conversations. Only returned to the account owner."
          },
          notification_settings: %Schema{
            type: :object,
            properties: %{
              block_from_strangers: %Schema{type: :boolean},
              hide_notification_contents: %Schema{type: :boolean}
            }
          },
          relationship: %Schema{allOf: [AccountRelationship], nullable: true},
          settings_store: %Schema{
            type: :object,
            description:
              "A generic map of settings for frontends. Opaque to the backend. Only returned in `verify_credentials` and `update_credentials`"
          },
          favicon: %Schema{
            type: :string,
            format: :uri,
            nullable: true,
            description: "Favicon image of the user's instance"
          }
        }
      },
      akkoma: %Schema{
        type: :object,
        properties: %{
          instance: %Schema{
            type: :object,
            nullable: true,
            properties: %{
              name: %Schema{type: :string},
              favicon: %Schema{type: :string, format: :uri, nullable: true},
              # XXX: proper nodeinfo schema
              nodeinfo: %Schema{type: :object, nullable: true}
            }
          },
          status_ttl_days: %Schema{type: :integer, nullable: true},
          permit_followback: %Schema{type: :boolean}
        }
      },
      source: %Schema{
        type: :object,
        properties: %{
          fields: %Schema{type: :array, items: AccountField},
          note: %Schema{
            type: :string,
            description:
              "Plaintext version of the bio without formatting applied by the backend, used for editing the bio."
          },
          privacy: VisibilityScope,
          sensitive: %Schema{type: :boolean},
          pleroma: %Schema{
            type: :object,
            properties: %{
              actor_type: ActorType,
              discoverable: %Schema{
                type: :boolean,
                description:
                  "whether the user allows indexing / listing of the account by external services (search engines etc.)."
              },
              no_rich_text: %Schema{
                type: :boolean,
                description:
                  "whether the HTML tags for rich-text formatting are stripped from all statuses requested from the API."
              },
              show_role: %Schema{
                type: :boolean,
                description:
                  "whether the user wants their role (e.g admin, moderator) to be shown"
              }
            }
          }
        }
      }
    },
    example: %{
      "acct" => "foobar",
      "avatar" => "https://mypleroma.com/images/avi.png",
      "avatar_static" => "https://mypleroma.com/images/avi.png",
      "bot" => false,
      "created_at" => "2020-03-24T13:05:58.000Z",
      "display_name" => "foobar",
      "emojis" => [],
      "fields" => [],
      "follow_requests_count" => 0,
      "followers_count" => 0,
      "following_count" => 1,
      "header" => "https://mypleroma.com/images/banner.png",
      "header_static" => "https://mypleroma.com/images/banner.png",
      "id" => "9tKi3esbG7OQgZ2920",
      "locked" => false,
      "note" => "cofe",
      "pleroma" => %{
        "allow_following_move" => true,
        "background_image" => nil,
        "is_confirmed" => false,
        "hide_favorites" => true,
        "hide_followers" => false,
        "hide_followers_count" => false,
        "hide_follows" => false,
        "hide_follows_count" => false,
        "is_admin" => false,
        "is_moderator" => false,
        "skip_thread_containment" => false,
        "unread_conversation_count" => 0,
        "tags" => [],
        "notification_settings" => %{
          "block_from_strangers" => false,
          "hide_notification_contents" => false
        },
        "relationship" => %{
          "blocked_by" => false,
          "blocking" => false,
          "domain_blocking" => false,
          "endorsed" => false,
          "followed_by" => false,
          "following" => false,
          "id" => "9tKi3esbG7OQgZ2920",
          "muting" => false,
          "muting_notifications" => false,
          "note" => "",
          "requested" => false,
          "showing_reblogs" => true,
          "subscribing" => false,
          "notifying" => false
        },
        "settings_store" => %{
          "pleroma-fe" => %{}
        }
      },
      "akkoma" => %{
        "instance" => %{
          "name" => "ihatebeinga.live",
          "favicon" => "https://ihatebeinga.live/favicon.png",
          "nodeinfo" =>
            %{
              # XXX: nodeinfo schema
            }
        },
        "status_ttl_days" => nil,
        "permit_followback" => true
      },
      "source" => %{
        "fields" => [],
        "note" => "foobar",
        "pleroma" => %{
          "actor_type" => "Person",
          "discoverable" => false,
          "no_rich_text" => false,
          "show_role" => true
        },
        "privacy" => "public",
        "sensitive" => false
      },
      "statuses_count" => 0,
      "url" => "https://mypleroma.com/users/foobar",
      "username" => "foobar"
    }
  })
end