@itphx/synth-storage-postgres 0.0.0-stage → 0.11.3

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 (72) hide show
  1. package/LICENSE +18 -0
  2. package/LICENSE.ru.md +31 -0
  3. package/dist/errors.d.ts +71 -0
  4. package/dist/errors.js +126 -0
  5. package/dist/index.d.ts +37 -0
  6. package/dist/index.js +34 -0
  7. package/dist/json-param.d.ts +14 -0
  8. package/dist/json-param.js +22 -0
  9. package/dist/locks.d.ts +104 -0
  10. package/dist/locks.js +201 -0
  11. package/dist/migrate.d.ts +58 -0
  12. package/dist/migrate.js +125 -0
  13. package/dist/migrations/001-init.d.ts +15 -0
  14. package/dist/migrations/001-init.js +457 -0
  15. package/dist/migrations/002-egress-audit.d.ts +12 -0
  16. package/dist/migrations/002-egress-audit.js +52 -0
  17. package/dist/migrations/003-analytics-rollups.d.ts +12 -0
  18. package/dist/migrations/003-analytics-rollups.js +21 -0
  19. package/dist/migrations/index.d.ts +23 -0
  20. package/dist/migrations/index.js +23 -0
  21. package/dist/pool.d.ts +178 -0
  22. package/dist/pool.js +382 -0
  23. package/dist/ports/analytics.d.ts +26 -0
  24. package/dist/ports/analytics.js +243 -0
  25. package/dist/ports/audit.d.ts +15 -0
  26. package/dist/ports/audit.js +189 -0
  27. package/dist/ports/content.d.ts +41 -0
  28. package/dist/ports/content.js +1539 -0
  29. package/dist/ports/core-sync.d.ts +31 -0
  30. package/dist/ports/core-sync.js +34 -0
  31. package/dist/ports/deps.d.ts +63 -0
  32. package/dist/ports/deps.js +19 -0
  33. package/dist/ports/events-bindings.d.ts +77 -0
  34. package/dist/ports/events-bindings.js +356 -0
  35. package/dist/ports/events-core.d.ts +35 -0
  36. package/dist/ports/events-core.js +71 -0
  37. package/dist/ports/events-journal.d.ts +68 -0
  38. package/dist/ports/events-journal.js +211 -0
  39. package/dist/ports/events-scheduler.d.ts +49 -0
  40. package/dist/ports/events-scheduler.js +231 -0
  41. package/dist/ports/events-webhooks.d.ts +64 -0
  42. package/dist/ports/events-webhooks.js +268 -0
  43. package/dist/ports/events.d.ts +20 -0
  44. package/dist/ports/events.js +27 -0
  45. package/dist/ports/principals-defaults.d.ts +21 -0
  46. package/dist/ports/principals-defaults.js +68 -0
  47. package/dist/ports/principals-documents.d.ts +23 -0
  48. package/dist/ports/principals-documents.js +38 -0
  49. package/dist/ports/principals-profiles.d.ts +21 -0
  50. package/dist/ports/principals-profiles.js +263 -0
  51. package/dist/ports/principals-projects.d.ts +19 -0
  52. package/dist/ports/principals-projects.js +158 -0
  53. package/dist/ports/principals-settings.d.ts +25 -0
  54. package/dist/ports/principals-settings.js +275 -0
  55. package/dist/ports/principals-shared.d.ts +33 -0
  56. package/dist/ports/principals-shared.js +44 -0
  57. package/dist/ports/principals.d.ts +27 -0
  58. package/dist/ports/principals.js +39 -0
  59. package/dist/ports/sessions-mapping.d.ts +237 -0
  60. package/dist/ports/sessions-mapping.js +405 -0
  61. package/dist/ports/sessions.d.ts +133 -0
  62. package/dist/ports/sessions.js +502 -0
  63. package/dist/ports/stub.d.ts +14 -0
  64. package/dist/ports/stub.js +32 -0
  65. package/dist/postgres-storage.d.ts +59 -0
  66. package/dist/postgres-storage.js +111 -0
  67. package/dist/schema.d.ts +13 -0
  68. package/dist/schema.js +22 -0
  69. package/dist/storage-context.d.ts +51 -0
  70. package/dist/storage-context.js +130 -0
  71. package/package.json +40 -3
  72. package/README.md +0 -3
