letopis 1.4.1 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (113) hide show
  1. package/AGENT-CHEATSHEET.md +329 -278
  2. package/CHANGELOG.md +558 -1
  3. package/README.md +606 -1037
  4. package/dist/acl.d.ts +78 -1
  5. package/dist/acl.js +264 -13
  6. package/dist/admin.d.ts +10 -141
  7. package/dist/admin.js +24 -175
  8. package/dist/auth.d.ts +2 -2
  9. package/dist/auth.js +5 -15
  10. package/dist/cache.d.ts +8 -1
  11. package/dist/cache.js +33 -10
  12. package/dist/chain.d.ts +19 -41
  13. package/dist/chain.js +169 -201
  14. package/dist/cli.js +51 -88
  15. package/dist/demo/booking.d.ts +352 -36
  16. package/dist/describe.d.ts +47 -0
  17. package/dist/describe.js +195 -0
  18. package/dist/errors.d.ts +59 -13
  19. package/dist/errors.js +190 -29
  20. package/dist/index.d.ts +52 -71
  21. package/dist/index.js +245 -130
  22. package/dist/internal.d.ts +12 -0
  23. package/dist/internal.js +5 -0
  24. package/dist/jsonschema.js +18 -17
  25. package/dist/load.d.ts +20 -12
  26. package/dist/load.js +225 -186
  27. package/dist/mcp.d.ts +5 -7
  28. package/dist/mcp.js +171 -215
  29. package/dist/messages/access.d.ts +90 -0
  30. package/dist/messages/access.js +113 -0
  31. package/dist/messages/api.d.ts +171 -0
  32. package/dist/messages/api.js +215 -0
  33. package/dist/messages/boot.d.ts +201 -0
  34. package/dist/messages/boot.js +256 -0
  35. package/dist/messages/codes.d.ts +172 -0
  36. package/dist/messages/codes.js +173 -0
  37. package/dist/messages/index.d.ts +95 -0
  38. package/dist/messages/index.js +118 -0
  39. package/dist/messages/mcp.d.ts +306 -0
  40. package/dist/messages/mcp.js +387 -0
  41. package/dist/messages/model.d.ts +233 -0
  42. package/dist/messages/model.js +283 -0
  43. package/dist/messages/query.d.ts +131 -0
  44. package/dist/messages/query.js +158 -0
  45. package/dist/messages/sql-access.d.ts +70 -0
  46. package/dist/messages/sql-access.js +87 -0
  47. package/dist/messages/sql-core.d.ts +150 -0
  48. package/dist/messages/sql-core.js +181 -0
  49. package/dist/messages/sql-time.d.ts +71 -0
  50. package/dist/messages/sql-time.js +88 -0
  51. package/dist/messages/sql-write.d.ts +246 -0
  52. package/dist/messages/sql-write.js +270 -0
  53. package/dist/messages/time.d.ts +23 -0
  54. package/dist/messages/time.js +29 -0
  55. package/dist/messages/types.d.ts +27 -0
  56. package/dist/messages/types.js +5 -0
  57. package/dist/messages/write.d.ts +405 -0
  58. package/dist/messages/write.js +509 -0
  59. package/dist/model.d.ts +73 -60
  60. package/dist/model.js +26 -29
  61. package/dist/ops.d.ts +35 -0
  62. package/dist/ops.js +101 -0
  63. package/dist/pglite.d.ts +0 -9
  64. package/dist/pglite.js +3 -1
  65. package/dist/registry.d.ts +3 -19
  66. package/dist/registry.js +3 -16
  67. package/dist/signals.d.ts +5 -9
  68. package/dist/signals.js +5 -9
  69. package/dist/sql.d.ts +13 -6
  70. package/dist/sql.js +176 -83
  71. package/dist/sync.d.ts +9 -3
  72. package/dist/sync.js +51 -21
  73. package/dist/tx.d.ts +26 -1
  74. package/dist/tx.js +44 -14
  75. package/dist/typed.d.ts +240 -45
  76. package/dist/types.d.ts +23 -91
  77. package/dist/types.js +12 -14
  78. package/dist/up.d.ts +53 -32
  79. package/dist/up.js +184 -73
  80. package/dist/uuid.js +5 -5
  81. package/dist/validate.d.ts +13 -1
  82. package/dist/validate.js +61 -29
  83. package/dist/watch.d.ts +11 -10
  84. package/dist/watch.js +33 -70
  85. package/dist/write.d.ts +9 -16
  86. package/dist/write.js +118 -187
  87. package/llms.txt +22 -25
  88. package/package.json +8 -11
  89. package/sql/10-core.sql +7 -50
  90. package/sql/15-errors.sql +64 -10
  91. package/sql/20-context.sql +7 -6
  92. package/sql/30-validate.sql +35 -27
  93. package/sql/40-class.sql +20 -114
  94. package/sql/50-acl.sql +8 -13
  95. package/sql/60-write.sql +220 -667
  96. package/sql/70-read.sql +20 -16
  97. package/sql/80-auth.sql +24 -27
  98. package/sql/90-time.sql +70 -859
  99. package/sql/95-seed.system.sql +7 -14
  100. package/sql/99-revision.sql +2 -1
  101. package/sql/README.md +32 -24
  102. package/sql/migrate/README.md +14 -0
  103. package/AGENT-CHEATSHEET.en.md +0 -485
  104. package/MIGRATION.md +0 -190
  105. package/README.en.md +0 -2859
  106. package/dist/import.d.ts +0 -185
  107. package/dist/import.js +0 -820
  108. package/dist/project.d.ts +0 -350
  109. package/dist/project.js +0 -1224
  110. package/sql/75-history.sql +0 -358
  111. package/sql/88-derived.sql +0 -1235
  112. package/sql/migrate/0006-changed-paths.sql +0 -3
  113. package/sql/migrate/0007-secret-account-fk.sql +0 -12
package/sql/90-time.sql CHANGED
@@ -3,83 +3,11 @@
3
3
  -- Функции владельца проверяют всё сами, сами пишут журнал и сами посылают сигнал (§2.7):
4
4
  -- restore() — последний снимок удалённого объекта новой версией (вид restore), с проверкой
5
5
  -- по текущему описанию класса; id прежний;
6
- -- purge() — стирание истории удалённого объекта: на место версии 1 встаёт запись purge
7
- -- с числом стёртых версий и последним хэшем;
8
- -- trim_history() — обрезка истории до момента: на место версии 1 встаёт запись trim со временем
9
- -- прежней версии 1, числом стёртых версий и хэшем последней из них;
10
- -- rekey(), rekey_class() — новое значение ключа объекта или новый ключ класса: строка с новым id,
11
- -- перевод ссылок (move_row), журнал связывает id колонкой moved;
12
6
  -- account_purge() — удаление аккаунта с данными его арендатора (предохранители 0.21);
13
- -- reset() — сброс sessions | tenant | all (флаг allow_reset, право letopis.reset,
14
- -- подтверждение именем схемы); первая запись журнала после сброса — reset;
15
- -- maintain() — истёкшие сессии и коды, одна пачка прореживания журнала по политике хранения;
16
- -- verify() — цепочки хэшей с законными разрывами (purge, trim, reset, прореживание),
17
- -- якорь, а с p_data — данные, концы, арендаторы, владельцы и id всех строк.
7
+ -- maintain() — истёкшие сессии и коды, строки-замки удалённых семейств.
18
8
  -- У id, у которого в журнале есть хоть одна запись, номер версии 1 всегда занят (этап 6, п. 3):
19
9
  -- на нём держится режим existing: 'error' загрузчика.
20
10
 
21
- -- Умолчание политики хранения — константа установки up({ history }); null — хранить всё.
22
- create or replace function @SCHEMA@.history_default() returns jsonb
23
- language sql immutable parallel safe
24
- return nullif((@HISTORY_DEFAULT@)::jsonb, 'null'::jsonb);
25
-
26
- -- Действующая политика хранения класса по развёрнутому описанию: своя (объект), умолчание установки
27
- -- для классов с журналом, null — хранить всё. Системные классы не прореживаются (§2.11).
28
- create or replace function @SCHEMA@.history_policy(p_res jsonb) returns jsonb
29
- language sql immutable parallel safe
30
- return case
31
- when (p_res->>'name') = any (array['Class', 'Account', 'member', 'Resource', 'rule']) then null
32
- when jsonb_typeof(p_res->'history') = 'object' then p_res->'history'
33
- when p_res->'history' = 'true'::jsonb then @SCHEMA@.history_default()
34
- end;
35
-
36
- -- Срок яруса политики: интервал или бесконечность ('forever').
37
- create or replace function @SCHEMA@.history_iv(p_term text) returns interval
38
- language sql immutable parallel safe
39
- return case when p_term = 'forever' then 'infinity'::interval else p_term::interval end;
40
-
41
- -- Конец последнего яруса политики: после него история удаляется (бесконечность — хранится всегда).
42
- create or replace function @SCHEMA@.history_horizon(p_pol jsonb) returns interval
43
- language sql immutable parallel safe
44
- return (select @SCHEMA@.history_iv(p_pol->>t.n) from unnest(array['all', 'daily', 'weekly', 'monthly', 'yearly']) with ordinality t(n, i)
45
- where p_pol ? t.n order by t.i desc limit 1);
46
-
47
- -- Нужна ли политике версия (§2.11): в ярусе all — все; дальше — последняя в своём периоде текущего
48
- -- яруса или любого более крупного (недели не вкладываются в месяцы); старше последнего яруса со
49
- -- сроком — не нужна. Время — местное в поясе политики: p_lt — версии, p_nowl — «сейчас», p_nlt —
50
- -- следующей версии того же id (null — следующей нет). Ярус — календарно: моложе срока, если позже
51
- -- «сейчас» минус срок (месяц — месяц, а не 30 дней).
52
- create or replace function @SCHEMA@.history_keep(p_pol jsonb, p_lt timestamp, p_nowl timestamp, p_nlt timestamp) returns boolean
53
- language plpgsql immutable parallel safe
54
- as $$
55
- declare
56
- tiers text[] := array['all', 'daily', 'weekly', 'monthly', 'yearly'];
57
- units text[] := array[null, 'day', 'week', 'month', 'year'];
58
- my int;
59
- i int;
60
- begin
61
- for i in 1 .. 5 loop
62
- continue when not (p_pol ? tiers[i]);
63
- if p_lt > p_nowl - @SCHEMA@.history_iv(p_pol->>tiers[i]) then
64
- my := i;
65
- exit;
66
- end if;
67
- end loop;
68
- if my is null then
69
- return false;
70
- end if;
71
- if my = 1 or p_nlt is null then
72
- return true;
73
- end if;
74
- for i in my .. 5 loop
75
- continue when not (p_pol ? tiers[i]);
76
- if date_trunc(units[i], p_nlt) <> date_trunc(units[i], p_lt) then
77
- return true;
78
- end if;
79
- end loop;
80
- return false;
81
- end $$;
82
-
83
11
  -- Действующая роль сеанса, под которой вызывающий работает вне функций владельца: роль SET ROLE (и параметра запуска
84
12
  -- role), иначе роль входа. Внутри функции владельца current_user — владелец, а session_user — роль входа, даже если
