@e22m4u/js-repository 0.1.4 → 0.1.5

package/README.md

@@ -39,7 +39,7 @@ npm install @e22m4u/js-repository
 - *Модель* - описывает структуру документа и связи к другим моделям
 - *Репозиторий* - выполняет операции чтения и записи документов модели
 
-![Схема](assets/mermaid-diagram.png "Схема")
+<img alt="Схема" src="https://gitflic.ru/project/e22m4u/js-repository/blob/raw?file=assets%2Fmermaid-diagram.png&commit=39e53768b4ea62cafe60522e14d1fa9ddd42ebd5">
 
 ## Пример
 
@@ -278,11 +278,12 @@ schema.defineModel({
 
 ## Валидаторы
 
-Кроме проверки типа, более конкретные условия можно задать с помощью
+Кроме базовой проверки типа, дополнительные условия можно задать с помощью
 валидаторов, через которые будет проходить значение перед записью в базу.
 
 - `minLength: number` минимальная длинна строки или массива
 - `maxLength: number` максимальная длинна строки или массива
+- `regexp: string | RegExp` проверка по регулярному выражению
 
 **Пример**
 

package/docs/index.html

@@ -41,7 +41,8 @@
 <li><em>Модель</em> - описывает структуру документа и связи к другим моделям</li>
 <li><em>Репозиторий</em> - выполняет операции чтения и записи документов модели</li>
 </ul>
-<p><img src="assets/mermaid-diagram.png" alt="Схема" title="Схема"></p>
+<img alt="Схема" src="https://gitflic.ru/project/e22m4u/js-repository/blob/raw?file=assets%2Fmermaid-diagram.png&commit=39e53768b4ea62cafe60522e14d1fa9ddd42ebd5">
+
 <a id="md:пример" class="tsd-anchor"></a><h2><a href="#md:пример">Пример</a></h2><p>Определение источника данных, модели и добавление нового документа в коллекцию.</p>
 <pre><code class="language-js"><span class="hl-3">import</span><span class="hl-1"> {</span><span class="hl-4">Schema</span><span class="hl-1">} </span><span class="hl-3">from</span><span class="hl-1"> </span><span class="hl-2">&#39;@e22m4u/js-repository&#39;</span><span class="hl-1">;</span><br/><span class="hl-3">import</span><span class="hl-1"> {</span><span class="hl-4">DataType</span><span class="hl-1">} </span><span class="hl-3">from</span><span class="hl-1"> </span><span class="hl-2">&#39;@e22m4u/js-repository&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-5">// создание экземпляра Schema</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">schema</span><span class="hl-1"> = </span><span class="hl-6">new</span><span class="hl-1"> </span><span class="hl-0">Schema</span><span class="hl-1">();</span><br/><br/><span class="hl-5">// определение источника &quot;myMemory&quot;</span><br/><span class="hl-4">schema</span><span class="hl-1">.</span><span class="hl-0">defineDatasource</span><span class="hl-1">({</span><br/><span class="hl-1">  </span><span class="hl-4">name:</span><span class="hl-1"> </span><span class="hl-2">&#39;myMemory&#39;</span><span class="hl-1">, </span><span class="hl-5">// название нового источника</span><br/><span class="hl-1">  </span><span class="hl-4">adapter:</span><span class="hl-1"> </span><span class="hl-2">&#39;memory&#39;</span><span class="hl-1">, </span><span class="hl-5">// выбранный адаптер</span><br/><span class="hl-1">});</span><br/><br/><span class="hl-5">// определение модели &quot;country&quot;</span><br/><span class="hl-4">schema</span><span class="hl-1">.</span><span class="hl-0">defineModel</span><span class="hl-1">({</span><br/><span class="hl-1">  </span><span class="hl-4">name:</span><span class="hl-1"> </span><span class="hl-2">&#39;country&#39;</span><span class="hl-1">, </span><span class="hl-5">// название новой модели</span><br/><span class="hl-1">  </span><span class="hl-4">datasource:</span><span class="hl-1"> </span><span class="hl-2">&#39;myMemory&#39;</span><span class="hl-1">, </span><span class="hl-5">// выбранный источник</span><br/><span class="hl-1">  </span><span class="hl-4">properties:</span><span class="hl-1"> { </span><span class="hl-5">// свойства модели</span><br/><span class="hl-1">    </span><span class="hl-4">name:</span><span class="hl-1"> </span><span class="hl-4">DataType</span><span class="hl-1">.</span><span class="hl-7">STRING</span><span class="hl-1">, </span><span class="hl-5">// тип &quot;string&quot;</span><br/><span class="hl-1">    </span><span class="hl-4">population:</span><span class="hl-1"> </span><span class="hl-4">DataType</span><span class="hl-1">.</span><span class="hl-7">NUMBER</span><span class="hl-1">, </span><span class="hl-5">// тип &quot;number&quot;</span><br/><span class="hl-1">  },</span><br/><span class="hl-1">})</span><br/><br/><span class="hl-5">// получение репозитория для модели &quot;country&quot;</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">countryRep</span><span class="hl-1"> = </span><span class="hl-4">schema</span><span class="hl-1">.</span><span class="hl-0">getRepository</span><span class="hl-1">(</span><span class="hl-2">&#39;country&#39;</span><span class="hl-1">);</span><br/><br/><span class="hl-5">// добавление нового документа в коллекцию &quot;country&quot;</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">country</span><span class="hl-1"> = </span><span class="hl-3">await</span><span class="hl-1"> </span><span class="hl-4">countryRep</span><span class="hl-1">.</span><span class="hl-0">create</span><span class="hl-1">({</span><br/><span class="hl-1">  </span><span class="hl-4">name:</span><span class="hl-1"> </span><span class="hl-2">&#39;Russia&#39;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-4">population:</span><span class="hl-1"> </span><span class="hl-8">143400000</span><span class="hl-1">,</span><br/><span class="hl-1">});</span><br/><br/><span class="hl-5">// вывод результата</span><br/><span class="hl-4">console</span><span class="hl-1">.</span><span class="hl-0">log</span><span class="hl-1">(</span><span class="hl-4">country</span><span class="hl-1">);</span><br/><span class="hl-5">// {</span><br/><span class="hl-5">//   &quot;id&quot;: 1,</span><br/><span class="hl-5">//   &quot;name&quot;: &quot;Russia&quot;,</span><br/><span class="hl-5">//   &quot;population&quot;: 143400000,</span><br/><span class="hl-5">// }</span>
 </code><button>Copy</button></pre>
@@ -130,11 +131,12 @@
 определено в момент записи документа.</p>
 <pre><code class="language-js"><span class="hl-4">schema</span><span class="hl-1">.</span><span class="hl-0">defineModel</span><span class="hl-1">({</span><br/><span class="hl-1">  </span><span class="hl-4">name:</span><span class="hl-1"> </span><span class="hl-2">&#39;article&#39;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-4">properties:</span><span class="hl-1"> { </span><span class="hl-5">// свойства модели</span><br/><span class="hl-1">    </span><span class="hl-4">tags:</span><span class="hl-1"> {</span><br/><span class="hl-1">      </span><span class="hl-4">type:</span><span class="hl-1"> </span><span class="hl-4">DataType</span><span class="hl-1">.</span><span class="hl-7">ARRAY</span><span class="hl-1">, </span><span class="hl-5">// тип свойства &quot;array&quot; (обязательно)</span><br/><span class="hl-1">      </span><span class="hl-4">itemType:</span><span class="hl-1"> </span><span class="hl-4">DataType</span><span class="hl-1">.</span><span class="hl-7">STRING</span><span class="hl-1">, </span><span class="hl-5">// тип элемента &quot;string&quot;</span><br/><span class="hl-1">      </span><span class="hl-0">default</span><span class="hl-4">:</span><span class="hl-1"> () </span><span class="hl-6">=&gt;</span><span class="hl-1"> [], </span><span class="hl-5">// фабричное значение</span><br/><span class="hl-1">    },</span><br/><span class="hl-1">    </span><span class="hl-4">createdAt:</span><span class="hl-1"> {</span><br/><span class="hl-1">      </span><span class="hl-4">type:</span><span class="hl-1"> </span><span class="hl-4">DataType</span><span class="hl-1">.</span><span class="hl-7">STRING</span><span class="hl-1">, </span><span class="hl-5">// тип свойства &quot;string&quot; (обязательно)</span><br/><span class="hl-1">      </span><span class="hl-0">default</span><span class="hl-4">:</span><span class="hl-1"> () </span><span class="hl-6">=&gt;</span><span class="hl-1"> </span><span class="hl-6">new</span><span class="hl-1"> </span><span class="hl-0">Date</span><span class="hl-1">().</span><span class="hl-0">toISOString</span><span class="hl-1">(), </span><span class="hl-5">// фабричное значение</span><br/><span class="hl-1">    },</span><br/><span class="hl-1">  },</span><br/><span class="hl-1">});</span>
 </code><button>Copy</button></pre>
-<a id="md:валидаторы" class="tsd-anchor"></a><h2><a href="#md:валидаторы">Валидаторы</a></h2><p>Кроме проверки типа, более конкретные условия можно задать с помощью
+<a id="md:валидаторы" class="tsd-anchor"></a><h2><a href="#md:валидаторы">Валидаторы</a></h2><p>Кроме базовой проверки типа, дополнительные условия можно задать с помощью
 валидаторов, через которые будет проходить значение перед записью в базу.</p>
 <ul>
 <li><code>minLength: number</code> минимальная длинна строки или массива</li>
 <li><code>maxLength: number</code> максимальная длинна строки или массива</li>
+<li><code>regexp: string | RegExp</code> проверка по регулярному выражению</li>
 </ul>
 <p><strong>Пример</strong></p>
 <p>Валидаторы указываются в объявлении свойства модели параметром

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@e22m4u/js-repository",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Модуль для работы с базами данных для Node.js",
   "type": "module",
   "main": "src/index.js",

package/src/definition/model/model-data-validator.js

@@ -64,14 +64,9 @@ export class ModelDataValidator extends Service {
         propValue,
       );
     }
-    // DataType
-    await this._validatePropertyValueType(
-      modelName,
-      propName,
-      propDef,
-      propValue,
-    );
-    // PropertyValidators
+    // Property type.
+    await this._validateByPropertyType(modelName, propName, propDef, propValue);
+    // Property validators.
     await this._validateByPropertyValidators(
       modelName,
       propName,
@@ -81,7 +76,7 @@ export class ModelDataValidator extends Service {
   }
 
   /**
-   * Validate value type.
+   * Validate by property type.
    *
    * @param {string} modelName
    * @param {string} propName
@@ -90,7 +85,7 @@ export class ModelDataValidator extends Service {
    * @param {boolean} isArrayValue
    * @returns {Promise<void>}
    */
-  async _validatePropertyValueType(
+  async _validateByPropertyType(
     modelName,
     propName,
     propDef,
@@ -139,7 +134,7 @@ export class ModelDataValidator extends Service {
       case DataType.ARRAY:
         if (!Array.isArray(propValue)) throw createError('an Array');
         const arrayItemsValidationPromises = propValue.map(async value =>
-          this._validatePropertyValueType(
+          this._validateByPropertyType(
             modelName,
             propName,
             propDef,