@opengis/fastify-table 1.1.45 → 1.1.47

package/docs/db/log.md

@@ -0,0 +1,204 @@
+
+
+# log
+
+## Схема
+
+``` mermaid
+erDiagram
+    "table_changes - Логи подій змін в БД" {
+        entity_type text  "Таблиця, до якої вносяться зміни"
+        entity_id text  "ID строки, до якої вносяться зміни"
+        change_type text  "Тип події (insert / update / delete)"
+        change_key text  "-"
+        change_date date  "Дата внесення змін до БД"
+        uid text  "ідентифікатор автора запису в БД"
+        cdate timestamp_without_time_zone  "Дата створення запису в БД"
+        editor_id text  "Ідентифікатор автора, який останій вніс зміни в запис"
+        editor_date timestamp_without_time_zone  "Час останії зміни в записі"
+        change_id text PK "-"
+        change_user_id text  "Ініціатор внесення змін"
+    }
+    "table_changes_data - Логи змін в таблицях БД" {
+        change_data_id text PK "-"
+        change_id text FK "ID події зміни в БД"
+        entity_key text  "Колонка таблиці, до якої вносяться зміни"
+        value_old text  "Старе значення"
+        value_new text  "Нове значення"
+        uid text  "ідентифікатор автора запису в БД"
+        cdate timestamp_without_time_zone  "Дата створення запису в БД"
+        editor_id text  "Ідентифікатор автора, який останій вніс зміни в запис"
+        editor_date timestamp_without_time_zone  "Час останії зміни в записі"
+    }
+    "user_auth - Логи авторизації" {
+        user_auth_id text PK "-"
+        user_id text  "ID користувача"
+        user_auth_date timestamp_without_time_zone  "-"
+        user_auth_type text  "-"
+        uid text  "ідентифікатор автора запису в БД"
+        cdate timestamp_without_time_zone  "Дата створення запису в БД"
+        editor_id text  "Ідентифікатор автора, який останій вніс зміни в запис"
+        editor_date timestamp_without_time_zone  "Час останії зміни в записі"
+        auth_date timestamp_without_time_zone  "Дата авторизації"
+        auth_type text  "Тип авторизації"
+    }
+    "log.table_changes_data - " ||--|{ "log.table_changes - " : ""
+```
+
+**Ключі**
+
+``` mermaid
+erDiagram
+    "table_changes - Логи подій змін в БД" {
+        change_id PRIMARY_KEY
+    }
+    "table_changes_data - Логи змін в таблицях БД" {
+        change_data_id PRIMARY_KEY
+        change_id FOREIGN_KEY
+    }
+    "user_auth - Логи авторизації" {
+        user_auth_id PRIMARY_KEY
+    }
+    "log.table_changes_data - " ||--|{ "log.table_changes - " : ""
+```
+
+
+
+## log.table_changes
+
+Логи подій змін в БД
+
+:::tabs
+
+==table
+
+| Назва колонки          |     Тип                  | Ключ |  Опис       |
+| ---------------------- | ------------------------- | --- | ---------- |
+| entity_type            |   `text`      |  | Таблиця, до якої вносяться зміни |
+| entity_id            |   `text`      |  | ID строки, до якої вносяться зміни |
+| change_type            |   `text`      |  | Тип події (insert / update / delete) |
+| change_key            |   `text`      |  | - |
+| change_date            |   `date`      |  | Дата внесення змін до БД |
+| uid            |   `text`      |  | ідентифікатор автора запису в БД |
+| cdate            |   `timestamp without time zone`      |  | Дата створення запису в БД |
+| editor_id            |   `text`      |  | Ідентифікатор автора, який останій вніс зміни в запис |
+| editor_date            |   `timestamp without time zone`      |  | Час останії зміни в записі |
+| change_id            |   `text`      | PK | - |
+| change_user_id            |   `text`      |  | Ініціатор внесення змін |
+
+==sql
+
+```sql
+
+CREATE TABLE log.table_changes
+(
+  entity_type text , -- Таблиця, до якої вносяться зміни
+    entity_id text , -- ID строки, до якої вносяться зміни
+    change_type text , -- Тип події (insert / update / delete)
+    change_key text , -- -
+    change_date date , -- Дата внесення змін до БД
+    uid text , -- ідентифікатор автора запису в БД
+    cdate timestamp without time zone DEFAULT (now())::timestamp without time zone, -- Дата створення запису в БД
+    editor_id text , -- Ідентифікатор автора, який останій вніс зміни в запис
+    editor_date timestamp without time zone , -- Час останії зміни в записі
+    change_id text DEFAULT next_id(), -- -
+    change_user_id text  -- Ініціатор внесення змін
+  ,
+  CONSTRAINT log_table_changes_pkey PRIMARY KEY (change_id)
+);
+
+```
+
+:::
+
+
+## log.table_changes_data
+
+Логи змін в таблицях БД
+
+:::tabs
+
+==table
+
+| Назва колонки          |     Тип                  | Ключ |  Опис       |
+| ---------------------- | ------------------------- | --- | ---------- |
+| change_data_id            |   `text`      | PK | - |
+| change_id            |   `text`      | FK | ID події зміни в БД |
+| entity_key            |   `text`      |  | Колонка таблиці, до якої вносяться зміни |
+| value_old            |   `text`      |  | Старе значення |
+| value_new            |   `text`      |  | Нове значення |
+| uid            |   `text`      |  | ідентифікатор автора запису в БД |
+| cdate            |   `timestamp without time zone`      |  | Дата створення запису в БД |
+| editor_id            |   `text`      |  | Ідентифікатор автора, який останій вніс зміни в запис |
+| editor_date            |   `timestamp without time zone`      |  | Час останії зміни в записі |
+
+==sql
+
+```sql
+
+CREATE TABLE log.table_changes_data
+(
+  change_data_id text DEFAULT next_id(), -- -
+    change_id text , -- ID події зміни в БД
+    entity_key text , -- Колонка таблиці, до якої вносяться зміни
+    value_old text , -- Старе значення
+    value_new text , -- Нове значення
+    uid text , -- ідентифікатор автора запису в БД
+    cdate timestamp without time zone DEFAULT (now())::timestamp without time zone, -- Дата створення запису в БД
+    editor_id text , -- Ідентифікатор автора, який останій вніс зміни в запис
+    editor_date timestamp without time zone  -- Час останії зміни в записі
+  ,
+  CONSTRAINT log_table_changes_data_change_id_fkey FOREIGN KEY (change_id) REFERENCES log.table_changes (change_id) MATCH SIMPLE ON UPDATE NO ACTION ON DELETE NO ACTION,
+  CONSTRAINT log_table_changes_data_pkey PRIMARY KEY (change_data_id)
+);
+
+```
+
+:::
+
+
+## log.user_auth
+
+Логи авторизації
+
+:::tabs
+
+==table
+
+| Назва колонки          |     Тип                  | Ключ |  Опис       |
+| ---------------------- | ------------------------- | --- | ---------- |
+| user_auth_id            |   `text`      | PK | - |
+| user_id            |   `text`      |  | ID користувача |
+| user_auth_date            |   `timestamp without time zone`      |  | - |
+| user_auth_type            |   `text`      |  | - |
+| uid            |   `text`      |  | ідентифікатор автора запису в БД |
+| cdate            |   `timestamp without time zone`      |  | Дата створення запису в БД |
+| editor_id            |   `text`      |  | Ідентифікатор автора, який останій вніс зміни в запис |
+| editor_date            |   `timestamp without time zone`      |  | Час останії зміни в записі |
+| auth_date            |   `timestamp without time zone`      |  | Дата авторизації |
+| auth_type            |   `text`      |  | Тип авторизації |
+
+==sql
+
+```sql
+
+CREATE TABLE log.user_auth
+(
+  user_auth_id text DEFAULT next_id(), -- -
+    user_id text , -- ID користувача
+    user_auth_date timestamp without time zone , -- -
+    user_auth_type text , -- -
+    uid text , -- ідентифікатор автора запису в БД
+    cdate timestamp without time zone DEFAULT (now())::timestamp without time zone, -- Дата створення запису в БД
+    editor_id text , -- Ідентифікатор автора, який останій вніс зміни в запис
+    editor_date timestamp without time zone , -- Час останії зміни в записі
+    auth_date timestamp without time zone , -- Дата авторизації
+    auth_type text  -- Тип авторизації
+  ,
+  CONSTRAINT log_user_auth_pkey PRIMARY KEY (user_auth_id)
+);
+
+```
+
+:::
+