@@ -0,0 +1,243 @@
1
+ /**
2
+ * Порт роллапов аналитики PostgreSQL-драйвера (PROP-102).
3
+ *
4
+ * Таблица `analytics_rollups` (миграция 003): ключ бакета — составной первичный
5
+ * ключ `(family, day, dimensions)` (`jsonb` нормализует порядок ключей объекта,
6
+ * поэтому равенство измерений устойчиво и годится для btree-равенства; отдельный
7
+ * `dimensions_key` не нужен). `measures`/`cost_by_currency` — `jsonb`-словари
8
+ * чисел (`cost_by_currency` пустая → `NULL`).
9
+ *
10
+ * `increment` — атомарный upsert `INSERT … ON CONFLICT (family, day, dimensions)
11
+ * DO UPDATE` с суммированием `measures`/`cost_by_currency` прямо в SQL (jsonb →
12
+ * `jsonb_each_text` → `SUM` → `jsonb_object_agg`); advisory-локи не нужны —
13
+ * конкурентные инкременты сериализуются конфликтом уникального ключа. `set` —
14
+ * точная перезапись полей из `EXCLUDED`.
15
+ *
16
+ * Семантика нормализации/сложения/агрегации повторяет общий core-хелпер
17
+ * (`analytics-rollup-helpers.ts`): драйвер не тянет core рантаймом (только
18
+ * `import type`), поэтому фильтр по семейству/периоду выполняется в SQL, а
19
+ * группировка `groupBy` и слияние мер — локальной точной репликой хелпера.
20
+ */
21
+ import { jsonbParam } from '../json-param.js';
22
+ // ────────────────────────────────────────────────────────────────────────────
23
+ // Локальная реплика `packages/core/src/storage/analytics-rollup-helpers.ts`
24
+ // (core не тянется рантаймом; поведение обязано совпадать с memory/file).
25
+ // ────────────────────────────────────────────────────────────────────────────
26
+ function isFiniteNumber(value) {
27
+ return typeof value === 'number' && Number.isFinite(value);
28
+ }
29
+ /** Оставить только finite-числа (NaN/Infinity — мусор). */
30
+ function normalizeNumberMap(input) {
31
+ const out = {};
32
+ if (!input)
33
+ return out;
34
+ for (const [key, value] of Object.entries(input)) {
35
+ if (isFiniteNumber(value))
36
+ out[key] = value;
37
+ }
38
+ return out;
39
+ }
40
+ /**
41
+ * Нормализовать бакет: в измерениях — только строки, в мерах — только
42
+ * finite-числа; пустая разбивка по валютам опускается (поле не задаётся).
43
+ */
44
+ function normalizeBucket(bucket) {
45
+ const dimensions = {};
46
+ for (const [key, value] of Object.entries(bucket.dimensions ?? {})) {
47
+ if (typeof value === 'string')
48
+ dimensions[key] = value;
49
+ }
50
+ const normalized = {
51
+ family: bucket.family,
52
+ day: bucket.day,
53
+ dimensions,
54
+ measures: normalizeNumberMap(bucket.measures),
55
+ };
56
+ const costByCurrency = normalizeNumberMap(bucket.costByCurrency);
57
+ if (Object.keys(costByCurrency).length > 0)
58
+ normalized.costByCurrency = costByCurrency;
59
+ return normalized;
60
+ }
61
+ /** Отсортированные пары осей — устойчивый порядок (устойчив к `&`/`=` в значениях). */
62
+ function sortedDimensionPairs(dimensions) {
63
+ return Object.entries(dimensions).sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));
64
+ }
65
+ /** Значение оси бакета (`day` — отдельным полем, прочие — из `dimensions`). */
66
+ function axisValue(bucket, axis) {
67
+ return axis === 'day' ? bucket.day : bucket.dimensions[axis];
68
+ }
69
+ /** Подходит ли бакет под фильтры (семейство, период включительно, оси по равенству). */
70
+ function matchesQuery(bucket, query) {
71
+ if (bucket.family !== query.family)
72
+ return false;
73
+ if (query.from !== undefined && bucket.day < query.from)
74
+ return false;
75
+ if (query.to !== undefined && bucket.day > query.to)
76
+ return false;
77
+ if (query.dimensions) {
78
+ for (const [axis, expected] of Object.entries(query.dimensions)) {
79
+ if (expected === undefined)
80
+ continue;
81
+ if (axisValue(bucket, axis) !== expected)
82
+ return false;
83
+ }
84
+ }
85
+ return true;
86
+ }
87
+ /** Детерминированный порядок строк: лексикографически по осям группировки. */
88
+ function compareRows(a, b, axes) {
89
+ for (const axis of axes) {
90
+ const av = a.dimensions[axis] ?? '';
91
+ const bv = b.dimensions[axis] ?? '';
92
+ if (av !== bv)
93
+ return av < bv ? -1 : 1;
94
+ }
95
+ return 0;
96
+ }
97
+ /** Агрегировать бакеты по `groupBy` (пусто — одна итоговая строка). */
98
+ function aggregateRollups(buckets, query) {
99
+ const groupBy = query.groupBy ?? [];
100
+ const groups = new Map();
101
+ for (const bucket of buckets) {
102
+ if (!matchesQuery(bucket, query))
103
+ continue;
104
+ const dimensions = {};
105
+ for (const axis of groupBy) {
106
+ const value = axisValue(bucket, axis);
107
+ if (value !== undefined)
108
+ dimensions[axis] = value;
109
+ }
110
+ const key = JSON.stringify(sortedDimensionPairs(dimensions));
111
+ let row = groups.get(key);
112
+ if (!row) {
113
+ row = { dimensions, measures: {} };
114
+ groups.set(key, row);
115
+ }
116
+ for (const [measure, value] of Object.entries(bucket.measures)) {
117
+ row.measures[measure] = (row.measures[measure] ?? 0) + value;
118
+ }
119
+ if (bucket.costByCurrency) {
120
+ const merged = row.costByCurrency ?? {};
121
+ for (const [currency, value] of Object.entries(bucket.costByCurrency)) {
122
+ merged[currency] = (merged[currency] ?? 0) + value;
123
+ }
124
+ if (Object.keys(merged).length > 0)
125
+ row.costByCurrency = merged;
126
+ }
127
+ }
128
+ const rows = [...groups.values()];
129
+ for (const row of rows) {
130
+ if (row.costByCurrency && Object.keys(row.costByCurrency).length === 0)
131
+ delete row.costByCurrency;
132
+ }
133
+ rows.sort((a, b) => compareRows(a, b, groupBy));
134
+ return rows;
135
+ }
136
+ // ────────────────────────────────────────────────────────────────────────────
137
+ // Чтение строк БД → бакет
138
+ // ────────────────────────────────────────────────────────────────────────────
139
+ function rowToBucket(row) {
140
+ const bucket = {
141
+ family: String(row.family),
142
+ day: String(row.day),
143
+ dimensions: (row.dimensions ?? {}),
144
+ measures: (row.measures ?? {}),
145
+ };
146
+ if (row.cost_by_currency !== null && row.cost_by_currency !== undefined) {
147
+ bucket.costByCurrency = row.cost_by_currency;
148
+ }
149
+ return bucket;
150
+ }
151
+ /** Параметры записи бакета: family/day + нормализованные jsonb-словари. */
152
+ function bucketParams(bucket) {
153
+ const normalized = normalizeBucket(bucket);
154
+ return [
155
+ normalized.family,
156
+ normalized.day,
157
+ jsonbParam(normalized.dimensions),
158
+ jsonbParam(normalized.measures),
159
+ normalized.costByCurrency ? jsonbParam(normalized.costByCurrency) : null,
160
+ ];
161
+ }
162
+ /**
163
+ * `jsonb_object_agg` сумм (`SUM`) с `COALESCE` для пустого набора строк
164
+ * (нет ни одной меры) → `'{}'::jsonb`.
165
+ */
166
+ const SQL_SUM_MEASURES = `COALESCE(jsonb_object_agg(key, total), '{}'::jsonb)`;
167
+ const SQL_EACH_SUM = `SELECT key, SUM(value::numeric) AS total
168
+ FROM (%ROWS%) AS merged
169
+ GROUP BY key`;
170
+ /** Слитый `measures` при инкременте: сумма по ключам существующих и новых мер. */
171
+ const INCREMENT_SQL = `
172
+ INSERT INTO analytics_rollups (family, day, dimensions, measures, cost_by_currency)
173
+ VALUES ($1, $2, $3::jsonb, $4::jsonb, $5::jsonb)
174
+ ON CONFLICT (family, day, dimensions) DO UPDATE SET
175
+ measures = (
176
+ SELECT ${SQL_SUM_MEASURES}
177
+ FROM (${SQL_EACH_SUM.replace('%ROWS%', `SELECT key, value FROM jsonb_each_text(analytics_rollups.measures)
178
+ UNION ALL
179
+ SELECT key, value FROM jsonb_each_text(EXCLUDED.measures)`)}) AS summed
180
+ ),
181
+ cost_by_currency = CASE
182
+ WHEN COALESCE(analytics_rollups.cost_by_currency, '{}'::jsonb) = '{}'::jsonb
183
+ AND COALESCE(EXCLUDED.cost_by_currency, '{}'::jsonb) = '{}'::jsonb
184
+ THEN NULL
185
+ ELSE (
186
+ SELECT ${SQL_SUM_MEASURES}
187
+ FROM (${SQL_EACH_SUM.replace('%ROWS%', `SELECT key, value FROM jsonb_each_text(COALESCE(analytics_rollups.cost_by_currency, '{}'::jsonb))
188
+ UNION ALL
189
+ SELECT key, value FROM jsonb_each_text(COALESCE(EXCLUDED.cost_by_currency, '{}'::jsonb))`)}) AS summed
190
+ )
191
+ END`;
192
+ /** Точная перезапись бакета по ключу (`set`). */
193
+ const SET_SQL = `
194
+ INSERT INTO analytics_rollups (family, day, dimensions, measures, cost_by_currency)
195
+ VALUES ($1, $2, $3::jsonb, $4::jsonb, $5::jsonb)
196
+ ON CONFLICT (family, day, dimensions) DO UPDATE SET
197
+ measures = EXCLUDED.measures,
198
+ cost_by_currency = EXCLUDED.cost_by_currency`;
199
+ /** Порт пред-агрегированных суточных роллапов аналитики поверх SQL. */
200
+ class PostgresAnalyticsRollupRepository {
201
+ _deps;
202
+ constructor(_deps) {
203
+ this._deps = _deps;
204
+ }
205
+ _db() {
206
+ return this._deps.connection;
207
+ }
208
+ async increment(bucket) {
209
+ await this._db().query(INCREMENT_SQL, bucketParams(bucket));
210
+ }
211
+ async set(bucket) {
212
+ await this._db().query(SET_SQL, bucketParams(bucket));
213
+ }
214
+ async query(query) {
215
+ const params = [query.family];
216
+ let where = 'family = $1';
217
+ if (query.from !== undefined) {
218
+ params.push(query.from);
219
+ where += ` AND day >= $${params.length}`;
220
+ }
221
+ if (query.to !== undefined) {
222
+ params.push(query.to);
223
+ where += ` AND day <= $${params.length}`;
224
+ }
225
+ const rows = await this._db().query(`SELECT family, day, dimensions, measures, cost_by_currency
226
+ FROM analytics_rollups WHERE ${where}`, params);
227
+ return aggregateRollups(rows.map(rowToBucket), query);
228
+ }
229
+ async prune(beforeDay) {
230
+ const rows = await this._db().query('WITH deleted AS (DELETE FROM analytics_rollups WHERE day < $1 RETURNING 1) SELECT count(*)::int AS n FROM deleted', [beforeDay]);
231
+ const value = rows[0]?.n;
232
+ return typeof value === 'number' ? value : Number(value) || 0;
233
+ }
234
+ async clear() {
235
+ const rows = await this._db().query('WITH deleted AS (DELETE FROM analytics_rollups RETURNING 1) SELECT count(*)::int AS n FROM deleted');
236
+ const value = rows[0]?.n;
237
+ return typeof value === 'number' ? value : Number(value) || 0;
238
+ }
239
+ }
240
+ /** Собрать порт роллапов аналитики. */
241
+ export function buildAnalyticsPorts(deps) {
242
+ return { analyticsRollups: new PostgresAnalyticsRollupRepository(deps) };
243
+ }
@@ -0,0 +1,15 @@
1
+ /**
2
+ * Порты журналов безопасности PostgreSQL-драйвера (egress/ADR-071):
3
+ * `securityAudit` — аудит изменений egress/security-политик,
4
+ * `egressRequests` — журнал внешних запросов.
5
+ *
6
+ * Обе таблицы append-only (`seq bigserial` — порядок «свежие первыми»).
7
+ * `before`/`after` в security-аудите хранятся в JSONB (снимки политики могут быть
8
+ * `null`); журнал egress не содержит тел/заголовков.
9
+ */
10
+ import type { StorageContext } from '@itphx/synth-core';
11
+ import type { PortDeps } from './deps.js';
12
+ /** Часть `StorageContext`, которой владеет группа `audit`. */
13
+ export type AuditPorts = Pick<StorageContext, 'securityAudit' | 'egressRequests'>;
14
+ /** Собрать порты журналов безопасности. */
15
+ export declare function buildAuditPorts(deps: PortDeps): AuditPorts;
@@ -0,0 +1,189 @@
1
+ /**
2
+ * Порты журналов безопасности PostgreSQL-драйвера (egress/ADR-071):
3
+ * `securityAudit` — аудит изменений egress/security-политик,
4
+ * `egressRequests` — журнал внешних запросов.
5
+ *
6
+ * Обе таблицы append-only (`seq bigserial` — порядок «свежие первыми»).
7
+ * `before`/`after` в security-аудите хранятся в JSONB (снимки политики могут быть
8
+ * `null`); журнал egress не содержит тел/заголовков.
9
+ */
10
+ import { jsonbLiteral } from '../json-param.js';
11
+ function toISO(value) {
12
+ if (value instanceof Date)
13
+ return value.toISOString();
14
+ return String(value);
15
+ }
16
+ function jsonParam(value) {
17
+ return jsonbLiteral(value ?? null);
18
+ }
19
+ function toNumber(value) {
20
+ if (value === null || value === undefined)
21
+ return undefined;
22
+ if (typeof value === 'number')
23
+ return value;
24
+ if (typeof value === 'string') {
25
+ const parsed = Number(value);
26
+ return Number.isFinite(parsed) ? parsed : undefined;
27
+ }
28
+ return undefined;
29
+ }
30
+ function securityRowToEntry(row) {
31
+ return {
32
+ id: row.id,
33
+ ts: toISO(row.ts),
34
+ actor: row.actor,
35
+ scope: row.scope,
36
+ action: row.action,
37
+ source: row.source,
38
+ before: row.before_jsonb ?? null,
39
+ after: row.after_jsonb ?? null,
40
+ version: typeof row.version === 'number' ? row.version : Number(row.version) || 1,
41
+ };
42
+ }
43
+ class PostgresSecurityAuditRepository {
44
+ _deps;
45
+ constructor(_deps) {
46
+ this._deps = _deps;
47
+ }
48
+ _db() {
49
+ return this._deps.connection;
50
+ }
51
+ async append(entry) {
52
+ await this._db().query(`INSERT INTO security_audit (id, ts, actor, scope, action, source, before_jsonb, after_jsonb, version)
53
+ VALUES ($1,$2,$3,$4,$5,$6,$7::jsonb,$8::jsonb,$9)`, [
54
+ entry.id,
55
+ entry.ts,
56
+ entry.actor,
57
+ entry.scope,
58
+ entry.action,
59
+ entry.source,
60
+ jsonParam(entry.before),
61
+ jsonParam(entry.after),
62
+ entry.version,
63
+ ]);
64
+ }
65
+ async list(opts = {}) {
66
+ const params = [];
67
+ let where = '';
68
+ if (opts.scope !== undefined) {
69
+ params.push(opts.scope);
70
+ where = `WHERE scope = $${params.length}`;
71
+ }
72
+ let limit = '';
73
+ if (opts.limit !== undefined && Number.isFinite(opts.limit) && opts.limit > 0) {
74
+ params.push(Math.floor(opts.limit));
75
+ limit = `LIMIT $${params.length}::int`;
76
+ }
77
+ const rows = await this._db().query(`SELECT * FROM security_audit ${where} ORDER BY seq DESC ${limit}`, params);
78
+ return rows.map(securityRowToEntry);
79
+ }
80
+ async clear() {
81
+ const rows = await this._db().query('WITH deleted AS (DELETE FROM security_audit RETURNING 1) SELECT count(*)::int AS n FROM deleted');
82
+ const value = rows[0]?.n;
83
+ return typeof value === 'number' ? value : Number(value) || 0;
84
+ }
85
+ }
86
+ function egressRowToEntry(row) {
87
+ const entry = {
88
+ id: row.id,
89
+ ts: toISO(row.ts),
90
+ scope: row.scope,
91
+ host: row.host,
92
+ url: row.url,
93
+ status: row.status,
94
+ };
95
+ if (row.method !== null)
96
+ entry.method = row.method;
97
+ if (row.via !== null)
98
+ entry.via = row.via;
99
+ if (row.http_status !== null)
100
+ entry.httpStatus = row.http_status;
101
+ const bytes = toNumber(row.bytes);
102
+ if (bytes !== undefined)
103
+ entry.bytes = bytes;
104
+ if (row.duration_ms !== null)
105
+ entry.durationMs = row.duration_ms;
106
+ if (row.reason !== null)
107
+ entry.reason = row.reason;
108
+ if (row.matched_rule !== null)
109
+ entry.matchedRule = row.matched_rule;
110
+ if (row.session_id !== null)
111
+ entry.sessionId = row.session_id;
112
+ if (row.project_id !== null)
113
+ entry.projectId = row.project_id;
114
+ if (row.actor !== null)
115
+ entry.actor = row.actor;
116
+ return entry;
117
+ }
118
+ class PostgresEgressRequestLogRepository {
119
+ _deps;
120
+ constructor(_deps) {
121
+ this._deps = _deps;
122
+ }
123
+ _db() {
124
+ return this._deps.connection;
125
+ }
126
+ async append(entry) {
127
+ await this._db().query(`INSERT INTO egress_requests
128
+ (id, ts, scope, host, url, method, status, via, http_status, bytes, duration_ms,
129
+ reason, matched_rule, session_id, project_id, actor)
130
+ VALUES ($1,$2,$3,$4,$5,$6,$7,$8,$9,$10,$11,$12,$13,$14,$15,$16)`, [
131
+ entry.id,
132
+ entry.ts,
133
+ entry.scope,
134
+ entry.host,
135
+ entry.url,
136
+ entry.method ?? null,
137
+ entry.status,
138
+ entry.via ?? null,
139
+ entry.httpStatus ?? null,
140
+ entry.bytes ?? null,
141
+ entry.durationMs ?? null,
142
+ entry.reason ?? null,
143
+ entry.matchedRule ?? null,
144
+ entry.sessionId ?? null,
145
+ entry.projectId ?? null,
146
+ entry.actor ?? null,
147
+ ]);
148
+ }
149
+ async list(opts = {}) {
150
+ const params = [];
151
+ const clauses = [];
152
+ if (opts.scope !== undefined) {
153
+ params.push(opts.scope);
154
+ clauses.push(`scope = $${params.length}`);
155
+ }
156
+ if (opts.status !== undefined) {
157
+ params.push(opts.status);
158
+ clauses.push(`status = $${params.length}`);
159
+ }
160
+ const where = clauses.length > 0 ? `WHERE ${clauses.join(' AND ')}` : '';
161
+ let limit = '';
162
+ if (opts.limit !== undefined && Number.isFinite(opts.limit) && opts.limit > 0) {
163
+ params.push(Math.floor(opts.limit));
164
+ limit = `LIMIT $${params.length}::int`;
165
+ }
166
+ const rows = await this._db().query(`SELECT * FROM egress_requests ${where} ORDER BY seq DESC ${limit}`, params);
167
+ return rows.map(egressRowToEntry);
168
+ }
169
+ async prune(days) {
170
+ if (!Number.isFinite(days) || days <= 0)
171
+ return 0;
172
+ const cutoff = new Date(Date.now() - days * 24 * 3600_000).toISOString();
173
+ const rows = await this._db().query('WITH deleted AS (DELETE FROM egress_requests WHERE ts < $1 RETURNING 1) SELECT count(*)::int AS n FROM deleted', [cutoff]);
174
+ const value = rows[0]?.n;
175
+ return typeof value === 'number' ? value : Number(value) || 0;
176
+ }
177
+ async clear() {
178
+ const rows = await this._db().query('WITH deleted AS (DELETE FROM egress_requests RETURNING 1) SELECT count(*)::int AS n FROM deleted');
179
+ const value = rows[0]?.n;
180
+ return typeof value === 'number' ? value : Number(value) || 0;
181
+ }
182
+ }
183
+ /** Собрать порты журналов безопасности. */
184
+ export function buildAuditPorts(deps) {
185
+ return {
186
+ securityAudit: new PostgresSecurityAuditRepository(deps),
187
+ egressRequests: new PostgresEgressRequestLogRepository(deps),
188
+ };
189
+ }
@@ -0,0 +1,41 @@
1
+ /**
2
+ * Группа портов **контента, секретов и обслуживания** PostgreSQL-драйвера
3
+ * (PROP-032, волна 3b).
4
+ *
5
+ * Владелец файла — один агент волны реализации; правит только `content.ts`.
6
+ * Файл экспортирует единственную фабрику `buildContentPorts(deps)`, возвращающую
7
+ * свою часть `StorageContext`: `serviceKeys`, `sshKeys`, `mcpRegistry`,
8
+ * `skillBundles`, `dictionaries`, `secretPatterns`, `protectedPaths`,
9
+ * `maintenanceAudit`.
10
+ *
11
+ * ── Синхронные геттеры (кэш-фасад) ────────────────────────────────────────
12
+ * `secretPatterns`/`protectedPaths`/`dictionaries` требуют **синхронных** вызовов
13
+ * на горячем пути (сборка промпта, детекция секретов, маршрутизация). Поэтому:
14
+ * - «системный» слой (дефолтные паттерны, definitions/protected-paths.json,
15
+ * системные словари) читается **синхронно** из ассетов core либо из
16
+ * инстанс-конфигурации — он доступен сразу, без обращения к БД;
17
+ * - пользовательский override — в таблице `settings(key, value jsonb)`
18
+ * (схема `001-init` общих таблиц для словарей/паттернов/путей НЕ заводит);
19
+ * он прогревается в память асинхронно при сборке контекста (best-effort
20
+ * warm) и поддерживается **write-through** при мутациях.
21
+ *
22
+ * Известное ограничение: кэш синхронных геттеров процесс-локальный — правки
23
+ * override другим процессом/инстансом он не увидит до рестарта; короткое окно
24
+ * сразу после старта может отдать системный дефолт до завершения прогрева.
25
+ *
26
+ * ── Core на синхронном пути ───────────────────────────────────────────────
27
+ * Синхронным геттерам нужны данные/хелперы core (`DEFAULT_PATTERNS`,
28
+ * `definitions/protected-paths.json`, системные словари). Прямой доступ к core
29
+ * невозможен: core — `peerDependencies`, а статический рантайм-импорт образовал бы
30
+ * цикл. Поэтому core **инъектирует** значения в конфиг драйвера
31
+ * (`PortDeps.coreSync`, сборка — `packages/core/src/storage/storage-context.ts`);
32
+ * без инъекции (прямой вызов фабрики) они собираются ленивым
33
+ * `import('@itphx/synth-core')` в `core-sync.ts`. Асинхронные методы (шифрование
34
+ * at-rest в `sshKeys`) грузят core тем же ленивым `import()` внутри функций.
35
+ */
36
+ import type { StorageContext } from '@itphx/synth-core';
37
+ import type { PortDeps } from './deps.js';
38
+ /** Часть `StorageContext`, которой владеет группа `content`. */
39
+ export type ContentPorts = Pick<StorageContext, 'serviceKeys' | 'sshKeys' | 'mcpRegistry' | 'skillBundles' | 'dictionaries' | 'secretPatterns' | 'protectedPaths' | 'maintenanceAudit'>;
40
+ /** Собрать порты группы `content`. */
41
+ export declare function buildContentPorts(deps: PortDeps): ContentPorts;