85
13
  -- поверх неё поставлена роль приложения: привилегированный вход с ролью приложения выглядел бы администратором
@@ -89,8 +17,8 @@ language sql stable
89
17
  set search_path = pg_catalog, @SCHEMA@, pg_temp
90
18
  return coalesce(nullif(current_setting('role'), 'none'), session_user)::name;
91
19
 
92
- -- Роль подключения — администраторская (суперпользователь или может стать владельцем): verify,
93
- -- reset и maintain доступны ей и без сессии (CLI, обслуживание по расписанию).
20
+ -- Роль подключения — администраторская (суперпользователь или может стать владельцем): maintain доступен ей и без
21
+ -- сессии (CLI, обслуживание по расписанию).
94
22
  create or replace function @SCHEMA@.admin_role() returns boolean
95
23
  language sql stable
96
24
  set search_path = pg_catalog, @SCHEMA@, pg_temp
@@ -144,7 +72,7 @@ set search_path = pg_catalog, @SCHEMA@, pg_temp
144
72
  as $$
145
73
  begin
146
74
  if not @SCHEMA@.letopis_allowed('letopis.signals') then
147
- perform @SCHEMA@.lt_fail('acl_denied', 'нет права letopis.signals');
75
+ perform @SCHEMA@.lt_fail('sql-time.signals_denied');
148
76
  end if;
149
77
  return (select encode(@PGCRYPTO@.hmac(convert_to('letopis:signals', 'UTF8'), s.material, 'sha256'), 'hex')
150
78
  from @SCHEMA@.secret s where s.id = '@SYSTEM@'::uuid and s.kind = 'KEY');
@@ -158,10 +86,10 @@ set search_path = pg_catalog, @SCHEMA@, pg_temp
158
86
  return (select encode(sha256(convert_to(coalesce(string_agg(e.id::text || ':' || e.rev::text, ',' order by e.id), ''), 'UTF8')), 'hex')
159
87
  from @SCHEMA@.entity e where e.class = 'Class' and e.tenant in (@SCHEMA@.ctx_tenant(), '@SYSTEM@'::uuid));
160
88
 
161
- -- ========================= restore, purge, обрезка истории =========================
89
+ -- ========================= restore =========================
162
90
 
163
91
  -- Последняя запись журнала id под блокировкой, если она видна актору в его арендаторе: параллельные
164
- -- restore, purge, обрезка и воскрешение (trg_entity_bi берёт ту же блокировку) упорядочены.
92
+ -- restore и воскрешение (trg_entity_bi берёт ту же блокировку) упорядочены.
165
93
  create or replace function @SCHEMA@.last_version_visible(p_id uuid, p_tenant uuid, p_acl jsonb) returns @SCHEMA@.log
166
94
  language plpgsql volatile
167
95
  set search_path = pg_catalog, @SCHEMA@, pg_temp
@@ -172,9 +100,9 @@ begin
172
100
  -- арендатор id неизменен: блокируется только запись своего арендатора, чужую вызов не задерживает
173
101
  -- и по ожиданию не обнаружит (итоговое ревью безопасности)
174
102
  select x.* into l from @SCHEMA@.log x where x.id = p_id and x.tenant = p_tenant order by x.rev desc limit 1 for update;
175
- if l.id is null or l.tenant <> p_tenant or l.op in ('purge', 'reset')
103
+ if l.id is null or l.tenant <> p_tenant
176
104
  or not @SCHEMA@.row_visible(l.tenant, l.class, l.id, l.owner, l.tags, l.data, l.links, p_tenant, (p_acl->>'account')::uuid, p_acl->'plan') then
177
- perform @SCHEMA@.lt_fail('target_not_found', 'цель не найдена');
105
+ perform @SCHEMA@.lt_fail('sql-time.target_not_found');
178
106
  end if;
179
107
  return l;
180
108
  end $$;
@@ -202,44 +130,41 @@ declare
202
130
  begin
203
131
  select * into c from @SCHEMA@.ctx();
204
132
  if c.account is null then
205
- perform @SCHEMA@.lt_fail('no_session', 'нет действующей сессии');
133
+ perform @SCHEMA@.lt_fail('sql-time.no_session');
206
134
  end if;
207
135
  rd := @SCHEMA@.acl_actor('READ');
208
136
  l := @SCHEMA@.last_version_visible(p_id, c.tenant, rd);
209
137
  if l.op <> 'delete' or exists (select 1 from @SCHEMA@.entity e where e.id = p_id) then
210
- perform @SCHEMA@.lt_fail('not_deleted', 'объект не удалён: restore — только для удалённых');
138
+ perform @SCHEMA@.lt_fail('sql-time.restore_not_deleted');
211
139
  end if;
212
140
  if l.class = 'Class' then
213
- perform @SCHEMA@.lt_fail('invalid_class', 'описание класса восстанавливается созданием строки Class');
141
+ perform @SCHEMA@.lt_fail('sql-time.restore_class_row');
214
142
  end if;
215
143
  cls := @SCHEMA@.class_row(l.class, l.tenant);
216
144
  if cls.id is null then
217
- perform @SCHEMA@.lt_fail('invalid_class', format('класс %s не найден', l.class));
145
+ perform @SCHEMA@.lt_fail('sql-time.class_not_found', jsonb_build_object('cls', l.class));
218
146
  end if;
219
147
  perform @SCHEMA@.family_lock(cls, false);
220
148
  cls := @SCHEMA@.class_row(l.class, l.tenant);
221
149
  if cls.id is null then
222
- perform @SCHEMA@.lt_fail('invalid_class', format('класс %s удалён', l.class));
150
+ perform @SCHEMA@.lt_fail('sql-time.class_deleted', jsonb_build_object('cls', l.class));
223
151
  end if;
224
152
  res := cls.data->'resolved';
225
153
  if coalesce((res->>'abstract')::boolean, false) then
226
- perform @SCHEMA@.lt_fail('invalid_class', format('класс %s абстрактный', l.class));
227
- end if;
228
- if res ? 'derivedBy' then
229
- perform @SCHEMA@.lt_fail('derived_class', format('класс %s производный: его строки пишет проектор %s', l.class, res->>'derivedBy'));
154
+ perform @SCHEMA@.lt_fail('sql-time.class_abstract', jsonb_build_object('cls', l.class));
230
155
  end if;
231
156
  d := @SCHEMA@.apply_defaults(res->'schema', l.data);
232
157
  bad := @SCHEMA@.validate_data(res->'rules', cls.validator, res->'vars', d);
233
158
  if bad <> '[]'::jsonb then
234
- perform @SCHEMA@.lt_fail('invalid_data', format('данные не проходят описание класса %s', l.class), jsonb_build_object('issues', bad));
159
+ perform @SCHEMA@.lt_fail('sql-time.invalid_data', jsonb_build_object('cls', l.class), jsonb_build_object('issues', bad));
235
160
  end if;
236
161
  select * into lk from @SCHEMA@.check_links(res, l.links, l.tenant, true, rd);
237
- if lk.code is not null then
238
- perform @SCHEMA@.lt_fail(lk.code, lk.msg);
162
+ if lk.key is not null then
163
+ perform @SCHEMA@.lt_fail(lk.key, lk.params);
239
164
  end if;
240
165
  kid := @SCHEMA@.key_id(res, l.class, l.tenant, d, lk.links);
241
166
  if kid is not null and kid <> p_id then
242
- perform @SCHEMA@.lt_fail('id_mismatch', format('ключ класса %s изменился: id объекта не равен v5 от ключа', l.class), jsonb_build_object('expected', kid));
167
+ perform @SCHEMA@.lt_fail('sql-time.restore_key_changed', jsonb_build_object('cls', l.class), jsonb_build_object('expected', kid));
243
168
  end if;
244
169
  -- владелец — существующий аккаунт или арендатор
245
170
  own := l.owner;
@@ -247,16 +172,13 @@ begin
247
172
  own := l.tenant;
248
173
  end if;
249
174
  if not @SCHEMA@.acl_row_ok(@SCHEMA@.acl_plan('WRITE'), l.class, p_id, own, l.tenant, l.tags, d, lk.links) then
250
- perform @SCHEMA@.lt_fail('acl_denied', format('нет права WRITE на строку класса %s', l.class));
175
+ perform @SCHEMA@.lt_fail('sql-time.no_write_row', jsonb_build_object('cls', l.class));
251
176
  end if;
252
177
  ts := greatest(@SCHEMA@.now_ts(), l.at + interval '1 microsecond');
253
- insert into @SCHEMA@.entity (id, rev, class, cv, tenant, owner, links, data, tags, at, created_at, author, agent, op, reason, moved, prev_hash, validator)
178
+ insert into @SCHEMA@.entity (id, rev, class, cv, tenant, owner, links, data, tags, at, created_at, author, agent, op, reason, validator)
254
179
  values (p_id, l.rev + 1, l.class, cls.rev, l.tenant, own, lk.links, d, l.tags, ts, ts, c.author, c.agent, 'restore',
255
- nullif(current_setting('letopis.reason', true), ''), null, l.hash, null)
180
+ nullif(current_setting('letopis.reason', true), ''), null)
256
181
  returning * into n;
257
- -- агрегатные поля восстановленной цели триггер после вставки посчитал из живых источников в эту же версию, а не
258
- -- взял из надгробия (план 1.1, §2.4): в журнал идёт строка таблицы
259
- select x.* into n from @SCHEMA@.entity x where x.id = p_id;
260
182
  perform @SCHEMA@.log_version(n);
261
183
  if l.class in ('rule', 'Resource', 'member', 'Account') then
262
184
  perform @SCHEMA@.acl_bump();
@@ -264,357 +186,6 @@ begin
264
186
  return p_id;
265
187
  end $$;
266
188
 
