git.squeep.com Git - akkoma/blob - lib/pleroma/web/api_spec/operations/subscription_operation.ex

   1 # Pleroma: A lightweight social networking server
   2 # Copyright © 2017-2021 Pleroma Authors <https://pleroma.social/>
   3 # SPDX-License-Identifier: AGPL-3.0-only
   4
   5 defmodule Pleroma.Web.ApiSpec.SubscriptionOperation do
   6   alias OpenApiSpex.Operation
   7   alias OpenApiSpex.Schema
   8   alias Pleroma.Web.ApiSpec.Helpers
   9   alias Pleroma.Web.ApiSpec.Schemas.ApiError
  10   alias Pleroma.Web.ApiSpec.Schemas.BooleanLike
  11   alias Pleroma.Web.ApiSpec.Schemas.PushSubscription
  12
  13   def open_api_operation(action) do
  14     operation = String.to_existing_atom("#{action}_operation")
  15     apply(__MODULE__, operation, [])
  16   end
  17
  18   def create_operation do
  19     %Operation{
  20       tags: ["Push subscriptions"],
  21       summary: "Subscribe to push notifications",
  22       description:
  23         "Add a Web Push API subscription to receive notifications. Each access token can have one push subscription. If you create a new subscription, the old subscription is deleted.",
  24       operationId: "SubscriptionController.create",
  25       security: [%{"oAuth" => ["push"]}],
  26       requestBody: Helpers.request_body("Parameters", create_request(), required: true),
  27       responses: %{
  28         200 => Operation.response("Push subscription", "application/json", PushSubscription),
  29         400 => Operation.response("Error", "application/json", ApiError),
  30         403 => Operation.response("Error", "application/json", ApiError)
  31       }
  32     }
  33   end
  34
  35   def show_operation do
  36     %Operation{
  37       tags: ["Push subscriptions"],
  38       summary: "Get current subscription",
  39       description: "View the PushSubscription currently associated with this access token.",
  40       operationId: "SubscriptionController.show",
  41       security: [%{"oAuth" => ["push"]}],
  42       responses: %{
  43         200 => Operation.response("Push subscription", "application/json", PushSubscription),
  44         403 => Operation.response("Error", "application/json", ApiError),
  45         404 => Operation.response("Error", "application/json", ApiError)
  46       }
  47     }
  48   end
  49
  50   def update_operation do
  51     %Operation{
  52       tags: ["Push subscriptions"],
  53       summary: "Change types of notifications",
  54       description:
  55         "Updates the current push subscription. Only the data part can be updated. To change fundamentals, a new subscription must be created instead.",
  56       operationId: "SubscriptionController.update",
  57       security: [%{"oAuth" => ["push"]}],
  58       requestBody: Helpers.request_body("Parameters", update_request(), required: true),
  59       responses: %{
  60         200 => Operation.response("Push subscription", "application/json", PushSubscription),
  61         403 => Operation.response("Error", "application/json", ApiError)
  62       }
  63     }
  64   end
  65
  66   def delete_operation do
  67     %Operation{
  68       tags: ["Push subscriptions"],
  69       summary: "Remove current subscription",
  70       description: "Removes the current Web Push API subscription.",
  71       operationId: "SubscriptionController.delete",
  72       security: [%{"oAuth" => ["push"]}],
  73       responses: %{
  74         200 => Operation.response("Empty object", "application/json", %Schema{type: :object}),
  75         403 => Operation.response("Error", "application/json", ApiError),
  76         404 => Operation.response("Error", "application/json", ApiError)
  77       }
  78     }
  79   end
  80
  81   defp create_request do
  82     %Schema{
  83       title: "SubscriptionCreateRequest",
  84       description: "POST body for creating a push subscription",
  85       type: :object,
  86       properties: %{
  87         subscription: %Schema{
  88           type: :object,
  89           properties: %{
  90             endpoint: %Schema{
  91               type: :string,
  92               description: "Endpoint URL that is called when a notification event occurs."
  93             },
  94             keys: %Schema{
  95               type: :object,
  96               properties: %{
  97                 p256dh: %Schema{
  98                   type: :string,
  99                   description:
 100                     "User agent public key. Base64 encoded string of public key of ECDH key using `prime256v1` curve."
 101                 },
 102                 auth: %Schema{
 103                   type: :string,
 104                   description: "Auth secret. Base64 encoded string of 16 bytes of random data."
 105                 }
 106               },
 107               required: [:p256dh, :auth]
 108             }
 109           },
 110           required: [:endpoint, :keys]
 111         },
 112         data: %Schema{
 113           nullable: true,
 114           type: :object,
 115           properties: %{
 116             alerts: %Schema{
 117               nullable: true,
 118               type: :object,
 119               properties: %{
 120                 follow: %Schema{
 121                   allOf: [BooleanLike],
 122                   nullable: true,
 123                   description: "Receive follow notifications?"
 124                 },
 125                 favourite: %Schema{
 126                   allOf: [BooleanLike],
 127                   nullable: true,
 128                   description: "Receive favourite notifications?"
 129                 },
 130                 reblog: %Schema{
 131                   allOf: [BooleanLike],
 132                   nullable: true,
 133                   description: "Receive reblog notifications?"
 134                 },
 135                 mention: %Schema{
 136                   allOf: [BooleanLike],
 137                   nullable: true,
 138                   description: "Receive mention notifications?"
 139                 },
 140                 poll: %Schema{
 141                   allOf: [BooleanLike],
 142                   nullable: true,
 143                   description: "Receive poll notifications?"
 144                 },
 145                 "pleroma:emoji_reaction": %Schema{
 146                   allOf: [BooleanLike],
 147                   nullable: true,
 148                   description: "Receive emoji reaction notifications?"
 149                 }
 150               }
 151             }
 152           }
 153         }
 154       },
 155       required: [:subscription],
 156       example: %{
 157         "subscription" => %{
 158           "endpoint" => "https://example.com/example/1234",
 159           "keys" => %{
 160             "auth" => "8eDyX_uCN0XRhSbY5hs7Hg==",
 161             "p256dh" =>
 162               "BCIWgsnyXDv1VkhqL2P7YRBvdeuDnlwAPT2guNhdIoW3IP7GmHh1SMKPLxRf7x8vJy6ZFK3ol2ohgn_-0yP7QQA="
 163           }
 164         },
 165         "data" => %{
 166           "alerts" => %{
 167             "follow" => true,
 168             "mention" => true,
 169             "poll" => false
 170           }
 171         }
 172       }
 173     }
 174   end
 175
 176   defp update_request do
 177     %Schema{
 178       title: "SubscriptionUpdateRequest",
 179       type: :object,
 180       properties: %{
 181         data: %Schema{
 182           nullable: true,
 183           type: :object,
 184           properties: %{
 185             alerts: %Schema{
 186               nullable: true,
 187               type: :object,
 188               properties: %{
 189                 follow: %Schema{
 190                   allOf: [BooleanLike],
 191                   nullable: true,
 192                   description: "Receive follow notifications?"
 193                 },
 194                 favourite: %Schema{
 195                   allOf: [BooleanLike],
 196                   nullable: true,
 197                   description: "Receive favourite notifications?"
 198                 },
 199                 reblog: %Schema{
 200                   allOf: [BooleanLike],
 201                   nullable: true,
 202                   description: "Receive reblog notifications?"
 203                 },
 204                 mention: %Schema{
 205                   allOf: [BooleanLike],
 206                   nullable: true,
 207                   description: "Receive mention notifications?"
 208                 },
 209                 poll: %Schema{
 210                   allOf: [BooleanLike],
 211                   nullable: true,
 212                   description: "Receive poll notifications?"
 213                 },
 214                 "pleroma:emoji_reaction": %Schema{
 215                   allOf: [BooleanLike],
 216                   nullable: true,
 217                   description: "Receive emoji reaction notifications?"
 218                 }
 219               }
 220             }
 221           }
 222         }
 223       },
 224       example: %{
 225         "data" => %{
 226           "alerts" => %{
 227             "follow" => true,
 228             "favourite" => true,
 229             "reblog" => true,
 230             "mention" => true,
 231             "poll" => true
 232           }
 233         }
 234       }
 235     }
 236   end
 237 end