From a51a5e352cf3712d23ba8f095211dd3e13799863 Mon Sep 17 00:00:00 2001
From: eileen <emcnaughton@wikimedia.org>
Date: Mon, 23 Nov 2020 14:18:28 +1300
Subject: [PATCH] Add Grant v4 api

I created a spec provider for a default currency as I didn't think it made sense to require it

Update APIv4 Grant docblock
---
 Civi/Api4/Grant.php                           | 32 +++++++++++++
 .../Provider/FieldCurrencySpecProvider.php    | 45 +++++++++++++++++++
 2 files changed, 77 insertions(+)
 create mode 100644 Civi/Api4/Grant.php
 create mode 100644 Civi/Api4/Service/Spec/Provider/FieldCurrencySpecProvider.php

diff --git a/Civi/Api4/Grant.php b/Civi/Api4/Grant.php
new file mode 100644
index 0000000000..a0dc1dfd98
--- /dev/null
+++ b/Civi/Api4/Grant.php
@@ -0,0 +1,32 @@
+<?php
+
+/*
+ +--------------------------------------------------------------------+
+ | Copyright CiviCRM LLC. All rights reserved.                        |
+ |                                                                    |
+ | This work is published under the GNU AGPLv3 license with some      |
+ | permitted exceptions and without any warranty. For full license    |
+ | and copyright information, see https://civicrm.org/licensing       |
+ +--------------------------------------------------------------------+
+ */
+
+/**
+ *
+ * @package CRM
+ * @copyright CiviCRM LLC https://civicrm.org/licensing
+ */
+
+namespace Civi\Api4;
+
+/**
+ * Grant entity.
+ *
+ * Grants are designed to be used by organisations that distribute funds to others.
+ *
+ * @see https://docs.civicrm.org/user/en/latest/grants/what-is-civigrant/
+ *
+ * @package Civi\Api4
+ */
+class Grant extends Generic\DAOEntity {
+
+}
diff --git a/Civi/Api4/Service/Spec/Provider/FieldCurrencySpecProvider.php b/Civi/Api4/Service/Spec/Provider/FieldCurrencySpecProvider.php
new file mode 100644
index 0000000000..458e528774
--- /dev/null
+++ b/Civi/Api4/Service/Spec/Provider/FieldCurrencySpecProvider.php
@@ -0,0 +1,45 @@
+<?php
+
+/*
+ +--------------------------------------------------------------------+
+ | Copyright CiviCRM LLC. All rights reserved.                        |
+ |                                                                    |
+ | This work is published under the GNU AGPLv3 license with some      |
+ | permitted exceptions and without any warranty. For full license    |
+ | and copyright information, see https://civicrm.org/licensing       |
+ +--------------------------------------------------------------------+
+ */
+
+/**
+ *
+ * @package CRM
+ * @copyright CiviCRM LLC https://civicrm.org/licensing
+ */
+
+
+namespace Civi\Api4\Service\Spec\Provider;
+
+use Civi\Api4\Service\Spec\RequestSpec;
+
+class FieldCurrencySpecProvider implements Generic\SpecProviderInterface {
+
+  /**
+   * Generic create spec function to set sensible defaults for any entity with a "currency" field.
+   *
+   * @param \Civi\Api4\Service\Spec\RequestSpec $spec
+   */
+  public function modifySpec(RequestSpec $spec): void {
+    $currencyField = $spec->getFieldByName('currency');
+    if ($currencyField && $currencyField->isRequired()) {
+      $currencyField->setRequired(FALSE)->setDefaultValue(\CRM_Core_Config::singleton()->defaultCurrency);
+    }
+  }
+
+  /**
+   * @inheritDoc
+   */
+  public function applies($entity, $action) {
+    return $action === 'create';
+  }
+
+}
-- 
2.25.1