@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.
- package/LICENSE +18 -0
- package/LICENSE.ru.md +31 -0
- package/dist/errors.d.ts +71 -0
- package/dist/errors.js +126 -0
- package/dist/index.d.ts +37 -0
- package/dist/index.js +34 -0
- package/dist/json-param.d.ts +14 -0
- package/dist/json-param.js +22 -0
- package/dist/locks.d.ts +104 -0
- package/dist/locks.js +201 -0
- package/dist/migrate.d.ts +58 -0
- package/dist/migrate.js +125 -0
- package/dist/migrations/001-init.d.ts +15 -0
- package/dist/migrations/001-init.js +457 -0
- package/dist/migrations/002-egress-audit.d.ts +12 -0
- package/dist/migrations/002-egress-audit.js +52 -0
- package/dist/migrations/003-analytics-rollups.d.ts +12 -0
- package/dist/migrations/003-analytics-rollups.js +21 -0
- package/dist/migrations/index.d.ts +23 -0
- package/dist/migrations/index.js +23 -0
- package/dist/pool.d.ts +178 -0
- package/dist/pool.js +382 -0
- package/dist/ports/analytics.d.ts +26 -0
- package/dist/ports/analytics.js +243 -0
- package/dist/ports/audit.d.ts +15 -0
- package/dist/ports/audit.js +189 -0
- package/dist/ports/content.d.ts +41 -0
- package/dist/ports/content.js +1539 -0
- package/dist/ports/core-sync.d.ts +31 -0
- package/dist/ports/core-sync.js +34 -0
- package/dist/ports/deps.d.ts +63 -0
- package/dist/ports/deps.js +19 -0
- package/dist/ports/events-bindings.d.ts +77 -0
- package/dist/ports/events-bindings.js +356 -0
- package/dist/ports/events-core.d.ts +35 -0
- package/dist/ports/events-core.js +71 -0
- package/dist/ports/events-journal.d.ts +68 -0
- package/dist/ports/events-journal.js +211 -0
- package/dist/ports/events-scheduler.d.ts +49 -0
- package/dist/ports/events-scheduler.js +231 -0
- package/dist/ports/events-webhooks.d.ts +64 -0
- package/dist/ports/events-webhooks.js +268 -0
- package/dist/ports/events.d.ts +20 -0
- package/dist/ports/events.js +27 -0
- package/dist/ports/principals-defaults.d.ts +21 -0
- package/dist/ports/principals-defaults.js +68 -0
- package/dist/ports/principals-documents.d.ts +23 -0
- package/dist/ports/principals-documents.js +38 -0
- package/dist/ports/principals-profiles.d.ts +21 -0
- package/dist/ports/principals-profiles.js +263 -0
- package/dist/ports/principals-projects.d.ts +19 -0
- package/dist/ports/principals-projects.js +158 -0
- package/dist/ports/principals-settings.d.ts +25 -0
- package/dist/ports/principals-settings.js +275 -0
- package/dist/ports/principals-shared.d.ts +33 -0
- package/dist/ports/principals-shared.js +44 -0
- package/dist/ports/principals.d.ts +27 -0
- package/dist/ports/principals.js +39 -0
- package/dist/ports/sessions-mapping.d.ts +237 -0
- package/dist/ports/sessions-mapping.js +405 -0
- package/dist/ports/sessions.d.ts +133 -0
- package/dist/ports/sessions.js +502 -0
- package/dist/ports/stub.d.ts +14 -0
- package/dist/ports/stub.js +32 -0
- package/dist/postgres-storage.d.ts +59 -0
- package/dist/postgres-storage.js +111 -0
- package/dist/schema.d.ts +13 -0
- package/dist/schema.js +22 -0
- package/dist/storage-context.d.ts +51 -0
- package/dist/storage-context.js +130 -0
- package/package.json +40 -3
- package/README.md +0 -3
|
@@ -0,0 +1,111 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Драйвер слоя хранения Synth на PostgreSQL — публичная фабрика (ADR-096/ADR-097,
|
|
3
|
+
* PROP-032).
|
|
4
|
+
*
|
|
5
|
+
* Пакет `@itphx/synth-storage-postgres` — in-tree **опциональный** драйвер: он
|
|
6
|
+
* реализует доменные порты `StorageContext` и подключается из
|
|
7
|
+
* `createStorageContext` динамическим `import()` при `storage.backend === 'postgres'`.
|
|
8
|
+
*
|
|
9
|
+
* Волна 3a — **инфраструктура**: пул/подключение, схема БД и миграции
|
|
10
|
+
* (`migrate.ts` + `migrations/*`), сборка контекста (`storage-context.ts`).
|
|
11
|
+
* Доменные порты реализуются следующей волной, поэтому `createPostgresStorage`
|
|
12
|
+
* применяет (или проверяет) схему и возвращает контекст с файловыми FS-портами
|
|
13
|
+
* и заглушками PG-портов.
|
|
14
|
+
*
|
|
15
|
+
* `pg` — `optionalDependencies` пакета и подключается **лениво** (`pool.ts`):
|
|
16
|
+
* импорт модуля драйвера не требует установленного `pg`.
|
|
17
|
+
*/
|
|
18
|
+
import { PostgresStorageConfigError } from './errors.js';
|
|
19
|
+
import { assertSchemaCurrent, runMigrations } from './migrate.js';
|
|
20
|
+
import { createPostgresConnection, assertNoDsnTlsParams, } from './pool.js';
|
|
21
|
+
import { DEFAULT_SCHEMA, assertValidSchema } from './schema.js';
|
|
22
|
+
import { resolveCoreSyncDeps } from './ports/core-sync.js';
|
|
23
|
+
import { buildPostgresStorageContext } from './storage-context.js';
|
|
24
|
+
// Реэкспорт ошибок драйвера (в т.ч. для обратной совместимости импортов).
|
|
25
|
+
export * from './errors.js';
|
|
26
|
+
function isNonEmptyString(value) {
|
|
27
|
+
return typeof value === 'string' && value.trim().length > 0;
|
|
28
|
+
}
|
|
29
|
+
/**
|
|
30
|
+
* Валидация конфига **до** любого обращения к БД: нужен либо
|
|
31
|
+
* `connectionString`, либо пара `pool.host` + `pool.database`; схема — безопасный
|
|
32
|
+
* идентификатор.
|
|
33
|
+
*/
|
|
34
|
+
export function validatePostgresConfig(config) {
|
|
35
|
+
if (!isNonEmptyString(config.dataDir)) {
|
|
36
|
+
throw new PostgresStorageConfigError('Не задан `dataDir` (базовый каталог инстанса).');
|
|
37
|
+
}
|
|
38
|
+
const pool = config.pool;
|
|
39
|
+
if (pool !== undefined) {
|
|
40
|
+
const port = pool.port;
|
|
41
|
+
if (port !== undefined && (!Number.isInteger(port) || port < 1 || port > 65535)) {
|
|
42
|
+
throw new PostgresStorageConfigError(`Некорректный \`pool.port\`: ${String(port)} (ожидается целое 1–65535).`);
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
if (config.schema !== undefined)
|
|
46
|
+
assertValidSchema(config.schema);
|
|
47
|
+
// ADR-099/PROP-032: fail-closed до обращения к БД — TLS-параметры в DSN
|
|
48
|
+
// молча перекрываются конфигом (`pg` накладывает DSN поверх `ssl`).
|
|
49
|
+
assertNoDsnTlsParams(config.connectionString);
|
|
50
|
+
const hasConnectionString = isNonEmptyString(config.connectionString);
|
|
51
|
+
const hasPoolFields = !!pool && isNonEmptyString(pool.host) && isNonEmptyString(pool.database);
|
|
52
|
+
if (!hasConnectionString && !hasPoolFields) {
|
|
53
|
+
throw new PostgresStorageConfigError('Не задан способ подключения: укажите `connectionString` либо `pool.host` + `pool.database`.');
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
/**
|
|
57
|
+
* Собрать `StorageContext` на PostgreSQL (форма — ADR-097/PROP-032).
|
|
58
|
+
*
|
|
59
|
+
* Валидирует конфиг, лениво подключается к БД, применяет миграции (или, при
|
|
60
|
+
* `migrate:false`, проверяет актуальность схемы — fail-closed) и возвращает
|
|
61
|
+
* контекст: FS/package-bound порты (`skills`/`contextFiles`/`blobs`) — файловые,
|
|
62
|
+
* остальные — заглушки PG (порты реализуются следующей волной).
|
|
63
|
+
*/
|
|
64
|
+
export async function createPostgresStorage(config) {
|
|
65
|
+
validatePostgresConfig(config);
|
|
66
|
+
const schema = config.schema ?? DEFAULT_SCHEMA;
|
|
67
|
+
const conn = createPostgresConnection({
|
|
68
|
+
connectionString: config.connectionString,
|
|
69
|
+
pool: config.pool,
|
|
70
|
+
// ADR-099: доверие TLS/CA (`security.tls`) и env для резолва — единый источник.
|
|
71
|
+
tls: config.tls,
|
|
72
|
+
env: config.env,
|
|
73
|
+
password: config.password,
|
|
74
|
+
schema,
|
|
75
|
+
statementTimeoutMillis: config.statementTimeoutMillis,
|
|
76
|
+
idleInTransactionTimeoutMillis: config.idleInTransactionTimeoutMillis,
|
|
77
|
+
applicationName: config.applicationName,
|
|
78
|
+
});
|
|
79
|
+
try {
|
|
80
|
+
// PROP-032: режим схемы — `apply` (дефолт), `assert` (DBA), `skip` (диагностика).
|
|
81
|
+
const schemaMode = config.schemaMode ?? config.postgresSchemaMode
|
|
82
|
+
?? (config.migrate === false ? 'assert' : 'apply');
|
|
83
|
+
if (schemaMode === 'assert') {
|
|
84
|
+
await assertSchemaCurrent(conn, { schema });
|
|
85
|
+
}
|
|
86
|
+
else if (schemaMode === 'apply') {
|
|
87
|
+
await runMigrations(conn, { schema });
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
catch (err) {
|
|
91
|
+
await conn.end().catch(() => undefined);
|
|
92
|
+
throw err;
|
|
93
|
+
}
|
|
94
|
+
// PROP-032: соединение удерживается в контексте (порты БД ходят через него),
|
|
95
|
+
// `ctx.close()` закрывает пул. Незанятые соединения не удерживают event loop
|
|
96
|
+
// (`allowExitOnIdle` в `pool.ts`), поэтому CLI-команды завершаются.
|
|
97
|
+
return buildPostgresStorageContext({
|
|
98
|
+
dataDir: config.dataDir,
|
|
99
|
+
secretKey: config.secretKey,
|
|
100
|
+
env: config.env,
|
|
101
|
+
systemDictionariesDir: config.systemDictionariesDir,
|
|
102
|
+
contextUserDataDir: config.contextUserDataDir,
|
|
103
|
+
connection: conn,
|
|
104
|
+
// Инъекция из core (штатный путь) либо ленивый `import()` (прямой вызов).
|
|
105
|
+
coreSync: config.coreSync ??
|
|
106
|
+
(await resolveCoreSyncDeps({
|
|
107
|
+
dataDir: config.dataDir,
|
|
108
|
+
systemDictionariesDir: config.systemDictionariesDir,
|
|
109
|
+
})),
|
|
110
|
+
});
|
|
111
|
+
}
|
package/dist/schema.d.ts
ADDED
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Работа с идентификатором схемы PostgreSQL (namespace таблиц драйвера).
|
|
3
|
+
*
|
|
4
|
+
* Имена схем подставляются в DDL/`search_path`, поэтому принимаются только
|
|
5
|
+
* безопасные идентификаторы (буква/`_`, далее буквы/цифры/`_`) — параметризовать
|
|
6
|
+
* идентификаторы нельзя, а `quoteIdent` оборачивает имя в кавычки.
|
|
7
|
+
*/
|
|
8
|
+
/** Схема по умолчанию (`public`), если в конфиге не задано иное. */
|
|
9
|
+
export declare const DEFAULT_SCHEMA = "public";
|
|
10
|
+
/** Проверяет, что имя схемы — безопасный идентификатор (иначе конфиг-ошибка). */
|
|
11
|
+
export declare function assertValidSchema(schema: string): string;
|
|
12
|
+
/** Экранирование идентификатора (двойные кавычки) для подстановки в SQL. */
|
|
13
|
+
export declare function quoteIdent(ident: string): string;
|
package/dist/schema.js
ADDED
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Работа с идентификатором схемы PostgreSQL (namespace таблиц драйвера).
|
|
3
|
+
*
|
|
4
|
+
* Имена схем подставляются в DDL/`search_path`, поэтому принимаются только
|
|
5
|
+
* безопасные идентификаторы (буква/`_`, далее буквы/цифры/`_`) — параметризовать
|
|
6
|
+
* идентификаторы нельзя, а `quoteIdent` оборачивает имя в кавычки.
|
|
7
|
+
*/
|
|
8
|
+
import { PostgresStorageConfigError } from './errors.js';
|
|
9
|
+
const SCHEMA_RE = /^[A-Za-z_][A-Za-z0-9_]*$/;
|
|
10
|
+
/** Схема по умолчанию (`public`), если в конфиге не задано иное. */
|
|
11
|
+
export const DEFAULT_SCHEMA = 'public';
|
|
12
|
+
/** Проверяет, что имя схемы — безопасный идентификатор (иначе конфиг-ошибка). */
|
|
13
|
+
export function assertValidSchema(schema) {
|
|
14
|
+
if (!SCHEMA_RE.test(schema)) {
|
|
15
|
+
throw new PostgresStorageConfigError(`Некорректное имя схемы \`${schema}\`: допустимы буквы/цифры/подчёркивание, первым символом — не цифра.`);
|
|
16
|
+
}
|
|
17
|
+
return schema;
|
|
18
|
+
}
|
|
19
|
+
/** Экранирование идентификатора (двойные кавычки) для подстановки в SQL. */
|
|
20
|
+
export function quoteIdent(ident) {
|
|
21
|
+
return `"${ident.replace(/"/g, '""')}"`;
|
|
22
|
+
}
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Сборка `StorageContext` PostgreSQL-драйвера (PROP-032, волна 3b-каркас).
|
|
3
|
+
*
|
|
4
|
+
* Контекст собирается из независимых файлов-групп портов
|
|
5
|
+
* (`src/ports/{sessions,principals,events,content,audit,analytics}.ts`) — по одной
|
|
6
|
+
* фабрике на группу, чтобы волна реализации правила группы параллельно и без
|
|
7
|
+
* конфликтов:
|
|
8
|
+
* - `buildSessionPorts(deps)` → `sessions`;
|
|
9
|
+
* - `buildPrincipalPorts(deps)` → `projects`/`profiles`/`settings`/`defaults`/
|
|
10
|
+
* `providers`/`models`/`agents`;
|
|
11
|
+
* - `buildEventPorts(deps)` → `eventBindings`/`eventRoutes`/`eventApiKeys`/
|
|
12
|
+
* `eventJournal`/`identityClaims`/`dedup`/`schedules`/`jobs`/`webhooks`/
|
|
13
|
+
* `webhookDeliveries`;
|
|
14
|
+
* - `buildContentPorts(deps)` → `serviceKeys`/`sshKeys`/`mcpRegistry`/
|
|
15
|
+
* `skillBundles`/`dictionaries`/`secretPatterns`/`protectedPaths`/
|
|
16
|
+
* `maintenanceAudit`;
|
|
17
|
+
* - `buildAuditPorts(deps)` → `securityAudit`/`egressRequests`;
|
|
18
|
+
* - `buildAnalyticsPorts(deps)` → `analyticsRollups` (PROP-102).
|
|
19
|
+
*
|
|
20
|
+
* Все доменные порты реализованы поверх SQL; FS/package-bound порты (`skills`,
|
|
21
|
+
* `contextFiles`, `blobs`) — **файловые реализации** core (контент скиллов/
|
|
22
|
+
* prompts-ролей и blob-дерево остаются на диске; ADR-091/ADR-092: ФС-периметр
|
|
23
|
+
* вне портов).
|
|
24
|
+
*
|
|
25
|
+
* Осознанное исключение: драйвер в этой части **импортирует core рантаймом**
|
|
26
|
+
* (`createFileStorage`), чтобы переиспользовать уже проверенные файловые
|
|
27
|
+
* реализации, а не дублировать их. Для портов БД core по-прежнему не тянется:
|
|
28
|
+
* порты подключаются динамическим `import()` из core по `storage.backend`.
|
|
29
|
+
*/
|
|
30
|
+
import type { StorageContext } from '@itphx/synth-core';
|
|
31
|
+
import type { PostgresConnection } from './pool.js';
|
|
32
|
+
import type { CoreSyncDeps } from './ports/deps.js';
|
|
33
|
+
/** Опции сборки контекста PostgreSQL. */
|
|
34
|
+
export interface BuildPostgresContextOptions {
|
|
35
|
+
dataDir: string;
|
|
36
|
+
secretKey?: string;
|
|
37
|
+
env?: NodeJS.ProcessEnv;
|
|
38
|
+
/** Каталог системных словарей (пробрасывается группе `content`/файловым портам). */
|
|
39
|
+
systemDictionariesDir?: string;
|
|
40
|
+
/** Корень пользовательских промптов/ролей (файловый порт `contextFiles`). */
|
|
41
|
+
contextUserDataDir?: string;
|
|
42
|
+
/**
|
|
43
|
+
* PROP-032: живое соединение драйвера — удерживается в контексте, порты БД
|
|
44
|
+
* ходят через него; `close()` контекста закрывает пул.
|
|
45
|
+
*/
|
|
46
|
+
connection: PostgresConnection;
|
|
47
|
+
/** ADR-097/PROP-032: синхронные данные/хелперы core (см. `CoreSyncDeps`). */
|
|
48
|
+
coreSync: CoreSyncDeps;
|
|
49
|
+
}
|
|
50
|
+
/** Собрать `StorageContext`: четыре группы портов + файловые FS-порты + `close`. */
|
|
51
|
+
export declare function buildPostgresStorageContext(opts: BuildPostgresContextOptions): StorageContext;
|
|
@@ -0,0 +1,130 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Сборка `StorageContext` PostgreSQL-драйвера (PROP-032, волна 3b-каркас).
|
|
3
|
+
*
|
|
4
|
+
* Контекст собирается из независимых файлов-групп портов
|
|
5
|
+
* (`src/ports/{sessions,principals,events,content,audit,analytics}.ts`) — по одной
|
|
6
|
+
* фабрике на группу, чтобы волна реализации правила группы параллельно и без
|
|
7
|
+
* конфликтов:
|
|
8
|
+
* - `buildSessionPorts(deps)` → `sessions`;
|
|
9
|
+
* - `buildPrincipalPorts(deps)` → `projects`/`profiles`/`settings`/`defaults`/
|
|
10
|
+
* `providers`/`models`/`agents`;
|
|
11
|
+
* - `buildEventPorts(deps)` → `eventBindings`/`eventRoutes`/`eventApiKeys`/
|
|
12
|
+
* `eventJournal`/`identityClaims`/`dedup`/`schedules`/`jobs`/`webhooks`/
|
|
13
|
+
* `webhookDeliveries`;
|
|
14
|
+
* - `buildContentPorts(deps)` → `serviceKeys`/`sshKeys`/`mcpRegistry`/
|
|
15
|
+
* `skillBundles`/`dictionaries`/`secretPatterns`/`protectedPaths`/
|
|
16
|
+
* `maintenanceAudit`;
|
|
17
|
+
* - `buildAuditPorts(deps)` → `securityAudit`/`egressRequests`;
|
|
18
|
+
* - `buildAnalyticsPorts(deps)` → `analyticsRollups` (PROP-102).
|
|
19
|
+
*
|
|
20
|
+
* Все доменные порты реализованы поверх SQL; FS/package-bound порты (`skills`,
|
|
21
|
+
* `contextFiles`, `blobs`) — **файловые реализации** core (контент скиллов/
|
|
22
|
+
* prompts-ролей и blob-дерево остаются на диске; ADR-091/ADR-092: ФС-периметр
|
|
23
|
+
* вне портов).
|
|
24
|
+
*
|
|
25
|
+
* Осознанное исключение: драйвер в этой части **импортирует core рантаймом**
|
|
26
|
+
* (`createFileStorage`), чтобы переиспользовать уже проверенные файловые
|
|
27
|
+
* реализации, а не дублировать их. Для портов БД core по-прежнему не тянется:
|
|
28
|
+
* порты подключаются динамическим `import()` из core по `storage.backend`.
|
|
29
|
+
*/
|
|
30
|
+
import { createFileStorage } from '@itphx/synth-core';
|
|
31
|
+
import { latestSchemaVersion, MIGRATIONS } from './migrations/index.js';
|
|
32
|
+
import { planMigrations, readSchemaVersion, runMigrations } from './migrate.js';
|
|
33
|
+
import { buildContentPorts } from './ports/content.js';
|
|
34
|
+
import { buildAuditPorts } from './ports/audit.js';
|
|
35
|
+
import { buildAnalyticsPorts } from './ports/analytics.js';
|
|
36
|
+
import { buildEventPorts } from './ports/events.js';
|
|
37
|
+
import { buildPrincipalPorts } from './ports/principals.js';
|
|
38
|
+
import { buildSessionPorts } from './ports/sessions.js';
|
|
39
|
+
import { createPostgresLocks } from './locks.js';
|
|
40
|
+
/** Собрать `StorageContext`: четыре группы портов + файловые FS-порты + `close`. */
|
|
41
|
+
export function buildPostgresStorageContext(opts) {
|
|
42
|
+
// Файловый контекст переиспользуется только для FS/package-bound портов
|
|
43
|
+
// (`skills`/`contextFiles`/`blobs`); прочие его порты не задействованы.
|
|
44
|
+
const file = createFileStorage({
|
|
45
|
+
dataDir: opts.dataDir,
|
|
46
|
+
secretKey: opts.secretKey,
|
|
47
|
+
env: opts.env,
|
|
48
|
+
systemDictionariesDir: opts.systemDictionariesDir,
|
|
49
|
+
contextUserDataDir: opts.contextUserDataDir,
|
|
50
|
+
});
|
|
51
|
+
const background = [];
|
|
52
|
+
const deps = {
|
|
53
|
+
connection: opts.connection,
|
|
54
|
+
dataDir: opts.dataDir,
|
|
55
|
+
secretKey: opts.secretKey,
|
|
56
|
+
env: opts.env,
|
|
57
|
+
systemDictionariesDir: opts.systemDictionariesDir,
|
|
58
|
+
contextUserDataDir: opts.contextUserDataDir,
|
|
59
|
+
coreSync: opts.coreSync,
|
|
60
|
+
// Фоновые задачи сборки (best-effort прогрев кэшей `content`) — дожидаемся
|
|
61
|
+
// их в `close()` до закрытия пула, иначе warm-запросы падают с «пул недоступен».
|
|
62
|
+
trackBackground: (task) => background.push(task),
|
|
63
|
+
};
|
|
64
|
+
return {
|
|
65
|
+
kind: 'postgres',
|
|
66
|
+
// PROP-032: соединение живёт в контексте; `close()` закрывает пул (graceful
|
|
67
|
+
// shutdown домена). Перед закрытием дожидаемся фоновых задач сборки
|
|
68
|
+
// (best-effort прогрев синхронных кэшей `content`): warm-запросы не должны
|
|
69
|
+
// попадать в уже закрытый пул — иначе диагностика/`backup`/`migrate` видят
|
|
70
|
+
// ложные предупреждения «прогрев порта не удался: пул недоступен».
|
|
71
|
+
close: async () => {
|
|
72
|
+
await Promise.allSettled(background);
|
|
73
|
+
await opts.connection.end();
|
|
74
|
+
},
|
|
75
|
+
// PROP-032/ADR-091: диагностика backend'а — реальный probe БД + версия схемы
|
|
76
|
+
// (read-only, без применения миграций) для `synth doctor`/admin-API.
|
|
77
|
+
health: async () => {
|
|
78
|
+
const started = Date.now();
|
|
79
|
+
try {
|
|
80
|
+
await opts.connection.query('SELECT 1');
|
|
81
|
+
const schemaVersion = await readSchemaVersion(opts.connection, opts.connection.schema);
|
|
82
|
+
return {
|
|
83
|
+
ok: true,
|
|
84
|
+
latencyMs: Date.now() - started,
|
|
85
|
+
schemaVersion,
|
|
86
|
+
expectedSchemaVersion: latestSchemaVersion(MIGRATIONS),
|
|
87
|
+
};
|
|
88
|
+
}
|
|
89
|
+
catch (err) {
|
|
90
|
+
return {
|
|
91
|
+
ok: false,
|
|
92
|
+
latencyMs: Date.now() - started,
|
|
93
|
+
error: err instanceof Error ? err.message : String(err),
|
|
94
|
+
};
|
|
95
|
+
}
|
|
96
|
+
},
|
|
97
|
+
// PROP-032/ADR-092: миграции схемы БД — план (`dryRun`) или применение
|
|
98
|
+
// (лок/транзакции берёт `runMigrations`).
|
|
99
|
+
schemaMigrations: async (migrationOpts) => {
|
|
100
|
+
if (migrationOpts?.dryRun) {
|
|
101
|
+
const plan = await planMigrations(opts.connection, { schema: opts.connection.schema });
|
|
102
|
+
return { ...plan, applied: [] };
|
|
103
|
+
}
|
|
104
|
+
const result = await runMigrations(opts.connection, { schema: opts.connection.schema });
|
|
105
|
+
return {
|
|
106
|
+
current: result.version,
|
|
107
|
+
expected: result.version,
|
|
108
|
+
pending: [],
|
|
109
|
+
applied: result.applied,
|
|
110
|
+
};
|
|
111
|
+
},
|
|
112
|
+
// PROP-032: удаление схемы БД — только по явному `uninstall --purge-db`.
|
|
113
|
+
purgeSchema: () => opts.connection.dropSchema(),
|
|
114
|
+
// PROP-032: примитивы координации БД (advisory-локи) — composition root
|
|
115
|
+
// подставляет их вместо файловых `FileMutex`/`FileLeader`.
|
|
116
|
+
locks: createPostgresLocks(opts.connection),
|
|
117
|
+
...buildSessionPorts(deps),
|
|
118
|
+
...buildPrincipalPorts(deps),
|
|
119
|
+
...buildEventPorts(deps),
|
|
120
|
+
...buildContentPorts(deps),
|
|
121
|
+
...buildAuditPorts(deps),
|
|
122
|
+
// PROP-102: порт роллапов аналитики — пред-агрегированные суточные бакеты
|
|
123
|
+
// (`analytics_rollups`, миграция 003) с атомарным `ON CONFLICT … DO UPDATE`.
|
|
124
|
+
...buildAnalyticsPorts(deps),
|
|
125
|
+
// FS/package-bound порты: остаются файловыми (см. шапку модуля).
|
|
126
|
+
skills: file.skills,
|
|
127
|
+
contextFiles: file.contextFiles,
|
|
128
|
+
blobs: file.blobs,
|
|
129
|
+
};
|
|
130
|
+
}
|
package/package.json
CHANGED
|
@@ -1,6 +1,43 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@itphx/synth-storage-postgres",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"
|
|
5
|
-
"
|
|
3
|
+
"version": "0.11.3",
|
|
4
|
+
"license": "MIT",
|
|
5
|
+
"type": "module",
|
|
6
|
+
"main": "./dist/index.js",
|
|
7
|
+
"types": "./dist/index.d.ts",
|
|
8
|
+
"files": [
|
|
9
|
+
"dist"
|
|
10
|
+
],
|
|
11
|
+
"exports": {
|
|
12
|
+
".": {
|
|
13
|
+
"types": "./dist/index.d.ts",
|
|
14
|
+
"import": "./dist/index.js"
|
|
15
|
+
}
|
|
16
|
+
},
|
|
17
|
+
"dependencies": {
|
|
18
|
+
"@itphx/synth-shared": "0.11.3"
|
|
19
|
+
},
|
|
20
|
+
"peerDependencies": {
|
|
21
|
+
"@itphx/synth-core": "0.11.3"
|
|
22
|
+
},
|
|
23
|
+
"devDependencies": {
|
|
24
|
+
"@itphx/synth-core": "0.11.3",
|
|
25
|
+
"@types/node": "^22.0.0",
|
|
26
|
+
"@types/pg": "^8.15.0",
|
|
27
|
+
"typescript": "^5.8.0"
|
|
28
|
+
},
|
|
29
|
+
"optionalDependencies": {
|
|
30
|
+
"pg": "^8.13.0"
|
|
31
|
+
},
|
|
32
|
+
"engines": {
|
|
33
|
+
"node": ">=22.0.0"
|
|
34
|
+
},
|
|
35
|
+
"scripts": {
|
|
36
|
+
"build": "rm -rf dist && tsc -p tsconfig.build.json",
|
|
37
|
+
"typecheck": "tsc --noEmit",
|
|
38
|
+
"lint": "eslint src/",
|
|
39
|
+
"test": "vitest run",
|
|
40
|
+
"test:watch": "vitest",
|
|
41
|
+
"clean": "rm -rf dist"
|
|
42
|
+
}
|
|
6
43
|
}
|
package/README.md
DELETED