feat(nextcloud)!: Support notifications 31

Signed-off-by: provokateurin <kate@provokateurin.de>

Author: provokateurin

external/nextcloud-notifications

@@ -319,6 +319,109 @@ class $ApiClient {
     return _i1.ResponseConverter<ApiGenerateNotificationV3ResponseApplicationJson, void>(_serializer)
         .convert(_response);
   }
+
+  /// Builds a serializer to parse the response of [$selfTestPush_Request].
+  @_i2.experimental
+  _i1.DynamiteSerializer<ApiSelfTestPushResponseApplicationJson, void> $selfTestPush_Serializer() =>
+      _i1.DynamiteSerializer(
+        bodyType: const FullType(ApiSelfTestPushResponseApplicationJson),
+        headersType: null,
+        serializers: _$jsonSerializers,
+        validStatuses: const {200, 400},
+      );
+
+  /// Send a test notification to push registered mobile apps.
+  ///
+  /// Required capability: `ocs-endpoints > test-push`.
+  ///
+  /// Returns a `DynamiteRequest` backing the [selfTestPush] operation.
+  /// Throws a `DynamiteApiException` if the API call does not return an expected status code.
+  ///
+  /// Parameters:
+  ///   * [apiVersion3]
+  ///   * [oCSAPIRequest] Required to be true for the API request to pass. Defaults to `true`.
+  ///
+  /// Status codes:
+  ///   * 200: Test notification generated successfully, but the device should still show the message to the user
+  ///   * 400: Test notification could not be generated, show the message to the user
+  ///
+  /// See:
+  ///  * [selfTestPush] for a method executing this request and parsing the response.
+  ///  * [$selfTestPush_Serializer] for a converter to parse the `Response` from an executed this request.
+  @_i2.experimental
+  _i3.Request $selfTestPush_Request({
+    required String apiVersion3,
+    bool? oCSAPIRequest,
+  }) {
+    final _parameters = <String, Object?>{};
+    final __apiVersion3 = _$jsonSerializers.serialize(apiVersion3, specifiedType: const FullType(String));
+    _i6.checkString(
+      __apiVersion3,
+      'apiVersion3',
+      pattern: RegExp(r'^(v3)$'),
+    );
+    _parameters['apiVersion3'] = __apiVersion3;
+
+    final _path = _i4.UriTemplate('/ocs/v2.php/apps/notifications/api/{apiVersion3}/test/self').expand(_parameters);
+    final _uri = Uri.parse('${_rootClient.baseURL}$_path');
+    final _request = _i3.Request('post', _uri);
+    _request.headers['Accept'] = 'application/json';
+// coverage:ignore-start
+    final authentication = _i5.IterableExtension(_rootClient.authentications)?.firstWhereOrNull(
+      (auth) => switch (auth) {
+        _i1.DynamiteHttpBearerAuthentication() || _i1.DynamiteHttpBasicAuthentication() => true,
+        _ => false,
+      },
+    );
+
+    if (authentication != null) {
+      _request.headers.addAll(
+        authentication.headers,
+      );
+    } else {
+      throw Exception('Missing authentication for bearer_auth or basic_auth');
+    }
+
+// coverage:ignore-end
+    var __oCSAPIRequest = _$jsonSerializers.serialize(oCSAPIRequest, specifiedType: const FullType(bool));
+    __oCSAPIRequest ??= true;
+    _request.headers['OCS-APIRequest'] = const _i6.HeaderEncoder().convert(__oCSAPIRequest);
+
+    return _request;
+  }
+
+  /// Send a test notification to push registered mobile apps.
+  ///
+  /// Required capability: `ocs-endpoints > test-push`.
+  ///
+  /// Returns a [Future] containing a `DynamiteResponse` with the status code, deserialized body and headers.
+  /// Throws a `DynamiteApiException` if the API call does not return an expected status code.
+  ///
+  /// Parameters:
+  ///   * [apiVersion3]
+  ///   * [oCSAPIRequest] Required to be true for the API request to pass. Defaults to `true`.
+  ///
+  /// Status codes:
+  ///   * 200: Test notification generated successfully, but the device should still show the message to the user
+  ///   * 400: Test notification could not be generated, show the message to the user
+  ///
+  /// See:
+  ///  * [$selfTestPush_Request] for the request send by this method.
+  ///  * [$selfTestPush_Serializer] for a converter to parse the `Response` from an executed request.
+  Future<_i1.DynamiteResponse<ApiSelfTestPushResponseApplicationJson, void>> selfTestPush({
+    required String apiVersion3,
+    bool? oCSAPIRequest,
+  }) async {
+    final _request = $selfTestPush_Request(
+      apiVersion3: apiVersion3,
+      oCSAPIRequest: oCSAPIRequest,
+    );
+    final _streamedResponse = await _rootClient.httpClient.send(_request);
+    final _response = await _i3.Response.fromStream(_streamedResponse);
+
+    final _serializer = $selfTestPush_Serializer();
+    return _i1.ResponseConverter<ApiSelfTestPushResponseApplicationJson, void>(_serializer).convert(_response);
+  }
 }
 
 class $EndpointClient {
@@ -1608,33 +1711,13 @@ sealed class $ApiGenerateNotificationV3RequestApplicationJsonInterface {
     specifiedType: const FullType(String),
   )! as String;
 
-  static final _$subjectParameters = _$jsonSerializers.deserialize(
-    const {},
-    specifiedType: const FullType(BuiltMap, [
-      FullType(String),
-      FullType(BuiltMap, [FullType(String), FullType(JsonObject)]),
-    ]),
-  )! as BuiltMap<String, BuiltMap<String, JsonObject>>;
-
-  static final _$messageParameters = _$jsonSerializers.deserialize(
-    const {},
-    specifiedType: const FullType(BuiltMap, [
-      FullType(String),
-      FullType(BuiltMap, [FullType(String), FullType(JsonObject)]),
-    ]),
-  )! as BuiltMap<String, BuiltMap<String, JsonObject>>;
-
   /// Subject of the notification.
   String get subject;
 
   /// Message of the notification.
   String get message;
-
-  /// Rich objects to fill the subject placeholders, {@see \OCP\RichObjectStrings\Definitions}.
-  BuiltMap<String, BuiltMap<String, JsonObject>> get subjectParameters;
-
-  /// Rich objects to fill the message placeholders, {@see \OCP\RichObjectStrings\Definitions}.
-  BuiltMap<String, BuiltMap<String, JsonObject>> get messageParameters;
+  BuiltMap<String, BuiltMap<String, JsonObject>>? get subjectParameters;
+  BuiltMap<String, BuiltMap<String, JsonObject>>? get messageParameters;
 
   /// Rebuilds the instance.
   ///
@@ -1650,8 +1733,6 @@ sealed class $ApiGenerateNotificationV3RequestApplicationJsonInterface {
   static void _defaults($ApiGenerateNotificationV3RequestApplicationJsonInterfaceBuilder b) {
     b.subject = _$subject;
     b.message = _$message;
-    b.subjectParameters.replace(_$subjectParameters);
-    b.messageParameters.replace(_$messageParameters);
   }
 
   @BuiltValueHook(finalizeBuilder: true)
@@ -1894,6 +1975,195 @@ abstract class ApiGenerateNotificationV3ResponseApplicationJson
   }
 }
 