267
- -- Стирание истории удалённого объекта (этап 6, п. 3): без p_confirm — превью (число версий), с ним —
268
- -- все версии удаляются, а на место версии 1 встаёт запись purge с числом стёртых версий и хэшем
269
- -- последней. Право DELETE на класс по последнему снимку. История системных классов — аудит прав и
270
- -- схемы: её не стирают.
271
- -- Проектор источника ещё не прочёл одну из версий p_id арендатора p_tenant с номером до p_rev включительно (null — все
272
- -- версии): курсор не прошёл её позицию (tx, seq), и снимок перестройки её не учёл (ревью безопасности №3, №5 — purge;
273
- -- хвост ревью №3 — обрезка истории). Проверяется каждая версия (хвост ревью доработок после 1.2.0): у более поздней
274
- -- версии бывает меньший xid, а снимок перестройки учитывает транзакции, зафиксированные до него, — непрочитанной может
275
- -- оказаться и версия между самой поздней по (tx, seq) и последней. Проектор касается арендатора, у которого есть его
276
- -- производный класс (derivedBy — имя проектора): брошенный проектор с удалёнными производными классами не держит, — и
277
- -- строки, у которой хоть одна из этих версий — в классах его источника: уход из семейства источников сменой класса он
278
- -- тоже читает. Курсор «tx:seq~снимок»; чекпоинт без from (до 1.2.0) касается всех классов. Записи purge, trim и reset —
279
- -- не версии.
280
- create or replace function @SCHEMA@.projector_unread(p_tenant uuid, p_id uuid, p_rev int) returns boolean
281
- language sql stable
282
- set search_path = pg_catalog, @SCHEMA@, pg_temp
283
- return exists (select 1 from @SCHEMA@.secret s
284
- cross join lateral (select split_part(s.meta->>'cursor', '~', 1) as head,
285
- nullif(split_part(s.meta->>'cursor', '~', 2), '') as snap) k
286
- where s.kind = 'PROJECTOR' and s.account = '@SYSTEM@'::uuid and s.deleted_at is null
287
- and coalesce(s.meta->>'cursor', '') <> ''
288
- and exists (select 1 from @SCHEMA@.entity x where x.class = 'Class' and x.tenant = p_tenant
289
- and x.data->'resolved'->>'derivedBy' = s.ident)
290
- and (not s.meta ? 'from'
291
- or exists (select 1 from (select distinct v.class from @SCHEMA@.log v
292
- where v.id = p_id and (p_rev is null or v.rev <= p_rev)
293
- and v.op not in ('purge', 'trim', 'reset')) c
294
- where coalesce((@SCHEMA@.class_row(c.class, p_tenant)).data->'resolved'->'ancestors', jsonb_build_array(c.class))
295
- ?| array(select jsonb_array_elements_text(s.meta->'from'))))
296
- and exists (select 1 from @SCHEMA@.log v
297
- where v.id = p_id and (p_rev is null or v.rev <= p_rev) and v.op not in ('purge', 'trim', 'reset')
298
- and (v.tx, v.seq) > (split_part(k.head, ':', 1)::xid8, split_part(k.head, ':', 2)::bigint)
299
- and not coalesce(pg_visible_in_snapshot(v.tx, k.snap::pg_snapshot), false)));
300
-
301
- -- до 1.4 проверялась одна позиция: надгробие у purge, самая поздняя по (tx, seq) версия у стыка обрезки
302
- drop function if exists @SCHEMA@.projector_behind(uuid, text[], xid8, bigint);
303
-
304
- create or replace function @SCHEMA@.purge(p_id uuid, p_confirm boolean default false) returns jsonb
305
- language plpgsql volatile security definer
306
- set search_path = pg_catalog, @SCHEMA@, pg_temp
307
- as $$
308
- declare
309
- c record;
310
- l @SCHEMA@.log;
311
- n int;
312
- begin
313
- select * into c from @SCHEMA@.ctx();
314
- if c.account is null then
315
- perform @SCHEMA@.lt_fail('no_session', 'нет действующей сессии');
316
- end if;
317
- l := @SCHEMA@.last_version_visible(p_id, c.tenant, @SCHEMA@.acl_actor('READ'));
318
- if l.op <> 'delete' or exists (select 1 from @SCHEMA@.entity e where e.id = p_id) then
319
- perform @SCHEMA@.lt_fail('not_deleted', 'объект не удалён: purge — только для удалённых, сначала delete()');
320
- end if;
321
- if l.class in ('Class', 'Account', 'member', 'Resource', 'rule') then
322
- perform @SCHEMA@.lt_fail('invalid_class', 'история системных классов — аудит прав и схемы: purge недоступен');
323
- end if;
324
- if not @SCHEMA@.acl_row_ok(@SCHEMA@.acl_plan('DELETE'), l.class, l.id, l.owner, l.tenant, l.tags, l.data, l.links) then
325
- perform @SCHEMA@.lt_fail('acl_denied', format('нет права DELETE на класс %s', l.class));
326
- end if;
327
- -- проектор источника, который ещё не прочёл какую-то версию строки (в том числе надгробие этой транзакции), об
328
- -- удалении не узнал бы — вклад строки остался бы в итогах навсегда (ревью безопасности №3, №5)
329
- if @SCHEMA@.projector_unread(l.tenant, p_id, null) then
330
- perform @SCHEMA@.lt_fail('projector_pending', 'проектор источника ещё не прочёл удаление: purge — после его run()');
331
- end if;
332
- select count(*)::int into n from @SCHEMA@.log x where x.id = p_id;
333
- if not coalesce(p_confirm, false) then
334
- return jsonb_build_object('id', p_id, 'class', l.class, 'versions', n, 'purged', false);
335
- end if;
336
- delete from @SCHEMA@.log x where x.id = p_id;
337
- insert into @SCHEMA@.log (id, rev, class, cv, tenant, owner, links, data, tags, at, author, agent, op, reason, moved, prev_hash)
338
- values (p_id, 1, l.class, l.cv, l.tenant, l.tenant, '{}', jsonb_build_object('$purged', n, '$hash', encode(l.hash, 'hex')), '{}',
339
- greatest(@SCHEMA@.now_ts(), l.at + interval '1 microsecond'), coalesce(c.author, '@SYSTEM@'::uuid), c.agent, 'purge',
340
- nullif(current_setting('letopis.reason', true), ''), null, null);
341
- -- воскрешение, зафиксированное, пока purge ждал блокировку, — отказ (снимок нового оператора его видит)
342
- if exists (select 1 from @SCHEMA@.entity e where e.id = p_id) then
343
- perform @SCHEMA@.lt_fail('not_deleted', 'объект восстановлен во время purge');
344
- end if;
345
- perform @SCHEMA@.signal(array[l.class], array[l.tenant]);
346
- return jsonb_build_object('id', p_id, 'class', l.class, 'versions', n, 'purged', true);
347
- end $$;
348
-
349
- -- Обрезка истории (этап 6, п. 3; замена compact 0.21): версии строже момента p_before удаляются,
350
- -- текущая — никогда. Время версий одного id монотонно, поэтому удаляется начало истории — и всегда
351
- -- версия 1: на её место встаёт запись trim со временем прежней версии 1 (срез на момент знает, когда
352
- -- объект появился), номером последней стёртой версии ($trimmed) и её хэшем ($hash) — по ним verify()
353
- -- проверяет стык. Цели — p_ids или все объекты классов p_classes арендатора; право DELETE на каждую
354
- -- (по последней версии). Возвращает число стёртых версий.
355
- create or replace function @SCHEMA@.trim_history(p_ids uuid[], p_classes text[], p_before timestamptz) returns int
356
- language plpgsql volatile security definer
357
- set search_path = pg_catalog, @SCHEMA@, pg_temp
358
- as $$
359
- declare
360
- c record;
361
- rd jsonb;
362
- dplan jsonb;
363
- r @SCHEMA@.log;
364
- first @SCHEMA@.log;
365
- nxt record;
366
- j int;
367
- h bytea;
368
- k int;
369
- total int := 0;
370
- classes text[] := '{}';
371
- begin
372
- select * into c from @SCHEMA@.ctx();
373
- if c.account is null then
374
- perform @SCHEMA@.lt_fail('no_session', 'нет действующей сессии');
375
- end if;
376
- if p_before is null or (p_ids is null and p_classes is null) then
377
- perform @SCHEMA@.lt_fail('invalid_data', 'обрезка истории: нужны цели и момент');
378
- end if;
379
- rd := @SCHEMA@.acl_actor('READ');
380
- dplan := @SCHEMA@.acl_plan('DELETE');
381
- if p_ids is not null then
382
- -- явные цели: каждая обязана найтись
383
- for r in select distinct on (u.x) l.* from unnest(p_ids) u(x)
384
- left join lateral (select * from @SCHEMA@.log x where x.id = u.x order by x.rev desc limit 1) l on true
385
- order by u.x loop
386
- if r.id is null or r.tenant <> c.tenant or r.op in ('purge', 'reset')
387
- or not @SCHEMA@.row_visible(r.tenant, r.class, r.id, r.owner, r.tags, r.data, r.links, c.tenant, c.account, rd->'plan') then
388
- perform @SCHEMA@.lt_fail('target_not_found', 'цель не найдена');
389
- end if;
390
- end loop;
391
- end if;
392
- for r in select distinct on (l.id) l.* from @SCHEMA@.log l
393
- where l.tenant = c.tenant and (case when p_ids is not null then l.id = any (p_ids) else l.class = any (p_classes) end)
394
- order by l.id, l.rev desc loop
395
- continue when r.op in ('purge', 'reset')
396
- or not @SCHEMA@.row_visible(r.tenant, r.class, r.id, r.owner, r.tags, r.data, r.links, c.tenant, c.account, rd->'plan');
397
- if r.class in ('Class', 'Account', 'member', 'Resource', 'rule') then
398
- perform @SCHEMA@.lt_fail('invalid_class', 'история системных классов — аудит прав и схемы: обрезка недоступна');
399
- end if;
400
- if not @SCHEMA@.acl_row_ok(dplan, r.class, r.id, r.owner, r.tenant, r.tags, r.data, r.links) then
401
- perform @SCHEMA@.lt_fail('acl_denied', format('нет права DELETE на класс %s', r.class));
402
- end if;
403
- -- версии id под блокировкой: параллельная обрезка и прореживание ждут
404
- perform 1 from @SCHEMA@.log x where x.id = r.id order by x.rev for update;
405
- select max(x.rev) into j from @SCHEMA@.log x where x.id = r.id and x.at < p_before and x.rev < r.rev;
406
- continue when j is null;
407
- select x.* into first from @SCHEMA@.log x where x.id = r.id order by x.rev limit 1;
408
- -- до момента — только сама запись trim: стирать нечего
409
- continue when j = 1 and first.op = 'trim';
410
- -- проектор источника, который ещё не прочёл стираемые версии или первую оставшуюся: читая её, он возьмёт прошлую
411
- -- версию для before, а её уже не будет — свёртка прибавила бы новую, не вычитая прежнюю (хвост ревью безопасности
412
- -- №3); каждая версия до первой оставшейся — у более поздней версии бывает меньший xid
413
- select x.rev into nxt from @SCHEMA@.log x where x.id = r.id and x.rev > j order by x.rev limit 1;
414
- if @SCHEMA@.projector_unread(r.tenant, r.id, nxt.rev) then
415
- perform @SCHEMA@.lt_fail('projector_pending', 'проектор источника ещё не прочёл версии: trimHistory — после его run()');
416
- end if;
417
- select x.hash into h from @SCHEMA@.log x where x.id = r.id and x.rev = j;
418
- with d as (delete from @SCHEMA@.log x where x.id = r.id and x.rev <= j returning 1)
419
- select count(*)::int into k from d;
420
- insert into @SCHEMA@.log (id, rev, class, cv, tenant, owner, links, data, tags, at, author, agent, op, reason, moved, prev_hash)
421
- values (r.id, 1, r.class, r.cv, r.tenant, r.tenant, '{}', jsonb_build_object('$trimmed', j, '$hash', encode(h, 'hex')), '{}',
422
- first.at, coalesce(c.author, '@SYSTEM@'::uuid), c.agent, 'trim', nullif(current_setting('letopis.reason', true), ''), null, null);
423
- -- запись trim заменяет версию 1: стёрто на одну меньше, если версия 1 была прежней записью trim
424
- total := total + k - case when first.op = 'trim' then 1 else 0 end;
425
- classes := classes || r.class;
426
- end loop;
427
- perform @SCHEMA@.signal(array_agg(d.x), array_agg(c.tenant)) from (select distinct x from unnest(classes) x) d;
428
- return total;
429
- end $$;
430
-
431
- -- ========================= смена ключа =========================
432
-
433
- -- Новое значение ключа объекта (этап 6, п. 7): p_data сливается с данными, p_links заменяет концы
434
- -- по ролям; новый id — v5 от нового ключа. Механизм — тот же, что у reclass(): строка с новым id,
435
- -- перевод ссылок (рекурсивно для строк, в ключ которых входит конец), надгробие старого id со
436
- -- ссылкой на новый. Ключ не изменился — обычная правка неключевых полей.
437
- create or replace function @SCHEMA@.rekey(p_id uuid, p_data jsonb default null, p_links jsonb default null) returns uuid
438
- language plpgsql volatile security definer
439
- set search_path = pg_catalog, @SCHEMA@, pg_temp
440
- as $$
441
- declare
442
- c record;
443
- rd jsonb;
444
- wplan jsonb;
445
- o @SCHEMA@.entity;
446
- cls @SCHEMA@.entity;
447
- res jsonb;
448
- d jsonb;
449
- bad jsonb;
450
- lk record;
451
- nid uuid;
452
- denied text;
453
- n_denied int;
454
- begin
455
- select * into c from @SCHEMA@.ctx();
456
- if c.account is null then
457
- perform @SCHEMA@.lt_fail('no_session', 'нет действующей сессии');
458
- end if;
459
- if current_setting('transaction_isolation') <> 'read committed' then
460
- perform @SCHEMA@.lt_fail('isolation_level', 'смена ключа разрешена только в read committed');
461
- end if;
462
- rd := @SCHEMA@.acl_actor('READ');
463
- wplan := @SCHEMA@.acl_plan('WRITE');
464
- select x.* into o from @SCHEMA@.entity x where x.id = p_id and x.tenant = c.tenant for update;
465
- if o.id is null or not @SCHEMA@.row_visible(o.tenant, o.class, o.id, o.owner, o.tags, o.data, o.links, c.tenant, c.account, rd->'plan') then
466
- perform @SCHEMA@.lt_fail('target_not_found', 'цель не найдена');
467
- end if;
468
- if not @SCHEMA@.acl_row_ok(wplan, o.class, o.id, o.owner, o.tenant, o.tags, o.data, o.links) then
469
- perform @SCHEMA@.lt_fail('acl_denied', format('нет права WRITE на строку класса %s', o.class));
470
- end if;
471
- if o.class in ('Class', 'Account', 'member', 'Resource', 'rule') then
472
- perform @SCHEMA@.lt_fail('invalid_class', 'ключ системной строки не меняется');
473
- end if;
474
- cls := @SCHEMA@.class_row(o.class, o.tenant);
475
- perform @SCHEMA@.family_lock(cls, false);
476
- cls := @SCHEMA@.class_row(o.class, o.tenant);
477
- if cls.id is null then
478
- perform @SCHEMA@.lt_fail('invalid_class', format('класс %s удалён', o.class));
479
- end if;
480
- res := cls.data->'resolved';
481
- if res ? 'derivedBy' then
482
- perform @SCHEMA@.lt_fail('derived_class', format('класс %s производный: его строки пишет проектор %s', o.class, res->>'derivedBy'));
483
- end if;
484
- if jsonb_array_length(coalesce(res->'key', '[]'::jsonb)) = 0 then
485
- perform @SCHEMA@.lt_fail('invalid_class', format('у класса %s нет ключа: id выдаёт база, менять нечего', o.class));
486
- end if;
487
- if res ? 'aggregate' and coalesce(p_data, '{}'::jsonb) ?| @SCHEMA@.agg_fields(res) then
488
- perform @SCHEMA@.lt_fail('aggregate_field', format('агрегатные поля класса %s считает база — в rekey их не передают', o.class));
489
- end if;
490
- d := @SCHEMA@.apply_defaults(res->'schema', @SCHEMA@.merge(o.data, coalesce(p_data, '{}'::jsonb)));
491
- bad := @SCHEMA@.validate_data(res->'rules', cls.validator, res->'vars', d);
492
- if bad <> '[]'::jsonb then
493
- perform @SCHEMA@.lt_fail('invalid_data', format('данные не проходят описание класса %s', o.class), jsonb_build_object('issues', bad));
494
- end if;
495
- select * into lk from @SCHEMA@.check_links(res, o.links || coalesce(p_links, '{}'::jsonb), o.tenant, true, rd);
496
- if lk.code is not null then
497
- perform @SCHEMA@.lt_fail(lk.code, lk.msg);
498
- end if;
499
- nid := @SCHEMA@.key_id(res, o.class, o.tenant, d, lk.links);
500
- if not @SCHEMA@.acl_row_ok(wplan, o.class, nid, o.owner, o.tenant, o.tags, d, lk.links) then
501
- perform @SCHEMA@.lt_fail('acl_denied', format('нет права WRITE на класс %s', o.class));
502
- end if;
503
- if nid = o.id then
504
- if d is distinct from o.data or lk.links is distinct from o.links then
505
- perform @SCHEMA@.sys_update(o.id, d, lk.links, null, 'update');
506
- end if;
507
- return o.id;
508
- end if;
509
- -- перевод ссылок пишет ссылающиеся строки: на них тоже нужно право WRITE (глубже первого уровня — move_row); класс
510
- -- такой строки называется, только если актор её видит (доработки после точки Б)
511
- select min(x.class) filter (where @SCHEMA@.row_visible(x.tenant, x.class, x.id, x.owner, x.tags, x.data, x.links, c.tenant, c.account, rd->'plan')),
512
- count(*) into denied, n_denied from @SCHEMA@.entity x
513
- where x.ends @> array[o.id] and not @SCHEMA@.acl_row_ok(wplan, x.class, x.id, x.owner, x.tenant, x.tags, x.data, x.links);
514
- if n_denied > 0 then
515
- perform @SCHEMA@.lt_fail('acl_denied', case when denied is not null then format('нет права WRITE на ссылающиеся строки класса %s', denied)
516
- else 'нет права WRITE на ссылающиеся строки' end);
517
- end if;
518
- perform @SCHEMA@.move_row(o, nid, o.class, d, lk.links, 'rekey', wplan);
519
- return nid;
520
- end $$;
521
-
522
- -- Новый ключ класса (этап 6, п. 7): описание класса и потомков, наследующих ключ, пересчитывается,
523
- -- каждая строка семейства с другим id переносится на новый id (move_row). Исключительная
524
- -- блокировка корня семейства приостанавливает запись в семейство до фиксации. Возвращает число
525
- -- перенесённых строк класса (ссылающиеся строки с концом в ключе переносятся рекурсивно и не считаются).
526
- create or replace function @SCHEMA@.rekey_class(p_class text, p_key jsonb) returns int
527
- language plpgsql volatile security definer
528
- set search_path = pg_catalog, @SCHEMA@, pg_temp
529
- as $$
530
- declare
531
- c record;
532
- wplan jsonb;
533
- cr @SCHEMA@.entity;
534
- prep record;
535
- dsc @SCHEMA@.entity;
536
- classes text[];
537
- r @SCHEMA@.entity;
538
- res jsonb;
539
- nid uuid;
540
- n int := 0;
541
- conflicts jsonb;
542
- dname text;
543
- begin
544
- select * into c from @SCHEMA@.ctx();
545
- if c.account is null then
546
- perform @SCHEMA@.lt_fail('no_session', 'нет действующей сессии');
547
- end if;
548
- if current_setting('transaction_isolation') <> 'read committed' then
549
- perform @SCHEMA@.lt_fail('isolation_level', 'смена ключа разрешена только в read committed');
550
- end if;
551
- wplan := @SCHEMA@.acl_plan('WRITE');
552
- cr := @SCHEMA@.class_row(p_class, c.tenant);
553
- if cr.id is null or cr.tenant <> c.tenant then
554
- perform @SCHEMA@.lt_fail('invalid_class', format('класс %s не найден среди классов арендатора', p_class));
555
- end if;
556
- if coalesce((cr.data->>'system')::boolean, false) then
557
- perform @SCHEMA@.lt_fail('invalid_class', 'ключ системного класса не меняется');
558
- end if;
559
- -- строки производного класса (и его потомков) переносит только владелец: ключ меняют в описании, а строки
560
- -- строит заново проектор (rebuild)
561
- if cr.data->'resolved' ? 'derivedBy' then
562
- perform @SCHEMA@.lt_fail('derived_class', format('класс %s производный: его строки пишет проектор %s', p_class, cr.data->'resolved'->>'derivedBy'));
563
- end if;
564
- -- и потомки: производный потомок непроизводного предка наследует его ключ, а его строки переносит только проектор
565
- -- (доработки после точки Б)
566
- select x.data->>'name' into dname from @SCHEMA@.entity x
567
- where x.class = 'Class' and x.tenant = cr.tenant and x.id <> cr.id
568
- and x.data->'resolved'->'ancestors' ? p_class and x.data->'resolved' ? 'derivedBy'
569
- order by x.data->>'name' limit 1;
570
- if dname is not null then
571
- perform @SCHEMA@.lt_fail('derived_class', format('у класса %s производный потомок %s: его строки пишет проектор', p_class, dname));
572
- end if;
573
- if not @SCHEMA@.acl_row_ok(wplan, 'Class', cr.id, cr.owner, cr.tenant, cr.tags, cr.data, cr.links) then
574
- perform @SCHEMA@.lt_fail('acl_denied', 'нет права WRITE на класс Class');
575
- end if;
576
- -- смена ключа проверяет все строки семейства и отвечает числом нарушающих — как ужесточение, только с правом READ без
577
- -- условий на все строки класса и потомков (доработки после точки Б)
578
- perform @SCHEMA@.class_rows_admit(p_class, cr.tenant, array['READ'], format('смена ключа класса %s', p_class));
579
- perform @SCHEMA@.family_lock(cr, true);
580
- select x.* into cr from @SCHEMA@.entity x where x.id = cr.id for update;
581
- select p.data, p.validator into prep from @SCHEMA@.class_prepare(cr.data || jsonb_build_object('key', p_key), cr.tenant) p;
582
- perform @SCHEMA@.sys_update(cr.id, prep.data, cr.links, prep.validator, 'update');
583
- classes := array[p_class];
584
- -- потомки: описание пересчитывается (каждый пересчёт — версия класса в журнале)
585
- for dsc in select x.* from @SCHEMA@.entity x
586
- where x.class = 'Class' and x.tenant = cr.tenant and x.id <> cr.id
587
- and x.data->'resolved'->'ancestors' ? p_class
588
- order by jsonb_array_length(x.data->'resolved'->'ancestors'), x.id loop
589
- select p.data, p.validator into prep from @SCHEMA@.class_prepare(dsc.data, dsc.tenant) p;
590
- if prep.data is distinct from dsc.data or prep.validator::text is distinct from dsc.validator::text then
591
- perform @SCHEMA@.sys_update(dsc.id, prep.data, dsc.links, prep.validator, 'update');
592
- end if;
593
- classes := classes || (dsc.data->>'name');
594
- end loop;
595
- for r in select x.* from @SCHEMA@.entity x where x.class = any (classes) and x.tenant = cr.tenant order by x.id loop
596
- -- строку мог уже перенести перевод ссылок (конец в её ключе): берём свежую
597
- select x.* into r from @SCHEMA@.entity x where x.id = r.id for update;
598
- continue when r.id is null;
599
- if not @SCHEMA@.acl_row_ok(wplan, r.class, r.id, r.owner, r.tenant, r.tags, r.data, r.links) then
600
- perform @SCHEMA@.lt_fail('acl_denied', format('нет права WRITE на строку класса %s', r.class));
601
- end if;
602
- res := (@SCHEMA@.class_row(r.class, r.tenant)).data->'resolved';
603
- nid := coalesce(@SCHEMA@.key_id(res, r.class, r.tenant, r.data, r.links), r.id);
604
- if nid <> r.id then
605
- perform @SCHEMA@.move_row(r, nid, r.class, r.data, r.links, 'rekey', wplan);
606
- n := n + 1;
607
- end if;
608
- end loop;
609
- conflicts := @SCHEMA@.family_conflicts(classes, cr.tenant, false);
610
- if conflicts <> '[]'::jsonb then
611
- perform @SCHEMA@.lt_fail('tightening_conflict', format('новому ключу класса %s не соответствуют строки', p_class),
612
- @SCHEMA@.visible_detail(conflicts, c.tenant));
613
- end if;
614
- perform @SCHEMA@.acl_bump();
615
- return n;
616
- end $$;
617
-
618
189
  -- ========================= удаление аккаунта =========================
