chore: updates README.md

README.md

@@ -404,6 +404,39 @@ schema.defineModel({
 });
 ```
 
+Полиморфная версия `belongsTo`
+
+```js
+schema.defineModel({
+  name: 'file',
+  relations: {
+    reference: { // название связи
+      type: RelationType.BELONGS_TO, // текущая модель ссылается на целевую
+      // cогласно названию связи "reference", полиморфный режим позволяет
+      // хранить название целевой модели в свойстве "referenceType",
+      // а идентификатор целевого документа в "referenceId"
+      polymorphic: true,
+    },
+  },
+});
+```
+
+Полиморфная версия `belongsTo` с указанием свойств.
+
+```js
+schema.defineModel({
+  name: 'file',
+  relations: {
+    reference: { // название связи
+      type: RelationType.BELONGS_TO, // текущая модель ссылается на целевую
+      polymorphic: true, // название целевой модели хранит дискриминатор
+      foreignKey: 'referenceId', // свойство для идентификатора цели
+      discriminator: 'referenceType', // свойство для названия целевой модели
+    },
+  },
+})
+```
+
 ## Фильтрация
 
 Некоторые методы репозитория принимают объект настроек влияющий

docs/index.html

@@ -184,6 +184,12 @@
 <p>Объявление связи <code>referencesMany</code></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">relations:</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-4">categories:</span><span class="hl-1"> { </span><span class="hl-5">// название связи</span><br/><span class="hl-1">      </span><span class="hl-4">type:</span><span class="hl-1"> </span><span class="hl-4">RelationType</span><span class="hl-1">.</span><span class="hl-7">REFERENCES_MANY</span><span class="hl-1">, </span><span class="hl-5">// связь через массив идентификаторов</span><br/><span class="hl-1">      </span><span class="hl-4">model:</span><span class="hl-1"> </span><span class="hl-2">&#39;category&#39;</span><span class="hl-1">, </span><span class="hl-5">// название целевой модели</span><br/><span class="hl-1">      </span><span class="hl-4">foreignKey:</span><span class="hl-1"> </span><span class="hl-2">&#39;categoryIds&#39;</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>
+<p>Полиморфная версия <code>belongsTo</code></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;file&#39;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-4">relations:</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-4">reference:</span><span class="hl-1"> { </span><span class="hl-5">// название связи</span><br/><span class="hl-1">      </span><span class="hl-4">type:</span><span class="hl-1"> </span><span class="hl-4">RelationType</span><span class="hl-1">.</span><span class="hl-7">BELONGS_TO</span><span class="hl-1">, </span><span class="hl-5">// текущая модель ссылается на целевую</span><br/><span class="hl-1">      </span><span class="hl-5">// cогласно названию связи &quot;reference&quot;, полиморфный режим позволяет</span><br/><span class="hl-1">      </span><span class="hl-5">// хранить название целевой модели в свойстве &quot;referenceType&quot;,</span><br/><span class="hl-1">      </span><span class="hl-5">// а идентификатор целевого документа в &quot;referenceId&quot;</span><br/><span class="hl-1">      </span><span class="hl-4">polymorphic:</span><span class="hl-1"> </span><span class="hl-6">true</span><span class="hl-1">,</span><br/><span class="hl-1">    },</span><br/><span class="hl-1">  },</span><br/><span class="hl-1">});</span>
+</code><button>Copy</button></pre>
+<p>Полиморфная версия <code>belongsTo</code> с указанием свойств.</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;file&#39;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-4">relations:</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-4">reference:</span><span class="hl-1"> { </span><span class="hl-5">// название связи</span><br/><span class="hl-1">      </span><span class="hl-4">type:</span><span class="hl-1"> </span><span class="hl-4">RelationType</span><span class="hl-1">.</span><span class="hl-7">BELONGS_TO</span><span class="hl-1">, </span><span class="hl-5">// текущая модель ссылается на целевую</span><br/><span class="hl-1">      </span><span class="hl-4">polymorphic:</span><span class="hl-1"> </span><span class="hl-6">true</span><span class="hl-1">, </span><span class="hl-5">// название целевой модели хранит дискриминатор</span><br/><span class="hl-1">      </span><span class="hl-4">foreignKey:</span><span class="hl-1"> </span><span class="hl-2">&#39;referenceId&#39;</span><span class="hl-1">, </span><span class="hl-5">// свойство для идентификатора цели</span><br/><span class="hl-1">      </span><span class="hl-4">discriminator:</span><span class="hl-1"> </span><span class="hl-2">&#39;referenceType&#39;</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>Некоторые методы репозитория принимают объект настроек влияющий
 на возвращаемый результат. Максимально широкий набор таких настроек
 имеет первый параметр метода <code>find</code>, где ожидается объект содержащий

src/definition/model/relations/relation-definition.d.ts

@@ -73,7 +73,7 @@ export declare type BelongsToDefinition = {
  *   type: RelationType.BELONGS_TO,
  *   polymorphic: true,
  *   foreignKey: 'referenceId',
- *   discriminator: 'referenceType,
+ *   discriminator: 'referenceType',
  * }
  * ```
  */