feat: implementar base entity

php/composer.json

@@ -7,7 +7,10 @@
     "psr-4": {
       "AleBatistella\\BlingErpApi\\": "src/",
       "AleBatistella\\BlingErpApi\\Entities\\Shared": "src/entities/@shared"
-    }
+    },
+    "files": [
+      "src/Helpers/functions.php"
+    ]
   },
   "authors": [
     {

php/src/Entities/@shared/BaseEntity.php

@@ -2,6 +2,39 @@
 
 namespace AleBatistella\BlingErpApi\Entities\Shared;
 
+use AleBatistella\BlingErpApi\Repositories\IBlingRepository;
+
+/**
+ * Entidade base para o projeto.
+ */
 abstract class BaseEntity
 {
+  /**
+   * Constrói o objeto.
+   *
+   * @param IBlingRepository $repository Repositório para conexão com o Bling.
+   */
+  public function __construct(private IBlingRepository $repository)
+  {
+  }
+
+  /**
+   * Prepara um parâmetro de data para chamada do repositório.
+   *
+   * @param \DateTimeInterface|string|null $param Parâmetro do tipo `string`, `\DateTimeInterface` ou `null`
+   *
+   * @return string|null
+   */
+  protected function prepareStringOrDateParam(\DateTimeInterface|string|null $param): string|null
+  {
+    if (is_null($param)) {
+      return null;
+    }
+
+    if (gettype($param) === 'string') {
+      return $param;
+    }
+
+    return convertDateToString($param);
+  }
 }

php/src/Helpers/functions.php

@@ -0,0 +1,15 @@
+<?php
+
+if (!function_exists('convertDateToString')) {
+  /**
+   * Converte uma data para o formato YYYY-MM-DD.
+   *
+   * @param \DateTimeInterface $date
+   *
+   * @return string
+   */
+  function convertDateToString(\DateTimeInterface $date): string
+  {
+    return $date->format('Y-m-d');
+  }
+}