619
190
 
620
191
  -- Удаление аккаунта (этап 6, п. 3; accounts.purge 0.21): вызывающий — системный администратор или
@@ -641,10 +212,10 @@ declare
641
212
  begin
642
213
  select * into c from @SCHEMA@.ctx();
643
214
  if c.account is null then
644
- perform @SCHEMA@.lt_fail('no_session', 'нет действующей сессии');
215
+ perform @SCHEMA@.lt_fail('sql-time.no_session');
645
216
  end if;
646
217
  if p_account = c.account then
647
- perform @SCHEMA@.lt_fail('acl_denied', 'удалить себя нельзя');
218
+ perform @SCHEMA@.lt_fail('sql-time.purge_self');
648
219
  end if;
649
220
  -- право — до поиска и блокировки цели: без права ответ один (acl_denied), есть ли такой аккаунт,
650
221
  -- не видно, и чужую строку Account вызов не блокирует (итоговое ревью безопасности)
@@ -652,11 +223,11 @@ begin
652
223
  select 1 from @SCHEMA@.entity x
653
224
  where x.id = @SCHEMA@.v5_id(p_account, 'member', array[c.account::text, p_account::text]) and x.class = 'member'
654
225
  and x.tenant = p_account and coalesce(x.data->'roles' ? 'owner', false))) then
