@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,64 @@
1
+ /**
2
+ * PG-реализация портов исходящих webhooks (PROP-032, волна 3b):
3
+ * `webhooks`/`webhookDeliveries`.
4
+ *
5
+ * Семантика повторяет файловые реализации core (`WebhookStore`,
6
+ * `WebhookDeliveryStore`): `label` уникальна глобально (регистронезависимо) →
7
+ * доменная `WebhookConflictError`; signing-секрет `whsec_…` хранится
8
+ * **зашифрованным** at-rest (`secret_enc bytea`, AES-256-GCM мастер-ключом,
9
+ * ADR-052/ADR-076) и отдаётся plaintext только при `create`/`regenerateSecret`
10
+ * (и расшифрованным — через `getSecret` для доставки); журнал доставок —
11
+ * append-only, `list(limit)` → последние N.
12
+ */
13
+ import { type CreateWebhookSubscriptionInput, type UpdateWebhookSubscriptionPatch, type WebhookDelivery, type WebhookSubscription, type WebhookSubscriptionCreated } from '@itphx/synth-shared';
14
+ import type { StorageContext } from '@itphx/synth-core';
15
+ import type { PortDeps } from './deps.js';
16
+ /** Часть `StorageContext`, которой владеет под-группа webhooks. */
17
+ export type EventWebhookPorts = Pick<StorageContext, 'webhooks' | 'webhookDeliveries'>;
18
+ /**
19
+ * ADR-052 (этап II): реестр подписок на исходящие события поверх `webhooks`.
20
+ *
21
+ * Signing-секрет шифруется мастер-ключом (core `encryptSecret`; ключ резолвится
22
+ * лениво — `resolveMasterKey`), поэтому HMAC-подпись доставки возможна, но
23
+ * plaintext at-rest не хранится. Конфликт метки (`lower(label)`) → доменная
24
+ * `WebhookConflictError` (роуты маппят в 409).
25
+ */
26
+ export declare class PgWebhookRepository {
27
+ private readonly _deps;
28
+ private _masterKeyPromise?;
29
+ constructor(_deps: PortDeps);
30
+ list(): Promise<WebhookSubscription[]>;
31
+ get(id: string): Promise<WebhookSubscription | null>;
32
+ create(input: CreateWebhookSubscriptionInput, createdBy: string): Promise<WebhookSubscriptionCreated>;
33
+ /** Патч: `undefined` — не трогать, `null` — сбросить (`description`). */
34
+ update(id: string, patch: UpdateWebhookSubscriptionPatch): Promise<WebhookSubscription | null>;
35
+ /** Мягкое включение/отключение (`disabledAt`). */
36
+ setEnabled(id: string, enabled: boolean): Promise<WebhookSubscription | null>;
37
+ remove(id: string): Promise<boolean>;
38
+ /** Ротация signing-секрета: новый `whsec_…` (шифруется), plaintext — один раз. */
39
+ regenerateSecret(id: string): Promise<WebhookSubscriptionCreated | null>;
40
+ /** Расшифрованный signing-секрет (только для доставки); неизвестный id — null. */
41
+ getSecret(id: string): Promise<string | null>;
42
+ /** Best-effort отметка последней доставки (`lastDeliveryAt`/`lastStatus`). */
43
+ touchDelivery(id: string, status: 'ok' | 'failed'): Promise<void>;
44
+ /** Новый signing-секрет + его зашифрованное представление (bytea). */
45
+ private _newSecret;
46
+ private _throwConflict;
47
+ /** Мастер-ключ секретов at-rest (env > `secretKey` > файл `{dataDir}/secrets`). */
48
+ private _masterKey;
49
+ }
50
+ /** ADR-052 (этап II): append-only журнал доставок поверх `webhook_deliveries`. */
51
+ export declare class PgWebhookDeliveryRepository {
52
+ private readonly _deps;
53
+ constructor(_deps: PortDeps);
54
+ record(delivery: WebhookDelivery): Promise<void>;
55
+ /** Все записи журнала (старые → новые), опционально последние `limit`. */
56
+ list(limit?: number): Promise<WebhookDelivery[]>;
57
+ /** Последние записи конкретной подписки (`limit` — последние N). */
58
+ listBySubscription(subscriptionId: string, limit?: number): Promise<WebhookDelivery[]>;
59
+ /** Retention: удаляет старше `retentionDays` (по `createdAt`); `0`/≤0 — no-op. */
60
+ prune(retentionDays: number): Promise<number>;
61
+ private _isLimited;
62
+ }
63
+ /** Собрать под-группу портов webhooks. */
64
+ export declare function buildEventWebhookPorts(deps: PortDeps): EventWebhookPorts;
@@ -0,0 +1,268 @@
1
+ /**
2
+ * PG-реализация портов исходящих webhooks (PROP-032, волна 3b):
3
+ * `webhooks`/`webhookDeliveries`.
4
+ *
5
+ * Семантика повторяет файловые реализации core (`WebhookStore`,
6
+ * `WebhookDeliveryStore`): `label` уникальна глобально (регистронезависимо) →
7
+ * доменная `WebhookConflictError`; signing-секрет `whsec_…` хранится
8
+ * **зашифрованным** at-rest (`secret_enc bytea`, AES-256-GCM мастер-ключом,
9
+ * ADR-052/ADR-076) и отдаётся plaintext только при `create`/`regenerateSecret`
10
+ * (и расшифрованным — через `getSecret` для доставки); журнал доставок —
11
+ * append-only, `list(limit)` → последние N.
12
+ */
13
+ import { randomBytes } from 'node:crypto';
14
+ import { WEBHOOK_SECRET_PREFIX, generateId, } from '@itphx/synth-shared';
15
+ import { jsonbParam } from '../json-param.js';
16
+ import { compact, isUniqueViolation, loadCore, SECRET_PREFIX_VISIBLE, toInt, toIso, toIsoRequired, } from './events-core.js';
17
+ function toPublicWebhook(row) {
18
+ return compact({
19
+ id: row.id,
20
+ label: row.label,
21
+ description: row.description ?? undefined,
22
+ url: row.url,
23
+ events: (row.events ?? []),
24
+ enabled: row.enabled,
25
+ secretPrefix: row.secret_prefix,
26
+ createdBy: row.created_by,
27
+ createdAt: toIsoRequired(row.created_at),
28
+ lastDeliveryAt: toIso(row.last_delivery_at),
29
+ lastStatus: (row.last_status ?? undefined),
30
+ disabledAt: toIso(row.disabled_at),
31
+ });
32
+ }
33
+ /**
34
+ * ADR-052 (этап II): реестр подписок на исходящие события поверх `webhooks`.
35
+ *
36
+ * Signing-секрет шифруется мастер-ключом (core `encryptSecret`; ключ резолвится
37
+ * лениво — `resolveMasterKey`), поэтому HMAC-подпись доставки возможна, но
38
+ * plaintext at-rest не хранится. Конфликт метки (`lower(label)`) → доменная
39
+ * `WebhookConflictError` (роуты маппят в 409).
40
+ */
41
+ export class PgWebhookRepository {
42
+ _deps;
43
+ _masterKeyPromise;
44
+ constructor(_deps) {
45
+ this._deps = _deps;
46
+ }
47
+ async list() {
48
+ const rows = await this._deps.connection.query('SELECT * FROM webhooks ORDER BY created_at, id');
49
+ return rows.map(toPublicWebhook);
50
+ }
51
+ async get(id) {
52
+ const rows = await this._deps.connection.query('SELECT * FROM webhooks WHERE id = $1 LIMIT 1', [id]);
53
+ return rows[0] ? toPublicWebhook(rows[0]) : null;
54
+ }
55
+ async create(input, createdBy) {
56
+ const label = (input.label ?? '').trim();
57
+ if (!label)
58
+ throw new Error('label обязателен');
59
+ const { secret, enc } = await this._newSecret();
60
+ let rows;
61
+ try {
62
+ rows = await this._deps.connection.query(`INSERT INTO webhooks
63
+ (id, label, description, url, events, enabled, secret_enc, secret_prefix,
64
+ created_by, created_at)
65
+ VALUES ($1, $2, $3, $4, $5::jsonb, $6, $7, $8, $9, $10)
66
+ RETURNING *`, [
67
+ `whk_${generateId()}`,
68
+ label,
69
+ input.description ?? null,
70
+ input.url,
71
+ jsonbParam(input.events ?? []),
72
+ input.enabled ?? true,
73
+ enc,
74
+ `${secret.slice(0, SECRET_PREFIX_VISIBLE)}…`,
75
+ createdBy,
76
+ new Date().toISOString(),
77
+ ]);
78
+ }
79
+ catch (err) {
80
+ if (isUniqueViolation(err))
81
+ await this._throwConflict(label);
82
+ throw err;
83
+ }
84
+ return { ...toPublicWebhook(rows[0]), secret };
85
+ }
86
+ /** Патч: `undefined` — не трогать, `null` — сбросить (`description`). */
87
+ async update(id, patch) {
88
+ const sets = [];
89
+ const params = [];
90
+ if (patch.label !== undefined) {
91
+ const label = patch.label.trim();
92
+ if (!label)
93
+ throw new Error('label обязателен');
94
+ params.push(label);
95
+ sets.push(`label = $${params.length}`);
96
+ }
97
+ if (patch.description !== undefined) {
98
+ params.push(patch.description);
99
+ sets.push(`description = $${params.length}`);
100
+ }
101
+ if (patch.url !== undefined) {
102
+ params.push(patch.url);
103
+ sets.push(`url = $${params.length}`);
104
+ }
105
+ if (patch.events !== undefined) {
106
+ params.push(jsonbParam(patch.events));
107
+ sets.push(`events = $${params.length}::jsonb`);
108
+ }
109
+ if (patch.enabled !== undefined) {
110
+ params.push(patch.enabled);
111
+ const idx = params.length;
112
+ sets.push(`enabled = $${idx}`);
113
+ sets.push(`disabled_at = CASE WHEN $${idx} THEN NULL ELSE now() END`);
114
+ }
115
+ if (sets.length === 0)
116
+ return this.get(id);
117
+ params.push(id);
118
+ try {
119
+ const rows = await this._deps.connection.query(`UPDATE webhooks SET ${sets.join(', ')} WHERE id = $${params.length} RETURNING *`, params);
120
+ return rows[0] ? toPublicWebhook(rows[0]) : null;
121
+ }
122
+ catch (err) {
123
+ if (isUniqueViolation(err))
124
+ await this._throwConflict(patch.label ?? id);
125
+ throw err;
126
+ }
127
+ }
128
+ /** Мягкое включение/отключение (`disabledAt`). */
129
+ async setEnabled(id, enabled) {
130
+ const rows = await this._deps.connection.query(`UPDATE webhooks
131
+ SET enabled = $2,
132
+ disabled_at = CASE WHEN $2 THEN NULL ELSE now() END
133
+ WHERE id = $1
134
+ RETURNING *`, [id, enabled]);
135
+ return rows[0] ? toPublicWebhook(rows[0]) : null;
136
+ }
137
+ async remove(id) {
138
+ // FK на `webhooks` нет — каскад чистим явно (паритет с файловой реализацией,
139
+ // где `remove` снимает подписку из реестра).
140
+ return this._deps.connection.withTransaction(async (tx) => {
141
+ await tx.query('DELETE FROM webhook_deliveries WHERE subscription_id = $1', [id]);
142
+ const rows = await tx.query('DELETE FROM webhooks WHERE id = $1 RETURNING id', [id]);
143
+ return rows.length > 0;
144
+ });
145
+ }
146
+ /** Ротация signing-секрета: новый `whsec_…` (шифруется), plaintext — один раз. */
147
+ async regenerateSecret(id) {
148
+ const { secret, enc } = await this._newSecret();
149
+ const rows = await this._deps.connection.query(`UPDATE webhooks SET secret_enc = $2, secret_prefix = $3 WHERE id = $1 RETURNING *`, [id, enc, `${secret.slice(0, SECRET_PREFIX_VISIBLE)}…`]);
150
+ return rows[0] ? { ...toPublicWebhook(rows[0]), secret } : null;
151
+ }
152
+ /** Расшифрованный signing-секрет (только для доставки); неизвестный id — null. */
153
+ async getSecret(id) {
154
+ const rows = await this._deps.connection.query('SELECT secret_enc FROM webhooks WHERE id = $1 LIMIT 1', [id]);
155
+ const stored = rows[0]?.secret_enc;
156
+ if (stored === undefined)
157
+ return null;
158
+ const key = await this._masterKey();
159
+ const { decryptSecret } = await loadCore();
160
+ return decryptSecret(Buffer.from(stored).toString('utf8'), key);
161
+ }
162
+ /** Best-effort отметка последней доставки (`lastDeliveryAt`/`lastStatus`). */
163
+ async touchDelivery(id, status) {
164
+ await this._deps.connection.query('UPDATE webhooks SET last_delivery_at = now(), last_status = $2 WHERE id = $1', [id, status]);
165
+ }
166
+ /** Новый signing-секрет + его зашифрованное представление (bytea). */
167
+ async _newSecret() {
168
+ const key = await this._masterKey();
169
+ const { encryptSecret } = await loadCore();
170
+ const secret = `${WEBHOOK_SECRET_PREFIX}${randomBytes(24).toString('base64url')}`;
171
+ return { secret, enc: Buffer.from(encryptSecret(secret, key), 'utf8') };
172
+ }
173
+ async _throwConflict(label) {
174
+ const { WebhookConflictError } = await loadCore();
175
+ throw new WebhookConflictError(label);
176
+ }
177
+ /** Мастер-ключ секретов at-rest (env > `secretKey` > файл `{dataDir}/secrets`). */
178
+ _masterKey() {
179
+ if (!this._masterKeyPromise) {
180
+ this._masterKeyPromise = (async () => {
181
+ const { resolveMasterKey } = await loadCore();
182
+ const result = await resolveMasterKey({
183
+ dataDir: this._deps.dataDir,
184
+ secretKey: this._deps.secretKey,
185
+ env: this._deps.env,
186
+ });
187
+ return result.key;
188
+ })().catch((err) => {
189
+ this._masterKeyPromise = undefined;
190
+ throw err;
191
+ });
192
+ }
193
+ return this._masterKeyPromise;
194
+ }
195
+ }
196
+ function toDelivery(row) {
197
+ return compact({
198
+ id: row.id,
199
+ subscriptionId: row.subscription_id,
200
+ eventType: row.event_type,
201
+ status: row.status,
202
+ attempts: toInt(row.attempts) ?? 0,
203
+ responseStatus: toInt(row.response_status),
204
+ error: row.error ?? undefined,
205
+ createdAt: toIsoRequired(row.created_at),
206
+ completedAt: toIso(row.completed_at),
207
+ });
208
+ }
209
+ /** ADR-052 (этап II): append-only журнал доставок поверх `webhook_deliveries`. */
210
+ export class PgWebhookDeliveryRepository {
211
+ _deps;
212
+ constructor(_deps) {
213
+ this._deps = _deps;
214
+ }
215
+ async record(delivery) {
216
+ await this._deps.connection.query(`INSERT INTO webhook_deliveries
217
+ (id, subscription_id, event_type, status, attempts, response_status, error,
218
+ created_at, completed_at)
219
+ VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9)`, [
220
+ delivery.id,
221
+ delivery.subscriptionId,
222
+ delivery.eventType,
223
+ delivery.status,
224
+ delivery.attempts,
225
+ delivery.responseStatus ?? null,
226
+ delivery.error ?? null,
227
+ delivery.createdAt,
228
+ delivery.completedAt ?? null,
229
+ ]);
230
+ }
231
+ /** Все записи журнала (старые → новые), опционально последние `limit`. */
232
+ async list(limit) {
233
+ const rows = this._isLimited(limit)
234
+ ? await this._deps.connection.query(`SELECT * FROM (
235
+ SELECT * FROM webhook_deliveries ORDER BY seq DESC LIMIT $1
236
+ ) t ORDER BY seq ASC`, [Math.floor(limit)])
237
+ : await this._deps.connection.query('SELECT * FROM webhook_deliveries ORDER BY seq ASC');
238
+ return rows.map(toDelivery);
239
+ }
240
+ /** Последние записи конкретной подписки (`limit` — последние N). */
241
+ async listBySubscription(subscriptionId, limit) {
242
+ const rows = this._isLimited(limit)
243
+ ? await this._deps.connection.query(`SELECT * FROM (
244
+ SELECT * FROM webhook_deliveries WHERE subscription_id = $1 ORDER BY seq DESC LIMIT $2
245
+ ) t ORDER BY seq ASC`, [subscriptionId, Math.floor(limit)])
246
+ : await this._deps.connection.query('SELECT * FROM webhook_deliveries WHERE subscription_id = $1 ORDER BY seq ASC', [subscriptionId]);
247
+ return rows.map(toDelivery);
248
+ }
249
+ /** Retention: удаляет старше `retentionDays` (по `createdAt`); `0`/≤0 — no-op. */
250
+ async prune(retentionDays) {
251
+ if (!Number.isFinite(retentionDays) || retentionDays <= 0)
252
+ return 0;
253
+ const rows = await this._deps.connection.query(`DELETE FROM webhook_deliveries
254
+ WHERE created_at < now() - interval '1 day' * $1::double precision
255
+ RETURNING seq`, [retentionDays]);
256
+ return rows.length;
257
+ }
258
+ _isLimited(limit) {
259
+ return limit !== undefined && Number.isFinite(limit) && limit > 0;
260
+ }
261
+ }
262
+ /** Собрать под-группу портов webhooks. */
263
+ export function buildEventWebhookPorts(deps) {
264
+ return {
265
+ webhooks: new PgWebhookRepository(deps),
266
+ webhookDeliveries: new PgWebhookDeliveryRepository(deps),
267
+ };
268
+ }
@@ -0,0 +1,20 @@
1
+ /**
2
+ * Группа портов **событий, расписаний и webhooks** PostgreSQL-драйвера
3
+ * (PROP-032, волна 3b).
4
+ *
5
+ * Фабрика `buildEventPorts(deps)` собирает свою часть `StorageContext` из четырёх
6
+ * независимых под-файлов (каждый — отдельная подсистема, удобно править/тестировать):
7
+ * - `events-bindings.ts` → `eventBindings`/`eventRoutes`/`eventApiKeys`;
8
+ * - `events-journal.ts` → `eventJournal`/`identityClaims`/`dedup`;
9
+ * - `events-scheduler.ts` → `schedules`/`jobs`;
10
+ * - `events-webhooks.ts` → `webhooks`/`webhookDeliveries`.
11
+ *
12
+ * Общие примитивы (ленивая загрузка core, типы-алиасы, хелперы) — `events-core.ts`.
13
+ * Контракты — `packages/core/src/storage/contract/{events,scheduler,secrets}.ts`.
14
+ */
15
+ import type { StorageContext } from '@itphx/synth-core';
16
+ import type { PortDeps } from './deps.js';
17
+ /** Часть `StorageContext`, которой владеет группа `events`. */
18
+ export type EventPorts = Pick<StorageContext, 'eventBindings' | 'eventRoutes' | 'eventApiKeys' | 'eventJournal' | 'identityClaims' | 'dedup' | 'schedules' | 'jobs' | 'webhooks' | 'webhookDeliveries'>;
19
+ /** Собрать порты группы `events`. */
20
+ export declare function buildEventPorts(deps: PortDeps): EventPorts;
@@ -0,0 +1,27 @@
1
+ /**
2
+ * Группа портов **событий, расписаний и webhooks** PostgreSQL-драйвера
3
+ * (PROP-032, волна 3b).
4
+ *
5
+ * Фабрика `buildEventPorts(deps)` собирает свою часть `StorageContext` из четырёх
6
+ * независимых под-файлов (каждый — отдельная подсистема, удобно править/тестировать):
7
+ * - `events-bindings.ts` → `eventBindings`/`eventRoutes`/`eventApiKeys`;
8
+ * - `events-journal.ts` → `eventJournal`/`identityClaims`/`dedup`;
9
+ * - `events-scheduler.ts` → `schedules`/`jobs`;
10
+ * - `events-webhooks.ts` → `webhooks`/`webhookDeliveries`.
11
+ *
12
+ * Общие примитивы (ленивая загрузка core, типы-алиасы, хелперы) — `events-core.ts`.
13
+ * Контракты — `packages/core/src/storage/contract/{events,scheduler,secrets}.ts`.
14
+ */
15
+ import { buildEventBindingPorts } from './events-bindings.js';
16
+ import { buildEventJournalPorts } from './events-journal.js';
17
+ import { buildEventSchedulerPorts } from './events-scheduler.js';
18
+ import { buildEventWebhookPorts } from './events-webhooks.js';
19
+ /** Собрать порты группы `events`. */
20
+ export function buildEventPorts(deps) {
21
+ return {
22
+ ...buildEventBindingPorts(deps),
23
+ ...buildEventJournalPorts(deps),
24
+ ...buildEventSchedulerPorts(deps),
25
+ ...buildEventWebhookPorts(deps),
26
+ };
27
+ }
@@ -0,0 +1,21 @@
1
+ /**
2
+ * Порт `defaults` (умолчания оформления) PostgreSQL-драйвера
3
+ * (PROP-032, волна 3b).
4
+ *
5
+ * Эталон семантики — `DefaultsStore`/`MemoryDefaultsRepository`: `loadDefaults`
6
+ * на пустом сторе — `{}`; `saveDefaults` — частичный патч, сливается поверх
7
+ * текущих значений; некорректные поля отбрасываются (санитизация). Санитизация
8
+ * воспроизводится локально: core не экспортирует хелпер, а поведение обязано
9
+ * совпадать с файловой реализацией.
10
+ *
11
+ * Хранение — ключ `defaults` в таблице `settings` (`jsonb`). Read-modify-write
12
+ * (как в файловой реализации) выполняется в транзакции с блокировкой строки.
13
+ */
14
+ import type { StorageContext } from '@itphx/synth-core';
15
+ import type { PostgresConnection } from '../pool.js';
16
+ type DefaultsPort = StorageContext['defaults'];
17
+ /** Ключ секции умолчаний оформления в таблице `settings`. */
18
+ export declare const DEFAULTS_SETTINGS_KEY = "defaults";
19
+ /** Собрать порт умолчаний оформления поверх SQL. */
20
+ export declare function createPrincipalDefaultsPort(conn: PostgresConnection): DefaultsPort;
21
+ export {};
@@ -0,0 +1,68 @@
1
+ /**
2
+ * Порт `defaults` (умолчания оформления) PostgreSQL-драйвера
3
+ * (PROP-032, волна 3b).
4
+ *
5
+ * Эталон семантики — `DefaultsStore`/`MemoryDefaultsRepository`: `loadDefaults`
6
+ * на пустом сторе — `{}`; `saveDefaults` — частичный патч, сливается поверх
7
+ * текущих значений; некорректные поля отбрасываются (санитизация). Санитизация
8
+ * воспроизводится локально: core не экспортирует хелпер, а поведение обязано
9
+ * совпадать с файловой реализацией.
10
+ *
11
+ * Хранение — ключ `defaults` в таблице `settings` (`jsonb`). Read-modify-write
12
+ * (как в файловой реализации) выполняется в транзакции с блокировкой строки.
13
+ */
14
+ import { readSetting, writeSetting } from './principals-shared.js';
15
+ /** Ключ секции умолчаний оформления в таблице `settings`. */
16
+ export const DEFAULTS_SETTINGS_KEY = 'defaults';
17
+ /** Минимальный/максимальный допустимый масштаб интерфейса (паритет `DefaultsStore`). */
18
+ const UI_SCALE_MIN = 0.5;
19
+ const UI_SCALE_MAX = 1.2;
20
+ /** Масштаб интерфейса: число в диапазоне 0.5..1.2, иначе `undefined`. */
21
+ function sanitizeScale(value) {
22
+ if (typeof value === 'number' && Number.isFinite(value) && value >= UI_SCALE_MIN && value <= UI_SCALE_MAX) {
23
+ return value;
24
+ }
25
+ return undefined;
26
+ }
27
+ /** Оставить только валидные поля умолчаний оформления (паритет `DefaultsStore`). */
28
+ function sanitize(raw) {
29
+ if (typeof raw !== 'object' || raw === null)
30
+ return {};
31
+ const src = raw;
32
+ const out = {};
33
+ if (src.locale === 'ru' || src.locale === 'en')
34
+ out.locale = src.locale;
35
+ if (src.themeMode === 'system' || src.themeMode === 'light' || src.themeMode === 'dark') {
36
+ out.themeMode = src.themeMode;
37
+ }
38
+ if (typeof src.theme === 'string' && src.theme.trim() !== '')
39
+ out.theme = src.theme;
40
+ const mobile = sanitizeScale(src.uiScaleMobile);
41
+ if (mobile !== undefined)
42
+ out.uiScaleMobile = mobile;
43
+ const desktop = sanitizeScale(src.uiScaleDesktop);
44
+ if (desktop !== undefined)
45
+ out.uiScaleDesktop = desktop;
46
+ return out;
47
+ }
48
+ /** Прочитать умолчания оформления (без блокировки — чтение). */
49
+ async function readDefaults(exec) {
50
+ return sanitize(await readSetting(exec, DEFAULTS_SETTINGS_KEY));
51
+ }
52
+ /** Собрать порт умолчаний оформления поверх SQL. */
53
+ export function createPrincipalDefaultsPort(conn) {
54
+ return {
55
+ async loadDefaults() {
56
+ return readDefaults(conn);
57
+ },
58
+ async saveDefaults(patch) {
59
+ return conn.withTransaction(async (tx) => {
60
+ // Блокируем строку секции, чтобы конкурентный патч не потерялся (как AsyncLock в файловой реализации).
61
+ const rows = await tx.query('SELECT value FROM settings WHERE key = $1 FOR UPDATE', [DEFAULTS_SETTINGS_KEY]);
62
+ const next = { ...sanitize(rows[0]?.value), ...sanitize(patch) };
63
+ await writeSetting(tx, DEFAULTS_SETTINGS_KEY, next);
64
+ return next;
65
+ });
66
+ },
67
+ };
68
+ }
@@ -0,0 +1,23 @@
1
+ /**
2
+ * Порты `providers`/`models`/`agents` PostgreSQL-драйвера (PROP-032, волна 3b).
3
+ *
4
+ * Все три — `DocumentRepository<T>` над одной таблицей `documents(kind, key,
5
+ * value jsonb)`: `kind` = `provider`/`model`/`agent`, ключ документа — как в
6
+ * файловой/in-memory реализации (для моделей — `provider/model`). Драйвер не
7
+ * интерпретирует ключ: он лишь хранит документ целиком, поэтому вложенные ключи
8
+ * работают без специальной обработки.
9
+ *
10
+ * `load` отсутствующего — `null`, `exists` — наличие строки (значение `jsonb`
11
+ * `NOT NULL`, пустых/битых документов в БД не бывает), `delete` идемпотентен.
12
+ */
13
+ import type { AgentDefinition, ModelConfig, ProviderConfig } from '@itphx/synth-shared';
14
+ import type { DocumentRepository } from '@itphx/synth-core';
15
+ import type { PostgresConnection } from '../pool.js';
16
+ /** Документ-провайдер. */
17
+ export type ProviderDocument = ProviderConfig;
18
+ /** Документ-модель. */
19
+ export type ModelDocument = ModelConfig;
20
+ /** Документ-агент. */
21
+ export type AgentDocument = AgentDefinition;
22
+ /** Собрать `DocumentRepository<T>` поверх таблицы `documents` для заданного `kind`. */
23
+ export declare function createDocumentPort<T>(conn: PostgresConnection, kind: 'provider' | 'model' | 'agent'): DocumentRepository<T>;
@@ -0,0 +1,38 @@
1
+ /**
2
+ * Порты `providers`/`models`/`agents` PostgreSQL-драйвера (PROP-032, волна 3b).
3
+ *
4
+ * Все три — `DocumentRepository<T>` над одной таблицей `documents(kind, key,
5
+ * value jsonb)`: `kind` = `provider`/`model`/`agent`, ключ документа — как в
6
+ * файловой/in-memory реализации (для моделей — `provider/model`). Драйвер не
7
+ * интерпретирует ключ: он лишь хранит документ целиком, поэтому вложенные ключи
8
+ * работают без специальной обработки.
9
+ *
10
+ * `load` отсутствующего — `null`, `exists` — наличие строки (значение `jsonb`
11
+ * `NOT NULL`, пустых/битых документов в БД не бывает), `delete` идемпотентен.
12
+ */
13
+ import { jsonbParam } from '../json-param.js';
14
+ /** Собрать `DocumentRepository<T>` поверх таблицы `documents` для заданного `kind`. */
15
+ export function createDocumentPort(conn, kind) {
16
+ return {
17
+ async load(key) {
18
+ const rows = await conn.query('SELECT value FROM documents WHERE kind = $1 AND key = $2', [kind, key]);
19
+ const row = rows[0];
20
+ return row ? row.value : null;
21
+ },
22
+ async save(key, value) {
23
+ await conn.query(`INSERT INTO documents (kind, key, value, updated_at) VALUES ($1, $2, $3::jsonb, now())
24
+ ON CONFLICT (kind, key) DO UPDATE SET value = EXCLUDED.value, updated_at = now()`, [kind, key, jsonbParam(value)]);
25
+ },
26
+ async delete(key) {
27
+ await conn.query('DELETE FROM documents WHERE kind = $1 AND key = $2', [kind, key]);
28
+ },
29
+ async exists(key) {
30
+ const rows = await conn.query('SELECT 1 AS present FROM documents WHERE kind = $1 AND key = $2', [kind, key]);
31
+ return rows.length > 0;
32
+ },
33
+ async list() {
34
+ const rows = await conn.query('SELECT value FROM documents WHERE kind = $1 ORDER BY key', [kind]);
35
+ return rows.map((row) => row.value);
36
+ },
37
+ };
38
+ }
@@ -0,0 +1,21 @@
1
+ /**
2
+ * Порт `profiles` PostgreSQL-драйвера (PROP-032, волна 3b).
3
+ *
4
+ * Эталон семантики — `FileProfileStore`/`MemoryProfileRepository`:
5
+ * - `saveProfile` проставляет `updatedAt` при записи;
6
+ * - `listProfiles` — `updated_at DESC`; `deleteProfile` — boolean;
7
+ * - `getOrCreateProfile` идемпотентен по `username`;
8
+ * - ADR-089: `identities` — child-таблица `profile_identities` (snake_case
9
+ * `external_id`/`display_name`/`linked_at`/`linked_by`, UNIQUE
10
+ * `(provider, external_id)`); `linkIdentity` идемпотентна и **не бросает**
11
+ * при конфликте пары с другим профилем (`null`), `unlinkIdentity` без записи
12
+ * возвращает `null`; обе операции атомарны.
13
+ *
14
+ * `roles`/`team_roles`/`preferences` — `jsonb`; `username`/`email` — UNIQUE.
15
+ */
16
+ import type { StorageContext } from '@itphx/synth-core';
17
+ import type { PostgresConnection } from '../pool.js';
18
+ type ProfilesPort = StorageContext['profiles'];
19
+ /** Собрать порт профилей поверх SQL. */
20
+ export declare function createPrincipalProfilesPort(conn: PostgresConnection): ProfilesPort;
21
+ export {};