1 files changed, 110 insertions, 0 deletions
diff --git a/www/crm/wp-content/plugins/civicrm/civicrm/ext/api4/Civi/Api4/Service/Spec/RequestSpec.php b/www/crm/wp-content/plugins/civicrm/civicrm/ext/api4/Civi/Api4/Service/Spec/RequestSpec.php
new file mode 100644
index 00000000..9437d930
--- /dev/null
+++ b/www/crm/wp-content/plugins/civicrm/civicrm/ext/api4/Civi/Api4/Service/Spec/RequestSpec.php
@@ -0,0 +1,110 @@
+<?php
+
+namespace Civi\Api4\Service\Spec;
+
+class RequestSpec {
+
+  /**
+   * @var string
+   */
+  protected $entity;
+
+  /**
+   * @var string
+   */
+  protected $action;
+
+  /**
+   * @var FieldSpec[]
+   */
+  protected $fields = [];
+
+  /**
+   * @param string $entity
+   * @param string $action
+   */
+  public function __construct($entity, $action) {
+    $this->entity = $entity;
+    $this->action = $action;
+  }
+
+  public function addFieldSpec(FieldSpec $field) {
+    $this->fields[] = $field;
+  }
+
+  /**
+   * @param $name
+   *
+   * @return FieldSpec|null
+   */
+  public function getFieldByName($name) {
+    foreach ($this->fields as $field) {
+      if ($field->getName() === $name) {
+        return $field;
+      }
+    }
+
+    return NULL;
+  }
+
+  /**
+   * @return array
+   *   Gets all the field names currently part of the specification
+   */
+  public function getFieldNames() {
+    return array_map(function(FieldSpec $field) {
+      return $field->getName();
+    }, $this->fields);
+  }
+
+  /**
+   * @return array|FieldSpec[]
+   */
+  public function getRequiredFields() {
+    return array_filter($this->fields, function (FieldSpec $field) {
+      return $field->isRequired();
+    });
+  }
+
+  /**
+   * @return array|FieldSpec[]
+   */
+  public function getConditionalRequiredFields() {
+    return array_filter($this->fields, function (FieldSpec $field) {
+      return $field->getRequiredIf();
+    });
+  }
+
+  /**
+   * @param array $fieldNames
+   *   Optional array of fields to return
+   * @return FieldSpec[]
+   */
+  public function getFields($fieldNames = NULL) {
+    if (!$fieldNames) {
+      return $this->fields;
+    }
+    $fields = [];
+    foreach ($this->fields as $field) {
+      if (in_array($field->getName(), $fieldNames)) {
+        $fields[] = $field;
+      }
+    }
+    return $fields;
+  }
+
+  /**
+   * @return string
+   */
+  public function getEntity() {
+    return $this->entity;
+  }
+
+  /**
+   * @return string
+   */
+  public function getAction() {
+    return $this->action;
+  }
+
+}