655
- perform @SCHEMA@.lt_fail('acl_denied', 'удалить аккаунт может системный администратор или владелец его арендатора');
226
+ perform @SCHEMA@.lt_fail('sql-time.account_purge_denied');
656
227
  end if;
657
228
  select x.* into a from @SCHEMA@.entity x where x.id = p_account and x.class = 'Account' and x.tenant = '@SYSTEM@'::uuid for update;
658
229
  if a.id is null or p_account = '@SYSTEM@'::uuid then
659
- perform @SCHEMA@.lt_fail('target_not_found', 'аккаунт не найден');
230
+ perform @SCHEMA@.lt_fail('sql-time.account_not_found');
660
231
  end if;
661
232
  -- владелец стирает арендатора, в котором работает: его членство уйдёт вместе с данными, а надгробия и
662
233
  -- передача владения ниже перечитывают ctx() — остаток операции идёт в личном арендаторе вызывающего,
@@ -674,7 +245,7 @@ begin
674
245
  join @SCHEMA@.entity u on u.id = (x.links->>'User')::uuid and u.class = 'Account' and u.tenant = '@SYSTEM@'::uuid
675
246
  where x.class = 'member' and x.tenant = t.tenant and x.links->>'User' <> p_account::text
676
247
  and coalesce(x.data->'roles' ? 'owner', false) and coalesce((u.data->>'enabled')::boolean, true)) then
677
- perform @SCHEMA@.lt_fail('acl_denied', format('аккаунт — последний владелец арендатора %s', t.tenant), jsonb_build_object('tenant', t.tenant));
248
+ perform @SCHEMA@.lt_fail('sql-time.last_owner', jsonb_build_object('tenant', t.tenant), jsonb_build_object('tenant', t.tenant));
678
249
  end if;
679
250
  end loop;
680
251
  -- данные арендатора-цели — физически, вместе с журналом
@@ -693,7 +264,7 @@ begin
693
264
  select coalesce(jsonb_agg(jsonb_build_object('id', x.id, 'class', x.class, 'tenant', x.tenant)), '[]'::jsonb) into blockers
694
265
  from (select x.id, x.class, x.tenant from @SCHEMA@.entity x where x.ends @> array[p_account] order by x.id limit 1000) x;
695
266
  if blockers <> '[]'::jsonb then
696
- perform @SCHEMA@.lt_fail('delete_restricted', 'на аккаунт ссылаются другие строки', @SCHEMA@.visible_detail(blockers, c.tenant));
267
+ perform @SCHEMA@.lt_fail('sql-time.account_referenced', '{}'::jsonb, @SCHEMA@.visible_detail(blockers, c.tenant));
697
268
  end if;
698
269
  -- сессии аккаунта гасит с сигналом триггер до удаления (trg_entity_bd_account, срабатывает и для владельца), а его
699
270
  -- строки secret — сессии и креды — стирает каскад внешнего ключа secret.account (ревизия 7)
@@ -706,202 +277,28 @@ begin
706
277
  return jsonb_build_object('account', p_account, 'rows', n_rows, 'versions', n_log, 'memberships', n_mem, 'owned', n_own);
707
278
  end $$;
708
279
 
709
- -- ========================= сброс =========================
710
-
711
- -- Запись reset — первая запись журнала после сброса: свой id в арендаторе, класс #reset (такое имя
712
- -- класс получить не может), вид reset.
713
- create or replace function @SCHEMA@.reset_mark(p_tenant uuid, p_level text, p_author uuid) returns void
714
- language sql volatile
715
- set search_path = pg_catalog, @SCHEMA@, pg_temp
716
- as $$
717
- insert into @SCHEMA@.log (id, rev, class, tenant, owner, links, data, tags, at, author, agent, op, reason)
718
- values (@SCHEMA@.v5_id(p_tenant, '#reset', array[gen_random_uuid()::text]), 1, '#reset', p_tenant, p_tenant, '{}',
719
- jsonb_build_object('$reset', p_level), '{}', @SCHEMA@.now_ts(), coalesce(p_author, '@SYSTEM@'::uuid), null, 'reset',
720
- nullif(current_setting('letopis.reason', true), ''))
721
- $$;
722
-
723
- -- Сброс (этап 6, п. 6): sessions — все сессии, кроме текущей; tenant — строки и журнал арендатора
724
- -- (пачками по p_limit: done = false — вызвать ещё раз); all — всё, затем системный сид и новый
725
- -- сервисный ключ (возвращается). Предохранители: флаг allow_reset (по умолчанию выключен — отказ
726
- -- даже System), право letopis.reset, подтверждение именем схемы.
727
- create or replace function @SCHEMA@.reset(p_level text, p_confirm text, p_tenant uuid default null, p_limit int default null) returns jsonb
728
- language plpgsql volatile security definer
729
- set search_path = pg_catalog, @SCHEMA@, pg_temp
730
- as $$
731
- declare
732
- c record;
733
- t uuid;
734
- n int;
735
- m int;
736
- key text;
737
- held boolean;
738
- begin
739
- if not @ALLOW_RESET@ then
740
- perform @SCHEMA@.lt_fail('reset_disabled', 'reset выключен в этой установке (up({ allowReset }))');
741
- end if;
742
- select * into c from @SCHEMA@.ctx();
743
- if not @SCHEMA@.letopis_allowed('letopis.reset') then
744
- perform @SCHEMA@.lt_fail('acl_denied', 'нет права letopis.reset');
745
- end if;
746
- if p_confirm is distinct from '@SCHEMA_NAME@' then
747
- perform @SCHEMA@.lt_fail('confirm_mismatch', 'подтверждение сброса — имя схемы установки');
748
- end if;
749
- case p_level
750
- when 'sessions' then
751
- with d as (delete from @SCHEMA@.secret s where s.kind = 'SESSION' and s.id is distinct from c.session returning 1)
752
- select count(*)::int into n from d;
753
- perform @SCHEMA@.reset_mark('@SYSTEM@'::uuid, p_level, c.author);
754
- perform @SCHEMA@.signal_raw(array['session:*']);
755
- return jsonb_build_object('level', p_level, 'sessions', n);
756
- when 'tenant' then
757
- t := coalesce(p_tenant, c.tenant);
758
- if t is null or t = '@SYSTEM@'::uuid then
759
- perform @SCHEMA@.lt_fail('tenant_denied', 'System сбрасывается только целиком (level all)');
760
- end if;
761
- if not exists (select 1 from @SCHEMA@.entity a where a.id = t and a.class = 'Account' and a.tenant = '@SYSTEM@'::uuid) then
762
- perform @SCHEMA@.lt_fail('target_not_found', 'арендатор не найден');
763
- end if;
764
- -- строки арендатора стираются пачками в любом порядке: агрегаты его целей (план 1.1, §2.4) не пересчитываются —
765
- -- цели уходят вместе с источниками, а промежуточный итог пачки мог бы выйти за правило класса
766
- held := @SCHEMA@.agg_hold_begin('off');
767
- with d as (delete from @SCHEMA@.entity x where x.id in (
768
- select y.id from @SCHEMA@.entity y where y.tenant = t limit coalesce(p_limit, 2147483647)) returning 1)
769
- select count(*)::int into n from d;
770
- if held then
771
- perform @SCHEMA@.agg_hold_end(false);
772
- end if;
773
- with d as (delete from @SCHEMA@.log x where x.seq in (
774
- select y.seq from @SCHEMA@.log y where y.tenant = t limit coalesce(p_limit, 2147483647)) returning 1)
775
- select count(*)::int into m from d;
776
- if exists (select 1 from @SCHEMA@.entity y where y.tenant = t) or exists (select 1 from @SCHEMA@.log y where y.tenant = t) then
777
- return jsonb_build_object('level', p_level, 'tenant', t, 'rows', n, 'versions', m, 'done', false);
778
- end if;
779
- perform @SCHEMA@.reset_mark(t, p_level, c.author);
780
- perform @SCHEMA@.signal_raw(array['*']);
781
- perform @SCHEMA@.acl_bump();
782
- return jsonb_build_object('level', p_level, 'tenant', t, 'rows', n, 'versions', m, 'done', true);
783
- when 'all' then
784
- truncate @SCHEMA@.entity, @SCHEMA@.log, @SCHEMA@.secret;
785
- perform @SCHEMA@.reset_mark('@SYSTEM@'::uuid, p_level, c.author);
786
- perform @SCHEMA@.seed_system();
787
- key := 'lts_' || encode(@PGCRYPTO@.gen_random_bytes(32), 'hex');
788
- perform @SCHEMA@.bootstrap_service(key);
789
- perform @SCHEMA@.signal_raw(array['*', 'session:*']);
790
- return jsonb_build_object('level', p_level, 'serviceKey', key);
791
- else
792
- perform @SCHEMA@.lt_fail('invalid_data', format('уровень сброса %s: sessions, tenant или all', p_level));
793
- end case;
794
- return null;
795
- end $$;
796
-
797
280
  -- ========================= обслуживание =========================