+@BuiltValue(instantiable: false)
+sealed class $ApiSelfTestPushResponseApplicationJson_Ocs_DataInterface {
+  String get message;
+
+  /// Rebuilds the instance.
+  ///
+  /// The result is the same as this instance but with [updates] applied.
+  /// [updates] is a function that takes a builder [$ApiSelfTestPushResponseApplicationJson_Ocs_DataInterfaceBuilder].
+  $ApiSelfTestPushResponseApplicationJson_Ocs_DataInterface rebuild(
+    void Function($ApiSelfTestPushResponseApplicationJson_Ocs_DataInterfaceBuilder) updates,
+  );
+
+  /// Converts the instance to a builder [$ApiSelfTestPushResponseApplicationJson_Ocs_DataInterfaceBuilder].
+  $ApiSelfTestPushResponseApplicationJson_Ocs_DataInterfaceBuilder toBuilder();
+  @BuiltValueHook(initializeBuilder: true)
+  static void _defaults($ApiSelfTestPushResponseApplicationJson_Ocs_DataInterfaceBuilder b) {}
+  @BuiltValueHook(finalizeBuilder: true)
+  static void _validate($ApiSelfTestPushResponseApplicationJson_Ocs_DataInterfaceBuilder b) {}
+}
+
+abstract class ApiSelfTestPushResponseApplicationJson_Ocs_Data
+    implements
+        $ApiSelfTestPushResponseApplicationJson_Ocs_DataInterface,
+        Built<ApiSelfTestPushResponseApplicationJson_Ocs_Data, ApiSelfTestPushResponseApplicationJson_Ocs_DataBuilder> {
+  /// Creates a new ApiSelfTestPushResponseApplicationJson_Ocs_Data object using the builder pattern.
+  factory ApiSelfTestPushResponseApplicationJson_Ocs_Data([
+    void Function(ApiSelfTestPushResponseApplicationJson_Ocs_DataBuilder)? b,
+  ]) = _$ApiSelfTestPushResponseApplicationJson_Ocs_Data;
+
+  // coverage:ignore-start
+  const ApiSelfTestPushResponseApplicationJson_Ocs_Data._();
+  // coverage:ignore-end
+
+  /// Creates a new object from the given [json] data.
+  ///
+  /// Use [toJson] to serialize it back into json.
+  // coverage:ignore-start
+  factory ApiSelfTestPushResponseApplicationJson_Ocs_Data.fromJson(Map<String, dynamic> json) =>
+      _$jsonSerializers.deserializeWith(serializer, json)!;
+  // coverage:ignore-end
+
+  /// Parses this object into a json like map.
+  ///
+  /// Use the fromJson factory to revive it again.
+  // coverage:ignore-start
+  Map<String, dynamic> toJson() => _$jsonSerializers.serializeWith(serializer, this)! as Map<String, dynamic>;
+  // coverage:ignore-end
+
+  /// Serializer for ApiSelfTestPushResponseApplicationJson_Ocs_Data.
+  static Serializer<ApiSelfTestPushResponseApplicationJson_Ocs_Data> get serializer =>
+      _$apiSelfTestPushResponseApplicationJsonOcsDataSerializer;
+
+  @BuiltValueHook(initializeBuilder: true)
+  static void _defaults(ApiSelfTestPushResponseApplicationJson_Ocs_DataBuilder b) {
+    $ApiSelfTestPushResponseApplicationJson_Ocs_DataInterface._defaults(b);
+  }
+
+  @BuiltValueHook(finalizeBuilder: true)
+  static void _validate(ApiSelfTestPushResponseApplicationJson_Ocs_DataBuilder b) {
+    $ApiSelfTestPushResponseApplicationJson_Ocs_DataInterface._validate(b);
+  }
+}
+
+@BuiltValue(instantiable: false)
+sealed class $ApiSelfTestPushResponseApplicationJson_OcsInterface {
+  OCSMeta get meta;
+  ApiSelfTestPushResponseApplicationJson_Ocs_Data get data;
+
+  /// Rebuilds the instance.
+  ///
+  /// The result is the same as this instance but with [updates] applied.
+  /// [updates] is a function that takes a builder [$ApiSelfTestPushResponseApplicationJson_OcsInterfaceBuilder].
+  $ApiSelfTestPushResponseApplicationJson_OcsInterface rebuild(
+    void Function($ApiSelfTestPushResponseApplicationJson_OcsInterfaceBuilder) updates,
+  );
+
+  /// Converts the instance to a builder [$ApiSelfTestPushResponseApplicationJson_OcsInterfaceBuilder].
+  $ApiSelfTestPushResponseApplicationJson_OcsInterfaceBuilder toBuilder();
+  @BuiltValueHook(initializeBuilder: true)
+  static void _defaults($ApiSelfTestPushResponseApplicationJson_OcsInterfaceBuilder b) {}
+  @BuiltValueHook(finalizeBuilder: true)
+  static void _validate($ApiSelfTestPushResponseApplicationJson_OcsInterfaceBuilder b) {}
+}
+
+abstract class ApiSelfTestPushResponseApplicationJson_Ocs
+    implements
+        $ApiSelfTestPushResponseApplicationJson_OcsInterface,
+        Built<ApiSelfTestPushResponseApplicationJson_Ocs, ApiSelfTestPushResponseApplicationJson_OcsBuilder> {
+  /// Creates a new ApiSelfTestPushResponseApplicationJson_Ocs object using the builder pattern.
+  factory ApiSelfTestPushResponseApplicationJson_Ocs([
+    void Function(ApiSelfTestPushResponseApplicationJson_OcsBuilder)? b,
+  ]) = _$ApiSelfTestPushResponseApplicationJson_Ocs;
+
+  // coverage:ignore-start
+  const ApiSelfTestPushResponseApplicationJson_Ocs._();
+  // coverage:ignore-end
+
+  /// Creates a new object from the given [json] data.
+  ///
+  /// Use [toJson] to serialize it back into json.
+  // coverage:ignore-start
+  factory ApiSelfTestPushResponseApplicationJson_Ocs.fromJson(Map<String, dynamic> json) =>
+      _$jsonSerializers.deserializeWith(serializer, json)!;
+  // coverage:ignore-end
+
+  /// Parses this object into a json like map.
+  ///
+  /// Use the fromJson factory to revive it again.
+  // coverage:ignore-start
+  Map<String, dynamic> toJson() => _$jsonSerializers.serializeWith(serializer, this)! as Map<String, dynamic>;
+  // coverage:ignore-end
+
+  /// Serializer for ApiSelfTestPushResponseApplicationJson_Ocs.
+  static Serializer<ApiSelfTestPushResponseApplicationJson_Ocs> get serializer =>
+      _$apiSelfTestPushResponseApplicationJsonOcsSerializer;
+
+  @BuiltValueHook(initializeBuilder: true)
+  static void _defaults(ApiSelfTestPushResponseApplicationJson_OcsBuilder b) {
+    $ApiSelfTestPushResponseApplicationJson_OcsInterface._defaults(b);
+  }
+
+  @BuiltValueHook(finalizeBuilder: true)
+  static void _validate(ApiSelfTestPushResponseApplicationJson_OcsBuilder b) {
+    $ApiSelfTestPushResponseApplicationJson_OcsInterface._validate(b);
+  }
+}
+
+@BuiltValue(instantiable: false)
+sealed class $ApiSelfTestPushResponseApplicationJsonInterface {
+  ApiSelfTestPushResponseApplicationJson_Ocs get ocs;
+
+  /// Rebuilds the instance.
+  ///
+  /// The result is the same as this instance but with [updates] applied.
+  /// [updates] is a function that takes a builder [$ApiSelfTestPushResponseApplicationJsonInterfaceBuilder].
+  $ApiSelfTestPushResponseApplicationJsonInterface rebuild(
+    void Function($ApiSelfTestPushResponseApplicationJsonInterfaceBuilder) updates,
+  );
+
+  /// Converts the instance to a builder [$ApiSelfTestPushResponseApplicationJsonInterfaceBuilder].
+  $ApiSelfTestPushResponseApplicationJsonInterfaceBuilder toBuilder();
+  @BuiltValueHook(initializeBuilder: true)
+  static void _defaults($ApiSelfTestPushResponseApplicationJsonInterfaceBuilder b) {}
+  @BuiltValueHook(finalizeBuilder: true)
+  static void _validate($ApiSelfTestPushResponseApplicationJsonInterfaceBuilder b) {}
+}
+
+abstract class ApiSelfTestPushResponseApplicationJson
+    implements
+        $ApiSelfTestPushResponseApplicationJsonInterface,
+        Built<ApiSelfTestPushResponseApplicationJson, ApiSelfTestPushResponseApplicationJsonBuilder> {
+  /// Creates a new ApiSelfTestPushResponseApplicationJson object using the builder pattern.
+  factory ApiSelfTestPushResponseApplicationJson([void Function(ApiSelfTestPushResponseApplicationJsonBuilder)? b]) =
+      _$ApiSelfTestPushResponseApplicationJson;
+
+  // coverage:ignore-start
+  const ApiSelfTestPushResponseApplicationJson._();
+  // coverage:ignore-end
+
+  /// Creates a new object from the given [json] data.
+  ///
+  /// Use [toJson] to serialize it back into json.
+  // coverage:ignore-start
+  factory ApiSelfTestPushResponseApplicationJson.fromJson(Map<String, dynamic> json) =>
+      _$jsonSerializers.deserializeWith(serializer, json)!;
+  // coverage:ignore-end
+
+  /// Parses this object into a json like map.
+  ///
+  /// Use the fromJson factory to revive it again.
+  // coverage:ignore-start
+  Map<String, dynamic> toJson() => _$jsonSerializers.serializeWith(serializer, this)! as Map<String, dynamic>;
+  // coverage:ignore-end
+
+  /// Serializer for ApiSelfTestPushResponseApplicationJson.
+  static Serializer<ApiSelfTestPushResponseApplicationJson> get serializer =>
+      _$apiSelfTestPushResponseApplicationJsonSerializer;
+
+  @BuiltValueHook(initializeBuilder: true)
+  static void _defaults(ApiSelfTestPushResponseApplicationJsonBuilder b) {
+    $ApiSelfTestPushResponseApplicationJsonInterface._defaults(b);
+  }
+
+  @BuiltValueHook(finalizeBuilder: true)
+  static void _validate(ApiSelfTestPushResponseApplicationJsonBuilder b) {
+    $ApiSelfTestPushResponseApplicationJsonInterface._validate(b);
+  }
+}
+
 class EndpointListNotificationsApiVersion extends EnumClass {
   const EndpointListNotificationsApiVersion._(super.name);
 
@@ -4287,6 +4557,21 @@ final Serializers _$serializers = (Serializers().toBuilder()
         ApiGenerateNotificationV3ResponseApplicationJson_Ocs_DataBuilder.new,
       )
       ..add(ApiGenerateNotificationV3ResponseApplicationJson_Ocs_Data.serializer)
+      ..addBuilderFactory(
+        const FullType(ApiSelfTestPushResponseApplicationJson),
+        ApiSelfTestPushResponseApplicationJsonBuilder.new,
+      )
+      ..add(ApiSelfTestPushResponseApplicationJson.serializer)
+      ..addBuilderFactory(
+        const FullType(ApiSelfTestPushResponseApplicationJson_Ocs),
+        ApiSelfTestPushResponseApplicationJson_OcsBuilder.new,
+      )
+      ..add(ApiSelfTestPushResponseApplicationJson_Ocs.serializer)
+      ..addBuilderFactory(
+        const FullType(ApiSelfTestPushResponseApplicationJson_Ocs_Data),
+        ApiSelfTestPushResponseApplicationJson_Ocs_DataBuilder.new,
+      )
+      ..add(ApiSelfTestPushResponseApplicationJson_Ocs_Data.serializer)
       ..add(EndpointListNotificationsApiVersion.serializer)
       ..addBuilderFactory(
         const FullType(EndpointListNotificationsResponseApplicationJson),