@ykurilov/agent-chat-core 0.57.0 → 0.58.0

package/dist/types/storage/postgres-migrations.d.ts

@@ -0,0 +1,28 @@
+/** Соединение PostgreSQL, которое нужно помощнику миграций. Подходит `PoolClient` из `pg`: core от `pg` не зависит. */
+export interface PostgresMigrationConnection {
+    query(text: string, values?: unknown[]): Promise<{
+        rows: unknown[];
+    }>;
+    release(): void;
+}
+export interface PostgresMigrationOptions<Connection extends PostgresMigrationConnection> {
+    /** Новое соединение из пула, например `() => pool.connect()`; на каждую попытку — своё. */
+    connect(): Promise<Connection>;
+    /** Своя блокировка пакета: одновременно мигрирует только одна копия этого пакета. */
+    lockKey: number;
+    /** Миграции пакета на этом соединении, например `migrate(drizzle(connection), …)`. */
+    migrate(connection: Connection): Promise<void>;
+    /** Паузы перед повторами, если всё же столкнулись с соседом. */
+    retryDelaysMs?: readonly number[];
+}
+/** Схема всех пакетов SDK. */
+export declare const AGENT_CHAT_SCHEMA = "agent_chat";
+/** Общая блокировка на создание схемы: одна на все пакеты, держится только на `create schema`. */
+export declare const AGENT_CHAT_SCHEMA_LOCK_KEY = 7311900441;
+/**
+ * Создаёт схему `agent_chat` и применяет миграции пакета так, чтобы пакеты могли стартовать одновременно на пустой базе.
+ * Схема создаётся под общей блокировкой, затем она отпускается и берётся своя блокировка пакета: блокировки не
+ * вложены, поэтому взаимной блокировки нет, а разные пакеты ждут друг друга только на создании схемы.
+ * Столкнулись всё же («уже есть») — повтор с начала на новом соединении.
+ */
+export declare function migratePostgresSchema<Connection extends PostgresMigrationConnection>(options: PostgresMigrationOptions<Connection>): Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ykurilov/agent-chat-core",
-  "version": "0.57.0",
+  "version": "0.58.0",
   "license": "MIT",
   "type": "module",
   "sideEffects": false,