798
281
 
799
- -- Одна пачка прореживания журнала (§2.11): версии, которые не нужны действующей политике хранения
800
- -- своего класса. Не трогаются версия 1, текущая и версии особых видов (create, delete, reclass,
801
- -- rekey, restore, purge, reset, trim); история удалённого объекта, надгробие которого старше
802
- -- последнего яруса со сроком, стирается целиком. Пачка — до 100 объектов после курсора (meta
803
- -- строки ключа: участки по порядку id), не больше p_limit версий; объект, не вошедший целиком,
804
- -- достаётся следующей пачке. Курсор дошёл до конца — сбрасывается (more = false).
805
- create or replace function @SCHEMA@.thin_batch(p_now timestamptz, p_limit int) returns jsonb
806
- language plpgsql volatile
807
- set search_path = pg_catalog, @SCHEMA@, pg_temp
808
- as $$
809
- declare
810
- cur uuid;
811
- ids uuid[];
812
- vid uuid[];
813
- vrev int[];
814
- total int;
815
- k int;
816
- nxt uuid;
817
- more boolean;
818
- begin
819
- select (s.meta->>'thin')::uuid into cur from @SCHEMA@.secret s where s.id = '@SYSTEM@'::uuid for update;
820
- -- умолчание установки прореживает журнал: verify() и после его снятия считает такие пропуски законными
821
- if @SCHEMA@.history_default() is not null then
822
- update @SCHEMA@.secret s set meta = s.meta || '{"default_policy": true}' where s.id = '@SYSTEM@'::uuid and not (s.meta ? 'default_policy');
823
- end if;
824
- with pol as (
825
- select x.data->>'name' as cls, x.tenant as ct, @SCHEMA@.history_policy(x.data->'resolved') as p
826
- from @SCHEMA@.entity x where x.class = 'Class'
827
- )
828
- select array_agg(q.id order by q.id) into ids from (
829
- select distinct l.id from @SCHEMA@.log l
830
- join pol on pol.p is not null and pol.cls = l.class and (pol.ct = l.tenant or pol.ct = '@SYSTEM@'::uuid)
831
- where l.at < p_now - @SCHEMA@.history_iv(pol.p->>'all') and (cur is null or l.id > cur)
832
- order by l.id limit 100) q;
833
- if ids is null then
834
- update @SCHEMA@.secret s set meta = s.meta - 'thin' where s.id = '@SYSTEM@'::uuid;
835
- return jsonb_build_object('thinned', 0, 'more', false);
836
- end if;
837
- with pol as (
838
- select x.data->>'name' as cls, x.tenant as ct, @SCHEMA@.history_policy(x.data->'resolved') as p
839
- from @SCHEMA@.entity x where x.class = 'Class'
840
- ), v as (
841
- select l.id, l.rev, l.at, l.op, pol.p, coalesce(pol.p->>'tz', 'UTC') as tz,
842
- max(l.rev) over (partition by l.id) as last_rev,
843
- first_value(l.op) over (partition by l.id order by l.rev desc) as last_op,
844
- first_value(l.at) over (partition by l.id order by l.rev desc) as last_at,
845
- lead(l.at) over (partition by l.id order by l.rev) as next_at
846
- from @SCHEMA@.log l
847
- join pol on pol.p is not null and pol.cls = l.class and (pol.ct = l.tenant or pol.ct = '@SYSTEM@'::uuid)
848
- where l.id = any (ids)
849
- )
850
- select array_agg(v.id order by v.id, v.rev), array_agg(v.rev order by v.id, v.rev) into vid, vrev
851
- from v
852
- where (v.last_op = 'delete' and timezone(v.tz, v.last_at) <= timezone(v.tz, p_now) - @SCHEMA@.history_horizon(v.p))
853
- or (v.rev <> 1 and v.rev <> v.last_rev
854
- and v.op not in ('create', 'delete', 'reclass', 'rekey', 'restore', 'purge', 'reset', 'trim')
855
- and not @SCHEMA@.history_keep(v.p, timezone(v.tz, v.at), timezone(v.tz, p_now), timezone(v.tz, v.next_at)));
856
- total := coalesce(cardinality(vid), 0);
857
- k := least(total, p_limit);
858
- if k > 0 then
859
- delete from @SCHEMA@.log l using unnest(vid[1:k], vrev[1:k]) u(id, rev) where l.id = u.id and l.rev = u.rev;
860
- end if;
861
- if total > p_limit then
862
- -- объект на границе пачки — снова в следующей
863
- nxt := vid[p_limit + 1];
864
- cur := (select x from unnest(ids) x where x < nxt order by x desc limit 1);
865
- more := true;
866
- elsif cardinality(ids) = 100 then
867
- cur := ids[100];
868
- more := true;
869
- else
870
- cur := null;
871
- more := false;
872
- end if;
873
- update @SCHEMA@.secret s set meta = case when cur is null then s.meta - 'thin' else s.meta || jsonb_build_object('thin', cur) end
874
- where s.id = '@SYSTEM@'::uuid;
875
- return jsonb_build_object('thinned', k, 'more', more);
876
- end $$;
877
-
878
- -- Обслуживание (этап 6, п. 8): истёкшие и погашенные сессии и одноразовые коды, одна пачка
879
- -- прореживания журнала, заполнение очереди сигналов. Вызывает системный администратор, роль с
880
- -- правом letopis.maintain или администраторское подключение. p_now — момент «сейчас» для
881
- -- прореживания, только при allow_reset (тесты): иначе одним вызовом можно было бы проредить всю историю.
882
- create or replace function @SCHEMA@.maintain(p_now timestamptz default null, p_limit int default 10000) returns jsonb
282
+ -- Обслуживание (этап 6, п. 8): истёкшие и погашенные сессии и одноразовые коды, строки-замки удалённых семейств,
283
+ -- заполнение очереди сигналов. Вызывает системный администратор, роль с правом letopis.maintain или администраторское
284
+ -- подключение. Один исполнитель: обслуживание идёт одной транзакцией под строкой-замком; занята — null.
285
+ create or replace function @SCHEMA@.maintain() returns jsonb
883
286
  language plpgsql volatile security definer
884
287
  set search_path = pg_catalog, @SCHEMA@, pg_temp
885
288
  as $$
886
289
  declare
887
- ts timestamptz := clock_timestamp();
888
290
  s int;
889
291
  o int;
292
+ fam text := '@SCHEMA_NAME@:family:';
890
293
  begin
891
294
  if not @SCHEMA@.letopis_allowed('letopis.maintain') then
892
- perform @SCHEMA@.lt_fail('acl_denied', 'нет права letopis.maintain');
295
+ perform @SCHEMA@.lt_fail('sql-time.maintain_denied');
893
296
  end if;