package/docs/hook/card/afterCard.md

@@ -0,0 +1,20 @@
+# afterCard
+
+## Опис
+
+Дозволяє здійснити додаткові операції та внести зміни до payload, що отримується при виклику GET API [`/card/:token`](../../api/table/card.md)
+
+## Параметри
+
+```js
+import { addHook } from '@opengis/fastify-table/utils.js';
+
+addHook('afterCard', async ({ table, id, user = {} }) => {
+  // do something;
+});
+```
+
+| Назва   | Тип    | Опис                   |
+| ------- | ------ | ---------------------- |
+| table   | String | Таблиця / Токен        |
+| user    | Object | Дані сесії користувача |

package/docs/hook/card/preCard.md

@@ -0,0 +1,25 @@
+# preCard
+
+## Опис
+
+Дозволяє здійснити попередню валідацію запиту до GET API [`/card/:token`](../../api/table/card.md)
+
+## Параметри
+
+```js
+import { config, getToken, addHook, pgClients } from '@opengis/fastify-table/utils.js';
+
+addHook('preCard', async ({ table, id, user = {} }) => {
+  const { client: pg } = pgClients || {};
+  const { uid } = config?.auth?.disable ? { uid: '1' } : user;
+  const opt = await getToken({
+      uid, token: table, mode: 'w', json: 1,
+  });
+  return opt;
+});
+```
+
+| Назва   | Тип    | Опис                   |
+| ------- | ------ | ---------------------- |
+| table   | String | Таблиця / Токен        |
+| user    | Object | Дані сесії користувача |

