@opengis/fastify-table 1.1.49 → 1.1.51

package/docs/db/index.md

@@ -1,9 +1,9 @@
----
-order: 0
----
-
-# Список Scheme
-
-- **[admin](admin.md)**
-- **[crm](crm.md)**
-- **[log](log.md)**
+---
+order: 0
+---
+
+# Список Scheme
+
+- **[admin](admin.md)**
+- **[crm](crm.md)**
+- **[log](log.md)**

package/docs/db/log.md

@@ -1,204 +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)
-);
-
-```
-
-:::
-
+
+
+# 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

@@ -1,20 +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 | Дані сесії користувача |
+# 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

@@ -1,25 +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 | Дані сесії користувача |
+# 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

@@ -1,26 +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 | Дані сесії користувача |
+# 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

@@ -1,26 +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 | Дані сесії користувача |
+# 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 | Дані сесії користувача |