894
- -- один исполнитель: строка-замок до конца транзакции пачки (lock_try) — посторонняя роль её не займёт (ревью
297
+ -- один исполнитель: строка-замок до конца транзакции (lock_try) — посторонняя роль её не займёт (ревью
895
298
  -- безопасности №3, №2); занята — null, обслуживание продолжит держатель
896
299
  if not @SCHEMA@.lock_try('@SCHEMA_NAME@:maintain') then
897
300
  return null;
898
301
  end if;
899
- if p_now is not null then
900
- if not @ALLOW_RESET@ then
901
- perform @SCHEMA@.lt_fail('reset_disabled', 'maintain(now) — только в установке с allow_reset');
902
- end if;
903
- ts := p_now;
904
- end if;
905
302
  with d as (delete from @SCHEMA@.secret x where x.kind = 'SESSION'
906
303
  and (x.deleted_at is not null or x.expires_at <= clock_timestamp()) returning 1)
907
304
  select count(*)::int into s from d;
@@ -910,262 +307,76 @@ begin
910
307
  with d as (delete from @SCHEMA@.secret x where x.kind ~ '^OTP(_[A-Z0-9]{1,27})?$'
911
308
  and (x.deleted_at is not null or x.expires_at <= clock_timestamp()) returning 1)
912
309
  select count(*)::int into o from d;
913
- return jsonb_build_object('sessions', s, 'codes', o, 'queue', pg_notification_queue_usage())
914
- || @SCHEMA@.thin_batch(ts, greatest(coalesce(p_limit, 10000), 1));
915
- end $$;
916
-
917
- -- ========================= verify =========================
918
-
919
- -- Проверка цепочек хэшей (этап 1, п. 11; этап 6, п. 4): номера версий подряд с 1, prev_hash каждой
920
- -- версии равен хэшу предыдущей, строка entity совпадает с последней версией журнала. Законные
921
- -- разрывы: после записи trim (стык — по $trimmed и $hash), запись purge и reset — начало цепочки,
922
- -- прореживание — пропуск после версии старше яруса all класса, у которого есть (или была) политика
923
- -- хранения — своя или умолчание установки (метка default_policy в строке ключа). p_data — ещё и все строки: данные по проверке класса, концы (цель существует, её
924
- -- арендатор — тот же или System, класс принимается концом), арендатор и владелец существуют, id
925
- -- класса с ключом — v5 от ключа, агрегатные поля равны итогу живых источников (план 1.1, §2.4; ремонт —
926
- -- rebuild_aggregates). Возвращает находки и якорь — хэш всех голов цепочек. Только
927
- -- системный администратор (право letopis.verify) или администраторское подключение.
928
- create or replace function @SCHEMA@.verify(p_data boolean default false) returns jsonb
929
- language plpgsql stable security definer
930
- set search_path = pg_catalog, @SCHEMA@, pg_temp
931
- as $$
932
- declare
933
- issues jsonb;
934
- data_issues jsonb := '[]'::jsonb;
935
- anchor text;
936
- ts timestamptz := clock_timestamp();
937
- begin
938
- if not @SCHEMA@.letopis_allowed('letopis.verify') then
939
- perform @SCHEMA@.lt_fail('acl_denied', 'verify доступен только системному администратору');
940
- end if;
941
- with pol as (
942
- -- классы с политикой хранения сейчас или в истории строки Class; ярус all — действующий или сутки
943
- select x.data->>'name' as cls, x.tenant as ct,
944
- coalesce(@SCHEMA@.history_iv(@SCHEMA@.history_policy(x.data->'resolved')->>'all'), interval '1 day') as all_iv
945
- from @SCHEMA@.entity x
946
- where x.class = 'Class'
947
- and (@SCHEMA@.history_policy(x.data->'resolved') is not null
948
- or exists (select 1 from @SCHEMA@.log h where h.id = x.id and jsonb_typeof(h.data->'resolved'->'history') = 'object')
949
- or (x.data->'resolved'->'history' = 'true'::jsonb and x.data->>'name' not in ('Class', 'Account', 'member', 'Resource', 'rule')
950
- and exists (select 1 from @SCHEMA@.secret k where k.id = '@SYSTEM@'::uuid and k.meta ? 'default_policy')))
951
- ), chain as (
952
- select l.id, l.rev, l.class, l.tenant, l.prev_hash,
953
- lag(l.rev) over w as prev_rev, lag(l.hash) over w as prev_h, lag(l.op) over w as prev_op,
954
- lag(l.data) over w as prev_data, lag(l.at) over w as prev_at
955
- from @SCHEMA@.log l
956
- window w as (partition by l.id order by l.rev)
957
- ), exp as (
958
- select chain.*,
959
- case when prev_op = 'trim' then (prev_data->>'$trimmed')::int + 1 else prev_rev + 1 end as want_rev,
960
- case when prev_op = 'trim' then decode(prev_data->>'$hash', 'hex') else prev_h end as want_hash
961
- from chain where prev_rev is not null
962
- ), found as (
963
- select jsonb_build_object('id', id, 'rev', rev, 'problem', 'цепочка начинается не с версии 1') as f
964
- from chain where prev_rev is null and (rev <> 1 or prev_hash is not null)
965
- union all
966
- select jsonb_build_object('id', id, 'rev', prev_rev, 'problem', 'хэш версии не совпадает с prev_hash следующей')
967
- from exp where rev = want_rev and prev_hash is distinct from want_hash
968
- union all
969
- select jsonb_build_object('id', id, 'rev', want_rev, 'problem', 'разрыв: нет версий ' || want_rev || '…' || (rev - 1))
970
- from exp
971
- where rev > want_rev
972
- and not exists (select 1 from pol where pol.cls = exp.class and (pol.ct = exp.tenant or pol.ct = '@SYSTEM@'::uuid)
973
- and exp.prev_at < ts - pol.all_iv)
974
- union all
975
- select jsonb_build_object('id', id, 'rev', rev, 'problem', 'номер версии меньше ожидаемого после обрезки')
976
- from exp where rev < want_rev
977
- union all
978
- select jsonb_build_object('id', e.id, 'rev', e.rev, 'problem', 'строка entity не совпадает с последней версией журнала')
979
- from @SCHEMA@.entity e
980
- left join lateral (select l.hash, l.rev from @SCHEMA@.log l where l.id = e.id order by l.rev desc limit 1) l on true
981
- where coalesce((@SCHEMA@.class_row(e.class, e.tenant)).data->'resolved'->>'history', 'true') <> 'false'
982
- and (l.hash is distinct from e.hash or l.rev is distinct from e.rev)
983
- )
984
- select coalesce(jsonb_agg(f), '[]'::jsonb) into issues from found;
985
- if coalesce(p_data, false) then
986
- with cls as (
987
- select x.tenant as ct, x.data->>'name' as name, x.data->'resolved' as res, x.validator
988
- from @SCHEMA@.entity x where x.class = 'Class'
989
- ), rows_ as (
990
- select e.*, k.res, k.validator as vld
991
- from @SCHEMA@.entity e
992
- left join lateral (select cls.res, cls.validator from cls where cls.name = e.class and cls.ct in (e.tenant, '@SYSTEM@'::uuid)
993
- order by cls.ct = '@SYSTEM@'::uuid limit 1) k on true
994
- ), found as (
995
- select jsonb_build_object('id', r.id, 'class', r.class, 'problem', 'класс строки не найден или абстрактный') as f
996
- from rows_ r where r.class <> 'Class' and (r.res is null or coalesce((r.res->>'abstract')::boolean, false))
997
- union all
998
- select jsonb_build_object('id', r.id, 'class', r.class, 'problem', 'данные не проходят описание класса',
999
- 'issues', @SCHEMA@.validate_data(r.res->'rules', r.vld, r.res->'vars', r.data))
1000
- from rows_ r where r.class <> 'Class' and r.res is not null
1001
- and @SCHEMA@.validate_data(r.res->'rules', r.vld, r.res->'vars', r.data) <> '[]'::jsonb
1002
- union all
1003
- select jsonb_build_object('id', r.id, 'class', r.class, 'problem', 'id не равен v5 от ключа класса')
1004
- from rows_ r where r.res is not null and jsonb_array_length(coalesce(r.res->'key', '[]'::jsonb)) > 0
1005
- and @SCHEMA@.key_id(r.res, r.class, r.tenant, r.data, r.links) is distinct from r.id
1006
- union all
1007
- select jsonb_build_object('id', r.id, 'class', r.class, 'problem', 'арендатор строки не существует', 'tenant', r.tenant)
1008
- from rows_ r
1009
- where r.tenant <> '@SYSTEM@'::uuid
1010
- and not exists (select 1 from @SCHEMA@.entity a where a.id = r.tenant and a.class = 'Account' and a.tenant = '@SYSTEM@'::uuid)
1011
- union all
1012
- select jsonb_build_object('id', r.id, 'class', r.class, 'problem', 'владелец строки не существует', 'owner', r.owner)
1013
- from rows_ r
1014
- where r.owner <> r.tenant
1015
- and not exists (select 1 from @SCHEMA@.entity a where a.id = r.owner and a.class = 'Account' and a.tenant = '@SYSTEM@'::uuid)
1016
- union all
1017
- select jsonb_build_object('id', p.id, 'class', p.class, 'problem', 'цель конца не найдена', 'role', p.role, 'target', p.tid)
1018
- from (select r.id, r.class, r.tenant, r.res, k.key as role,
1019
- (case jsonb_typeof(k.value) when 'array' then a.value else k.value end #>> '{}')::uuid as tid
1020
- from rows_ r
1021
- cross join lateral jsonb_each(r.links) k
1022
- left join lateral jsonb_array_elements(case jsonb_typeof(k.value) when 'array' then k.value else '[]'::jsonb end) a on true
1023
- where jsonb_typeof(k.value) = 'string' or a.value is not null) p
1024
- left join @SCHEMA@.entity t on t.id = p.tid
1025
- where t.id is null
1026
- or t.tenant not in (p.tenant, '@SYSTEM@'::uuid)
1027
- or (p.res is not null and not (
1028
- @SCHEMA@.class_set(p.res->'ends'->p.role->'class') ? t.class
1029
- or @SCHEMA@.class_set(p.res->'ends'->p.role->'class') ?| coalesce(
1030
- (select array(select jsonb_array_elements_text(k2.data->'resolved'->'ancestors'))
1031
- from @SCHEMA@.entity k2
1032
- where k2.class = 'Class' and k2.data->>'name' = t.class and k2.tenant in (t.tenant, '@SYSTEM@'::uuid)
1033
- order by k2.tenant = '@SYSTEM@'::uuid limit 1), '{}')))
1034
- union all
1035
- select jsonb_build_object('id', a.id, 'class', a.class, 'field', a.field, 'stored', a.stored, 'expected', a.expected,
1036
- 'problem', format('агрегат %s не равен итогу живых источников: в строке %s, по источникам %s — ремонт rebuildAggregates',
1037
- a.field, coalesce(a.stored::text, 'нет значения'), a.expected::text))
1038
- from @SCHEMA@.agg_issues() a
1039
- )
1040
- select coalesce(jsonb_agg(f), '[]'::jsonb) into data_issues from found;
1041
- end if;
1042
- select encode(sha256(coalesce(string_agg(e.hash, ''::bytea order by e.id), ''::bytea)), 'hex') into anchor
1043
- from @SCHEMA@.entity e;
1044
- issues := issues || data_issues;
1045
- return jsonb_build_object('ok', issues = '[]'::jsonb, 'issues', issues, 'anchor', anchor);
310
+ -- строки-замки семейств, чьего корня больше нет — удалён класс или его арендатор (план 2.0, 7.7 №8, долгий
311
+ -- прогон): их заранее заводит запись строки Class (family_rows), а сами они не уходили — заведение и удаление
312
+ -- классов копило их без предела. Корень жив — строка Class с этим именем у арендатора семейства (family_name;
313
+ -- в имени класса двоеточия нет). Занятую строку не трогаем (skip locked), а строку-замок семейства — только вместе
314
+ -- с её шлюзом или без шлюза: исключительная блокировка берёт шлюз первым, и строка-замок, до которой она ещё не
315
+ -- дошла, у неё не пропадёт. Пропавшую строку lock_row и family_lock заводят заново, если класс с этим именем
316
+ -- появится снова.
317
+ with stale as (
318
+ select l.id, l.meta->>'name' as n
319
+ from @SCHEMA@.secret l
320
+ where l.kind = 'LOCK' and l.account = '@SYSTEM@'::uuid and l.deleted_at is null
321
+ and left(l.meta->>'name', length(fam)) = fam
322
+ and not exists (
323
+ select 1 from @SCHEMA@.entity c
324
+ where c.class = 'Class'
325
+ and c.data->>'name' = split_part(substr(l.meta->>'name', length(fam) + 1), ':', 2)
326
+ and c.tenant::text = split_part(substr(l.meta->>'name', length(fam) + 1), ':', 1))
327
+ for update of l skip locked)
328
+ delete from @SCHEMA@.secret x using stale st
329
+ where x.id = st.id
330
+ and (st.n like '%:gate'
331
+ or exists (select 1 from stale g where g.n = st.n || ':gate')
332
+ or not exists (select 1 from @SCHEMA@.secret y where y.id = @SCHEMA@.lock_id(st.n || ':gate')));
333
+ return jsonb_build_object('sessions', s, 'codes', o, 'queue', pg_notification_queue_usage());
1046
334
  end $$;
1047
335
 
1048
336
  -- ========================= подписка =========================
1049
337
 
1050
338
  -- Пачка событий подписки (этап 6, п. 5): версии журнала после курсора (tx, seq) ниже горизонта
1051
339
  -- завершённых транзакций (pg_snapshot_xmin) — их уже ничто не обгонит, поэтому без потерь и повторов.
1052
- -- Выполняется с правами вызывающего: RLS журнала показывает только своё. p_at — время последнего
1053
- -- события курсора: старше яруса all какого-либо класса подписки — cursor_expired (события могли
1054
- -- проредиться). p_classes null — все классы. p_snap — снимок момента подписки «now»: транзакции,
1055
- -- видимые в нём (зафиксированные до подписки), не отдаются.
1056
- -- p_leaving (проектор, ревью безопасности №3, №4): ещё смены класса без смены id (reclass без moved), уводящие строку из
1057
- -- p_classes, — версия уже другого класса, а прошлая была в p_classes; иначе уход строки из семейства не виден.
1058
- create or replace function @SCHEMA@.watch_read(p_tx xid8, p_seq bigint, p_at timestamptz, p_classes text[], p_limit int,
1059
- p_snap pg_snapshot default null, p_leaving boolean default false)
340
+ -- Выполняется с правами вызывающего: RLS журнала показывает только своё. p_classes null — все классы. p_snap — снимок
341
+ -- момента подписки «now»: транзакции, видимые в нём (зафиксированные до подписки), не отдаются.
342
+ create or replace function @SCHEMA@.watch_read(p_tx xid8, p_seq bigint, p_classes text[], p_limit int,
343
+ p_snap pg_snapshot default null)
1060
344
  returns setof @SCHEMA@.log
1061
345
  language plpgsql stable
1062
346
  set search_path = pg_catalog, @SCHEMA@, pg_temp
1063
347
  as $$
1064
348
  declare
1065
349
  horizon xid8 := pg_snapshot_xmin(pg_current_snapshot());
1066
- lim interval;
1067
350
  begin
1068
- if p_at is not null then
1069
- select min(@SCHEMA@.history_iv(p.p->>'all')) into lim
1070
- from @SCHEMA@.entity x cross join lateral (select @SCHEMA@.history_policy(x.data->'resolved') as p) p
1071
- where x.class = 'Class' and p.p is not null and (p_classes is null or x.data->>'name' = any (p_classes));
1072
- if lim is not null and p_at < clock_timestamp() - lim then
1073
- raise exception using errcode = 'LT016',
1074
- message = 'letopis: cursor_expired: курсор подписки старше яруса all — события могли проредиться, перечитайте текущее состояние';
1075
- end if;
1076
- end if;
1077
- -- колонки — явно: changed приложению не выдана (ревью №1 точки А плана 1.1), в ответе подписки она null
1078
- return query select l.seq, l.tx, l.id, l.rev, l.class, l.cv, l.tenant, l.owner, l.links, l.data, l.tags, l.at, l.author,
1079
- l.agent, l.op, l.reason, l.moved, l.prev_hash, l.hash, null::jsonb
1080
- from @SCHEMA@.log l
1081
- where (l.tx, l.seq) > (p_tx, p_seq) and l.tx < horizon
1082
- and (p_classes is null or l.class = any (p_classes)
1083
- or (p_leaving and l.op = 'reclass' and l.moved is null
1084
- and (select p.class from @SCHEMA@.log p where p.id = l.id and p.rev < l.rev and p.op not in ('purge', 'trim', 'reset')
1085
- order by p.rev desc limit 1) = any (p_classes)))
1086
- and (p_snap is null or not pg_visible_in_snapshot(l.tx, p_snap))
1087
- order by l.tx, l.seq limit p_limit;
1088
- end $$;
1089
-
1090
- -- Уход строки из классов подписки сменой класса без смены id (хвост ревью безопасности №3): версия пишется уже с новым
1091
- -- классом, и подписка по классам её не видит. Здесь — те же окно, горизонт и снимок, что у watch_read (и верхняя граница
1092
- -- окна p_upto — последняя строка полной пачки watch_read), а строки — синтетические надгробия прежней версии: класс,
1093
- -- концы и данные прежние; номер, время, автор, tx и seq — версии смены класса; вид delete; агента и причины нет. Только
1094
- -- если нового класса нет в p_classes, а прежнюю версию актор видит (row_visible с его планом READ): о строке, которой он
1095
- -- не читал, подписчик не узнает. Функция владельца: версию с новым классом актору видеть не нужно. Подключение в обход
1096
- -- RLS (суперпользователь, BYPASSRLS, член роли-владельца с наследованием — connect() пускает его только с
1097
- -- allowBypassRls) видит в watch_read журнал всех арендаторов, поэтому и события ухода получает все, с автором (хвост
1098
- -- ревью доработок после 1.2.0). Роль — действующая роль сеанса (session_role): та, к которой watch_read применяет RLS.
1099
- create or replace function @SCHEMA@.watch_leaving(p_tx xid8, p_seq bigint, p_classes text[], p_limit int,
1100
- p_snap pg_snapshot default null, p_upto_tx xid8 default null, p_upto_seq bigint default null)
1101
- returns setof @SCHEMA@.log
1102
- language plpgsql stable security definer
1103
- set search_path = pg_catalog, @SCHEMA@, pg_temp
1104
- as $$
1105
- declare
1106
- horizon xid8 := pg_snapshot_xmin(pg_current_snapshot());
1107
- a jsonb;
1108
- bypass boolean;
1109
- begin
1110
- if p_classes is null then
1111
- return;
1112
- end if;
1113
- bypass := exists (select 1 from pg_roles r where r.rolname = @SCHEMA@.session_role() and (r.rolsuper or r.rolbypassrls))
1114
- or pg_has_role(@SCHEMA@.session_role(), '@OWNER_NAME@', 'USAGE');
1115
- a := case when not bypass then @SCHEMA@.acl_actor('READ') end;
1116
- if a is null and not bypass then
1117
- return;
1118
- end if;
1119
- -- новую версию актор не видит — надгробие при любом p_classes и без автора: перебором классов подписки он узнал бы её
1120
- -- класс (автоматическое ревью доработок после 1.2.0)
1121
- return query select l.seq, l.tx, p.id, l.rev, p.class, p.cv, p.tenant, p.owner, p.links, p.data, p.tags, l.at,
1122
- case when v.seen then l.author end, null::text, 'delete'::text, null::text, null::uuid, null::bytea, null::bytea, null::jsonb
351
+ return query select l.*
1123
352
  from @SCHEMA@.log l
1124
- cross join lateral (select x.* from @SCHEMA@.log x where x.id = l.id and x.rev < l.rev and x.op not in ('purge', 'trim', 'reset')
1125
- order by x.rev desc limit 1) p
1126
- cross join lateral (select bypass or @SCHEMA@.row_visible(l.tenant, l.class, l.id, l.owner, l.tags, l.data, l.links,
1127
- (a->>'tenant')::uuid, (a->>'account')::uuid, a->'plan') as seen) v
1128
353
  where (l.tx, l.seq) > (p_tx, p_seq) and l.tx < horizon
1129
- and (p_upto_tx is null or (l.tx, l.seq) <= (p_upto_tx, p_upto_seq))
1130
- and l.op = 'reclass' and l.moved is null and (not (l.class = any (p_classes)) or not v.seen)
1131
- and p.class = any (p_classes) and p.op <> 'delete'
354
+ and (p_classes is null or l.class = any (p_classes))
1132
355
  and (p_snap is null or not pg_visible_in_snapshot(l.tx, p_snap))
1133
- and (bypass or @SCHEMA@.row_visible(p.tenant, p.class, p.id, p.owner, p.tags, p.data, p.links,
1134
- (a->>'tenant')::uuid, (a->>'account')::uuid, a->'plan'))
1135
356
  order by l.tx, l.seq limit p_limit;
1136
357
  end $$;
1137
358
 
1138
359
  -- Точка подписки «с этого момента»: курсор — горизонт завершённых транзакций, снимок — чтобы не
1139
360
  -- отдавать транзакции, зафиксированные до подписки, но ещё не ушедшие за горизонт.
1140
- drop function if exists @SCHEMA@.watch_head();
1141
361
  create or replace function @SCHEMA@.watch_head(out tx xid8, out seq bigint, out snap pg_snapshot)
1142
362
  language sql stable
1143
363
  set search_path = pg_catalog, @SCHEMA@, pg_temp
1144
364
  as $$
1145
365
  select pg_snapshot_xmin(s), 0::bigint, s from pg_current_snapshot() s
1146
366
  $$;
1147
- -- до исправления подписки «now»: без снимка; до ревью безопасности №3 — без p_leaving
1148
- drop function if exists @SCHEMA@.watch_read(xid8, bigint, timestamptz, text[], int);
1149
- drop function if exists @SCHEMA@.watch_read(xid8, bigint, timestamptz, text[], int, pg_snapshot);
1150
367
 
1151
368
  do $$
1152
369
  declare f text;
1153
370
  begin
1154
371
  foreach f in array array[
1155
- 'history_default()', 'history_policy(jsonb)', 'history_iv(text)', 'history_horizon(jsonb)',
1156
- 'history_keep(jsonb, timestamp, timestamp, timestamp)', 'session_role()', 'admin_role()', 'letopis_allowed(text)', 'session_expires()', 'signal_mode()', 'signal_key()', 'class_stamp()',
1157
- 'last_version_visible(uuid, uuid, jsonb)', 'restore(uuid)', 'projector_unread(uuid, uuid, int)', 'purge(uuid, boolean)', 'trim_history(uuid[], text[], timestamptz)',
1158
- 'rekey(uuid, jsonb, jsonb)', 'rekey_class(text, jsonb)', 'account_purge(uuid)', 'reset_mark(uuid, text, uuid)',
1159
- 'reset(text, text, uuid, int)', 'thin_batch(timestamptz, int)', 'maintain(timestamptz, int)', 'verify(boolean)',
1160
- 'watch_read(xid8, bigint, timestamptz, text[], int, pg_snapshot, boolean)', 'watch_leaving(xid8, bigint, text[], int, pg_snapshot, xid8, bigint)', 'watch_head()'] loop
372
+ 'session_role()', 'admin_role()', 'letopis_allowed(text)', 'session_expires()', 'signal_mode()', 'signal_key()', 'class_stamp()',
373
+ 'last_version_visible(uuid, uuid, jsonb)', 'restore(uuid)', 'account_purge(uuid)', 'maintain()',
374
+ 'watch_read(xid8, bigint, text[], int, pg_snapshot)', 'watch_head()'] loop
1161
375
  execute format('alter function @SCHEMA@.%s owner to @OWNER@', f);
1162
376
  execute format('revoke all on function @SCHEMA@.%s from public', f);
1163
377
  end loop;
1164
378
  end $$;
1165
- -- приложению: функции владельца этапа 6 (проверяют права сами), подписка (под RLS) и чистые помощники политики
1166
- grant execute on function @SCHEMA@.restore(uuid), @SCHEMA@.purge(uuid, boolean), @SCHEMA@.trim_history(uuid[], text[], timestamptz),
1167
- @SCHEMA@.rekey(uuid, jsonb, jsonb), @SCHEMA@.rekey_class(text, jsonb), @SCHEMA@.account_purge(uuid),
1168
- @SCHEMA@.reset(text, text, uuid, int), @SCHEMA@.maintain(timestamptz, int), @SCHEMA@.verify(boolean),
1169
- @SCHEMA@.session_expires(), @SCHEMA@.watch_read(xid8, bigint, timestamptz, text[], int, pg_snapshot, boolean), @SCHEMA@.watch_leaving(xid8, bigint, text[], int, pg_snapshot, xid8, bigint), @SCHEMA@.watch_head(),
1170
- @SCHEMA@.history_default(), @SCHEMA@.history_policy(jsonb), @SCHEMA@.history_iv(text),
379
+ -- приложению: функции владельца этапа 6 (проверяют права сами) и подписка (под RLS)
380
+ grant execute on function @SCHEMA@.restore(uuid), @SCHEMA@.account_purge(uuid), @SCHEMA@.maintain(),
381
+ @SCHEMA@.session_expires(), @SCHEMA@.watch_read(xid8, bigint, text[], int, pg_snapshot), @SCHEMA@.watch_head(),
1171
382
  @SCHEMA@.signal_mode(), @SCHEMA@.signal_key(), @SCHEMA@.class_stamp() to @APP@;