package/docs/hook/data/afterData.md

@@ -0,0 +1,26 @@
+# afterData
+
+## Опис
+
+Дозволяє здійснити додаткові операції та внести зміни до payload, що отримується при виклику API [`/data/:table`](../../api/table/data.md)
+
+## Параметри
+
+```js
+import { addHook, pgClients } from '@opengis/fastify-table/utils.js';
+
+addHook('afterData', async ({
+    table, payload = {}, user,
+}) => {
+    if (!payload.rows?.length) return;
+    const { client: pg } = pgClients || {};
+    const result = await pg.query(`select $1=$1 as check from ${table} where 1=1`, ['1']).then((res) => res.rows?.[0] || {});
+    Object.assign(payload.rows[0], { ...result });
+});
+```
+
+| Назва   | Тип    | Опис                   |
+| ------- | ------ | ---------------------- |
+| table   | String | Таблиця                |
+| payload | Object | Відповідь від API      |
+| user    | Object | Дані сесії користувача |

package/docs/hook/data/preData.md

@@ -0,0 +1,26 @@
+# preData
+
+## Опис
+
+Дозволяє здійснити попередню валідацію запиту до API [`/data/:table`](../../api/table/data.md)
+
+## Параметри
+
+```js
+import { addHook, config } from '@opengis/fastify-table/utils.js';
+
+addHook('preData', async ({ table, id, user }) => {
+        const { uid } = config?.auth?.disable ? { uid: '1' } : user || {};
+        if (!uid && !config?.local) {
+            return { message: 'access restricted: edit', status: 403 };
+        }
+        const opt = await getToken({ mode: 'w', token: table, uid, json: 1 });
+        return opt;
+});
+```
+
+| Назва   | Тип    | Опис                   |
+| ------- | ------ | ---------------------- |
+| table   | String | Таблиця / Токен        |
+| id      | String | ID об'єкту             |
+| user    | Object | Дані сесії користувача |

package/docs/hook/deleteCrud/afterDelete.md

@@ -0,0 +1,21 @@
+# afterDelete
+
+## Опис
+
+Дозволяє здійснити додаткові операції та внести зміни до payload, що отримується при виклику DELETE API [`/table/:token`](../../api/crud/deleteCrud.md)
+
+## Параметри
+
+```js
+import { addHook } from '@opengis/fastify-table/utils.js';
+
+addHook('afterDelete', async ({ table, id, user = {} }) => {
+  // do something;
+});
+```
+
+| Назва   | Тип    | Опис                   |
+| ------- | ------ | ---------------------- |
+| table   | String | Таблиця                |
+| id      | String | ID об'єкту             |
+| user    | Object | Дані сесії користувача |

package/docs/hook/deleteCrud/preDelete.md

@@ -0,0 +1,26 @@
+# preDelete
+
+## Опис
+
+Дозволяє здійснити попередню валідацію запиту до DELETE API [`/table/:token`](../../api/crud/deleteCrud.md)
+
+## Параметри
+
+```js
+import { addHook, config } from '@opengis/fastify-table/utils.js';
+
+addHook('preDelete', async ({ table, id, user }) => {
+        const { uid } = config?.auth?.disable ? { uid: '1' } : user || {};
+        if (!uid && !config?.local) {
+            return { message: 'access restricted: delete', status: 403 };
+        }
+        const opt = await getToken({ mode: 'w', token: table, uid, json: 1 });
+        return opt;
+});
+```
+
+| Назва   | Тип    | Опис                   |
+| ------- | ------ | ---------------------- |
+| table   | String | Таблиця / Токен        |
+| id      | String | ID об'єкту             |
+| user    | Object | Дані сесії користувача |

package/docs/hook/form/afterForm.md

@@ -0,0 +1,19 @@
+# afterForm
+
+## Опис
+
+Дозволяє здійснити додаткові операції та внести зміни до payload, що отримується при виклику API [`/form/:token`](../../api/table/form.md)
+
+## Параметри
+
+```js
+addHook('afterForm', async ({ form, payload, user = {} }) => {
+  // do something;
+});
+```
+
+| Назва   | Тип    | Опис                   |
+| ------- | ------ | ---------------------- |
+| form    | String | Форма / Токен          |
+| payload | Object | Відповідь від API      |
+| user    | Object | Дані сесії користувача |

package/docs/hook/form/preForm.md

@@ -0,0 +1,26 @@
+# preForm
+
+## Опис
+
+Дозволяє здійснити попередню валідацію запиту до API [`/form/:token`](../../api/table/form.md)
+
+## Параметри
+
+```js
+import { addHook, config } from '@opengis/fastify-table/utils.js';
+
+addHook('preForm', async ({ form, id, user }) => {
+        const { uid } = config?.auth?.disable ? { uid: '1' } : user || {};
+        if (!uid && !config?.local) {
+            return { message: 'access restricted: edit', status: 403 };
+        }
+        const opt = await getToken({ mode: 'w', token: form, uid, json: 1 });
+        return opt;
+});
+```
+
+| Назва   | Тип    | Опис                   |
+| ------- | ------ | ---------------------- |
+| form    | String | Форма / Токен          |
+| id      | String | ID об'єкту             |
+| user    | Object | Дані сесії користувача |

package/docs/hook/getTemplate/afterTemplate.md

@@ -0,0 +1,24 @@
+# afterTemplate
+
+## Опис
+
+Дозволяє здійснити додаткові операції та внести зміни до payload, що отримується при виклику API [`/template/:type/:token`](https://apidocs.softpro.ua/admin/api/templates/template.html)
+
+## Параметри
+
+```js
+import { addHook, pgClients } from '@opengis/fastify-table/utils.js';
+
+addHook('afterTemplate', async ({ name, type, payload, user = {} }) => {
+  const { client: pg } = pgClients || {};
+  const { uid } = user;
+  if (!uid || !name) return null;
+});
+```
+
+| Назва   | Тип    | Опис                   |
+| ------- | ------ | ---------------------- |
+| name    | String | Назва шаблону / Токен  |
+| type    | String | Тип шаблону            |
+| payload | Object | Відповідь від API      |
+| user    | Object | Дані сесії користувача |

package/docs/hook/getTemplate/preTemplate.md

@@ -0,0 +1,29 @@
+# preTemplate
+
+## Опис
+
+Дозволяє здійснити попередню валідацію запиту до API [`/template/:type/:token`](https://apidocs.softpro.ua/admin/api/templates/template.html)
+
+## Параметри
+
+```js
+import { addHook, getToken, config } from '@opengis/fastify-table/utils.js';
+
+addHook('preTemplate', async ({ name, type, user = {} }) => {
+    if (!name || !type) return;
+    const { uid } = config?.auth?.disable ? { uid: '1' } : user;
+    const tokenData = await getToken({
+        uid, token: name, mode: 'w', json: 1,
+    })  // edit?
+        || await getToken({
+        uid, token: name, mode: 'a', json: 1,
+    }) || {}; // add?
+    return { name: tokenData?.[type] };
+});
+```
+
+| Назва   | Тип    | Опис                   |
+| ------- | ------ | ---------------------- |
+| name    | String | Назва шаблону / Токен  |
+| type    | String | Тип шаблону            |
+| user    | Object | Дані сесії користувача |

package/docs/hook/index.md

@@ -0,0 +1,45 @@
+---
+order: -1
+---
+
+# Список хуків
+
+## GET /data/:table/:id? (data.js)
+
+- **[preData](./data/preData.md)** - попередня обробка, можливість блокування доступу
+- **[afterData](./data/afterData.md)** - `модифікація` результату, додавання пов'язаних даних тощо
+
+## GET /card/:table/:id? (card.js)
+
+- **[preCard](./card/preCard.md)** - попередня обробка, можливість блокування доступу
+- **[afterCard](./card/afterCard.md)** - `модифікація` результату, додавання пов'язаних даних тощо
+
+## GET /template/:type/:name (getTemplate.js)
+
+- **[preTemplate](./getTemplate/preTemplate.md)** - попередня обробка, можливість блокування доступу [template](../api/admin/templates/template.md)
+- **[afterTemplate](./getTemplate/afterTemplate.md)** - `модифікації` payload [template](../api/admin/templates/template.md)
+
+## GET /form/:name (form.js)
+
+- **[preForm](./form/preForm.md)** - попередня обробка, можливість блокування доступу
+- **[afterForm](./form/afterForm.md)** - `модифікація` форми, додавання користувацьких полів тощо
+
+## GET /table/:token (table.js) - CRUD
+
+- **[preTable](./table/preTable.md)** - попередня обробка, можливість блокування доступу
+- **[afterTable](./table/afterTable.md)** - `модифікація` результату, додавання пов'язаних даних тощо
+
+## POST /table/:token (insert.js) - CRUD
+
+- **[preInsert](./insert/preInsert.md)** - попередня обробка, можливість блокування доступу
+- **[afterInsert](./insert/afterInsert.md)** - виконання додаткових дій після внесення даних до БД [insert](../api/fastify-table/crud/insert.md)
+
+## PUT /table/:token (update.js) - CRUD
+
+- **[preUpdate](./update/preUpdate.md)** - попередня обробка, можливість блокування доступу
+- **[afterUpdate](./update/afterUpdate.md)** - виконання додаткових дій після внесення змін до БД [update](../api/fastify-table/crud/update.md)
+
+## DELETE /table/:token (deleteCrud.js) - CRUD
+
+- **[preDelete](./deleteCrud/preDelete.md)** - попередня обробка, можливість блокування доступу
+- **[afterDelete](./deleteCrud/afterDelete.md)** - виконання додаткових дій після внесення змін до БД [delete](../api/fastify-table/crud/deleteCrud.md)

package/docs/hook/insert/afterInsert.md

@@ -0,0 +1,41 @@
+# afterInsert
+
+## Опис
+
+Дозволяє здійснити додаткові операції та внести зміни до payload, що отримується при виклику POST API [`/table/:token`](../../api/crud/insert.md)
+
+## Параметри
+
+```js
+import { addHook, config, getTemplate, pgClients } from '@opengis/fastify-table/utils.js';
+
+addHook('afterInsert', async ({ table, body = {}, payload: res = {}, user = {} }) => {
+    const { client: pg } = pgClients || {};
+    const { uid } = config?.auth?.disable ? { uid: '1' } : user;
+    if (!uid || !table || !Object.keys(body)?.length) return null;
+
+    const loadTable = await getTemplate('table', table);
+    if (!pg.pk[loadTable?.table || table]) return null;
+    const pk = pg.pk[loadTable?.table || table];
+    const id = res.rows?.[0]?.[pk];
+
+    const { rows: properties = [] } = await pg.query(`select column_id, name, title, format, data from admin.custom_column 
+    where entity=$1 and uid=$2`, [table, uid]);
+
+    if (!id || !properties?.length) return null;
+
+    const q = properties
+        .filter((el) => Object.keys(body).includes(el.name))
+        .map((el) => `insert into crm.extra_data(property_id,property_key,property_entity,object_id,${el.format?.toLowerCase() === 'date' ? 'value_date' : 'value_text'})
+    select '${el.column_id}', '${el.name}', '${table}', '${id}', ${el.format?.toLowerCase() === 'date' ? `'${body[el.name]}'::timestamp without time zone` : `'${body[el.name]}'::text`}`)
+        .join(';\n');
+    return pg.query(q);
+});
+```
+
+| Назва   | Тип    | Опис                   |
+| ------- | ------ | ---------------------- |
+| table   | String | Таблиця / Токен        |
+| body    | Object | Тіло запиту, що надійшов до API |
+| payload | Object | Відповідь від API      |
+| user    | Object | Дані сесії користувача |

package/docs/hook/insert/preInsert.md

@@ -0,0 +1,25 @@
+# preInsert
+
+## Опис
+
+Дозволяє здійснити попередню валідацію запиту до POST API [`/table/:token`](../../api/crud/insert.md)
+
+## Параметри
+
+```js
+import { addHook, config } from '@opengis/fastify-table/utils.js';
+
+addHook('preInsert', async ({ table, user }) => {
+        const { uid } = config?.auth?.disable ? { uid: '1' } : user || {};
+        if (!uid && !config?.local) {
+            return { message: 'access restricted: edit', status: 403 };
+        }
+        const opt = await getToken({ mode: 'w', token: table, uid, json: 1 });
+        return opt;
+});
+```
+
+| Назва   | Тип    | Опис                   |
+| ------- | ------ | ---------------------- |
+| table   | String | Таблиця / Токен        |
+| user    | Object | Дані сесії користувача |

package/docs/hook/table/afterTable.md

@@ -0,0 +1,20 @@
+# afterTable
+
+## Опис
+
+Дозволяє здійснити додаткові операції та внести зміни до payload, що отримується при виклику GET API [`/table/:token`](../../api/table/table.md)
+
+## Параметри
+
+```js
+import { addHook } from '@opengis/fastify-table/utils.js';
+
+addHook('afterTable', async ({ table, user = {} }) => {
+  // do something;
+});
+```
+
+| Назва   | Тип    | Опис                   |
+| ------- | ------ | ---------------------- |
+| table   | String | Таблиця / Токен        |
+| user    | Object | Дані сесії користувача |

package/docs/hook/table/preTable.md

@@ -0,0 +1,25 @@
+# preTable
+
+## Опис
+
+Дозволяє здійснити попередню валідацію запиту до GET API [`/table/:token`](../../api/table/table.md)
+
+## Параметри
+
+```js
+import { config, getToken, addHook, pgClients } from '@opengis/fastify-table/utils.js';
+
+addHook('preTable', async ({ table, user = {} }) => {
+  const { client: pg } = pgClients || {};
+  const { uid } = config?.auth?.disable ? { uid: '1' } : user;
+  const opt = await getToken({
+      uid, token: table, mode: 'w', json: 1,
+  });
+  return opt;
+});
+```
+
+| Назва   | Тип    | Опис                   |
+| ------- | ------ | ---------------------- |
+| table   | String | Таблиця / Токен        |
+| user    | Object | Дані сесії користувача |

package/docs/hook/update/afterUpdate.md

@@ -0,0 +1,41 @@
+# afterUpdate
+
+## Опис
+
+Дозволяє здійснити додаткові операції та внести зміни до payload, що отримується при виклику PUT API [`/table/:token`](../../api/crud/update.md)
+
+## Параметри
+
+```js
+import { addHook, pgClients } from '@opengis/fastify-table/utils.js';
+
+addHook('afterUpdate', async ({ table, body = {}, payload: res = {}, user = {} }) => {
+    const { client: pg } = pgClients || {};
+    const { uid } = config?.auth?.disable ? { uid: '1' } : user;
+    if (!uid || !table || !Object.keys(body)?.length) return null;
+
+    const loadTable = await getTemplate('table', table);
+    if (!pg.pk[loadTable?.table || table]) return null;
+    const pk = pg.pk[loadTable?.table || table];
+    const id = res[pk];
+
+    const { rows: properties = [] } = await pg.query(`select column_id, name, title, format, data from admin.custom_column 
+    where entity=$1 and uid=$2`, [table, uid]);
+
+    if (!id || !properties?.length) return null;
+
+    const q = `delete from crm.extra_data where property_entity='${table}' and object_id='${id}';${properties
+        .filter((el) => Object.keys(body).includes(el.name))
+        .map((el) => `insert into crm.extra_data(property_id,property_key,property_entity,object_id,${el.format?.toLowerCase() === 'date' ? 'value_date' : 'value_text'})
+    select '${el.column_id}', '${el.name}', '${table}', '${id}', ${el.format?.toLowerCase() === 'date' ? `'${body[el.name]}'::timestamp without time zone` : `'${body[el.name]}'::text`}`)
+        .join(';\n') || ''}`;
+    return pg.query(q);
+});
+```
+
+| Назва   | Тип    | Опис                   |
+| ------- | ------ | ---------------------- |
+| table   | String | Таблиця / Токен        |
+| body    | Object | Тіло запиту, що надійшов до API |
+| payload | Object | Відповідь від API      |
+| user    | Object | Дані сесії користувача |