@coopenomics/extension-kit 2026.9.24-2 → 2026.9.30

package/dist/index.cjs

@@ -1086,7 +1086,9 @@ __decorateClass$7([
   graphql.Field(() => String, {
     description: '\u041D\u0430\u043F\u0440\u0430\u0432\u043B\u0435\u043D\u0438\u0435 \u0441\u043E\u0440\u0442\u0438\u0440\u043E\u0432\u043A\u0438 ("ASC" \u0438\u043B\u0438 "DESC")',
     defaultValue: "ASC"
-  })
+  }),
+  classValidator.IsOptional(),
+  classValidator.IsIn(["ASC", "DESC"], { message: validationMessage("kit.pagination.invalidSortOrder") })
 ], exports.PaginationInputDTO.prototype, "sortOrder", 2);
 exports.PaginationInputDTO = __decorateClass$7([
   graphql.InputType("PaginationInput")
@@ -1154,16 +1156,16 @@ class PaginationUtils {
   static validatePaginationOptions(options) {
     const { page = 1, limit = 10, sortBy, sortOrder = "ASC" } = options;
     if (page < 1) {
-      throw DomainError.internal("KIT_PAGE_NUMBER_INVALID");
+      throw DomainError.badRequest("KIT_PAGE_NUMBER_INVALID");
     }
     if (limit < 1 || limit > 1e3) {
-      throw DomainError.internal("KIT_PAGE_LIMIT_INVALID");
+      throw DomainError.badRequest("KIT_PAGE_LIMIT_INVALID");
     }
     if (sortOrder !== "ASC" && sortOrder !== "DESC") {
-      throw DomainError.internal("KIT_SORT_ORDER_INVALID");
+      throw DomainError.badRequest("KIT_SORT_ORDER_INVALID");
     }
     if (sortBy !== void 0 && sortBy !== null && !SORT_FIELD_PATTERN.test(sortBy)) {
-      throw DomainError.internal("KIT_SORT_FIELD_INVALID");
+      throw DomainError.badRequest("KIT_SORT_FIELD_INVALID");
     }
     return {
       page,
@@ -1533,7 +1535,7 @@ class CurrencyValidationUtil {
   static validateCurrencySymbol(amount, fieldName = server.t("kit.currency.defaultFieldName")) {
     if (!this.hasValidCurrencySymbol(amount)) {
       const expectedSymbol = platformSettings().blockchain.rootGovernSymbol;
-      throw DomainError.internal("KIT_CURRENCY_SYMBOL_INVALID", { fieldName, expectedSymbol });
+      throw DomainError.badRequest("KIT_CURRENCY_SYMBOL_INVALID", { fieldName, expectedSymbol });
     }
   }
   /**
@@ -1564,12 +1566,13 @@ class CurrencyValidationUtil {
   /**
    * Форматирует сумму с правильным символом валюты
    * @param value Числовое значение
-   * @param precision Количество знаков после запятой (по умолчанию из конфига)
+   * @param precision Количество знаков после запятой (по умолчанию из настроек платформы)
    * @returns string - отформатированная сумма
    */
   static formatAmount(value, precision) {
-    const actualPrecision = precision ?? config.blockchain.root_govern_precision;
-    const symbol = platformSettings().blockchain.rootGovernSymbol;
+    const { rootGovernPrecision, rootGovernSymbol } = platformSettings().blockchain;
+    const actualPrecision = precision ?? rootGovernPrecision;
+    const symbol = rootGovernSymbol;
     return `${value.toFixed(actualPrecision)} ${symbol}`;
   }
 }
@@ -1677,12 +1680,12 @@ exports.DomainToBlockchainUtils = class DomainToBlockchainUtils {
   formatQuantityWithPrecision(quantity) {
     const parts = quantity.split(" ");
     if (parts.length !== 2) {
-      throw DomainError.internal("KIT_QUANTITY_FORMAT_INVALID", { quantity });
+      throw DomainError.badRequest("KIT_QUANTITY_FORMAT_INVALID", { quantity });
     }
     const [amount, symbol] = parts;
     const numericAmount = parseFloat(amount);
     if (isNaN(numericAmount)) {
-      throw DomainError.internal("KIT_QUANTITY_AMOUNT_INVALID", { amount });
+      throw DomainError.badRequest("KIT_QUANTITY_AMOUNT_INVALID", { amount });
     }
     const { rootSymbol, rootPrecision, rootGovernSymbol, rootGovernPrecision } = platformSettings().blockchain;
     let precision;
@@ -1691,7 +1694,7 @@ exports.DomainToBlockchainUtils = class DomainToBlockchainUtils {
     } else if (symbol === rootGovernSymbol) {
       precision = rootGovernPrecision;
     } else {
-      throw DomainError.internal("KIT_SYMBOL_UNSUPPORTED", { symbol, rootSymbol, rootGovernSymbol });
+      throw DomainError.badRequest("KIT_SYMBOL_UNSUPPORTED", { symbol, rootSymbol, rootGovernSymbol });
     }
     return `${numericAmount.toFixed(precision)} ${symbol}`;
   }
@@ -1699,10 +1702,10 @@ exports.DomainToBlockchainUtils = class DomainToBlockchainUtils {
   formatNumericStringToAssetString(numericString, precision, symbol) {
     const numericValue = parseFloat(numericString);
     if (isNaN(numericValue)) {
-      throw DomainError.internal("KIT_NUMBER_INVALID", { value: numericString });
+      throw DomainError.badRequest("KIT_NUMBER_INVALID", { value: numericString });
     }
     if (numericValue < 0) {
-      throw DomainError.internal("KIT_NUMBER_NEGATIVE", { value: numericString });
+      throw DomainError.badRequest("KIT_NUMBER_NEGATIVE", { value: numericString });
     }
     return `${numericValue.toFixed(precision)} ${symbol}`;
   }
@@ -1733,7 +1736,7 @@ exports.DomainToBlockchainUtils = __decorateClass([
   common.Injectable()
 ], exports.DomainToBlockchainUtils);
 
-const DIGEST_RE = /^[0-9a-f]{64}$/;
+const DIGEST_RE = /^[0-9a-f]{64}$/i;
 function chainTextDigest(text) {
   if (!text)
     return "";
@@ -1742,6 +1745,9 @@ function chainTextDigest(text) {
 function isChainTextDigest(value) {
   return typeof value === "string" && DIGEST_RE.test(value);
 }
+function isChainTextOf(text, chainValue) {
+  return chainTextDigest(text) === (chainValue ?? "").toLowerCase();
+}
 function resolveChainText(chainValue, current) {
   return isChainTextDigest(chainValue) ? current ?? "" : chainValue;
 }
@@ -1832,17 +1838,17 @@ class AmountFormatterUtils {
    */
   static formatAmount(amountStr) {
     if (!amountStr || typeof amountStr !== "string") {
-      throw DomainError.internal("KIT_AMOUNT_FORMAT_INVALID", { amount: amountStr });
+      throw DomainError.badRequest("KIT_AMOUNT_FORMAT_INVALID", { amount: amountStr });
     }
     const parts = amountStr.trim().split(/\s+/);
     if (parts.length < 1 || !parts[0]) {
-      throw DomainError.internal("KIT_AMOUNT_FORMAT_INVALID", { amount: amountStr });
+      throw DomainError.badRequest("KIT_AMOUNT_FORMAT_INVALID", { amount: amountStr });
     }
     const amountPart = parts[0].replace(",", ".");
     const currency = parts.length >= 2 ? parts.slice(1).join(" ") : "";
     const amount = parseFloat(amountPart);
     if (isNaN(amount)) {
-      throw DomainError.internal("KIT_AMOUNT_NUMBER_INVALID", { value: parts[0] });
+      throw DomainError.badRequest("KIT_AMOUNT_NUMBER_INVALID", { value: parts[0] });
     }
     const formattedAmount = amount.toLocaleString("ru-RU", {
       minimumFractionDigits: 2,
@@ -1918,7 +1924,7 @@ class QuantityUtils {
     } else if (symbol === rootGovernSymbol) {
       return rootGovernPrecision;
     } else {
-      throw DomainError.internal("KIT_SYMBOL_UNSUPPORTED", { symbol, rootSymbol, rootGovernSymbol });
+      throw DomainError.badRequest("KIT_SYMBOL_UNSUPPORTED", { symbol, rootSymbol, rootGovernSymbol });
     }
   }
   /**
@@ -1928,7 +1934,7 @@ class QuantityUtils {
   static validateSymbol(symbol) {
     if (!this.isSupportedSymbol(symbol)) {
       const { rootSymbol, rootGovernSymbol } = platformSettings().blockchain;
-      throw DomainError.internal("KIT_SYMBOL_UNSUPPORTED", { symbol, rootSymbol, rootGovernSymbol });
+      throw DomainError.badRequest("KIT_SYMBOL_UNSUPPORTED", { symbol, rootSymbol, rootGovernSymbol });
     }
   }
   /**
@@ -1940,7 +1946,7 @@ class QuantityUtils {
   static formatQuantityForBlockchain(amount, symbol) {
     this.validateSymbol(symbol);
     if (isNaN(amount) || amount < 0) {
-      throw DomainError.internal("KIT_NUMBER_INVALID", { value: amount });
+      throw DomainError.badRequest("KIT_NUMBER_INVALID", { value: amount });
     }
     const precision = this.getPrecisionForSymbol(symbol);
     const formattedAmount = amount.toFixed(precision);
@@ -1955,7 +1961,7 @@ class QuantityUtils {
   static combineQuantityAndSymbol(amount, symbol) {
     this.validateSymbol(symbol);
     if (isNaN(amount) || amount < 0) {
-      throw DomainError.internal("KIT_NUMBER_INVALID", { value: amount });
+      throw DomainError.badRequest("KIT_NUMBER_INVALID", { value: amount });
     }
     return `${amount} ${symbol}`;
   }
@@ -1967,12 +1973,12 @@ class QuantityUtils {
   static parseQuantityString(quantity) {
     const parts = quantity.split(" ");
     if (parts.length !== 2) {
-      throw DomainError.internal("KIT_QUANTITY_FORMAT_INVALID", { quantity });
+      throw DomainError.badRequest("KIT_QUANTITY_FORMAT_INVALID", { quantity });
     }
     const [amountStr, symbol] = parts;
     const amount = parseFloat(amountStr);
     if (isNaN(amount)) {
-      throw DomainError.internal("KIT_QUANTITY_AMOUNT_INVALID", { amount: amountStr });
+      throw DomainError.badRequest("KIT_QUANTITY_AMOUNT_INVALID", { amount: amountStr });
     }
     this.validateSymbol(symbol);
     return { amount, symbol };
@@ -2093,6 +2099,79 @@ function resolveSortColumn(repository, sortBy, fallback) {
   return isKnownColumn ? sortBy : fallback;
 }
 
+class LocalChangesCollector {
+  constructor(isWatched, publish) {
+    this.isWatched = isWatched;
+    this.publish = publish;
+    this.pending = /* @__PURE__ */ new WeakMap();
+  }
+  afterInsert(event) {
+    this.collect(event.metadata, event.queryRunner, event.entity);
+  }
+  afterUpdate(event) {
+    this.collect(event.metadata, event.queryRunner, { ...event.databaseEntity ?? {}, ...event.entity ?? {} });
+  }
+  afterRemove(event) {
+    const row = event.databaseEntity ?? event.entity;
+    this.collect(event.metadata, event.queryRunner, row, event.entityId);
+  }
+  afterTransactionCommit(event) {
+    const changes = this.pending.get(event.queryRunner);
+    if (!changes)
+      return;
+    this.pending.delete(event.queryRunner);
+    changes.forEach((c) => void this.publish(c.table, c.primary_key, c.row));
+  }
+  afterTransactionRollback(event) {
+    this.pending.delete(event.queryRunner);
+  }
+  collect(metadata, queryRunner, row, entityId) {
+    const table = metadata.tableName;
+    if (!this.isWatched(table))
+      return;
+    const change = { table, primary_key: primaryKeyOf(metadata, row, entityId), row };
+    if (queryRunner?.isTransactionActive) {
+      const list = this.pending.get(queryRunner) ?? [];
+      list.push(change);
+      this.pending.set(queryRunner, list);
+      return;
+    }
+    void this.publish(change.table, change.primary_key, change.row);
+  }
+}
+function primaryKeyOf(metadata, row, entityId) {
+  if (row) {
+    const ids = metadata.primaryColumns.map((c) => c.getEntityValue(row)).filter((v) => v !== void 0 && v !== null);
+    if (ids.length)
+      return ids.map(String).join(":");
+  }
+  if (entityId !== void 0 && entityId !== null) {
+    return typeof entityId === "object" ? Object.values(entityId).map(String).join(":") : String(entityId);
+  }
+  return "";
+}
+
+const numericColumnTransformer = {
+  to: (value) => value,
+  from: (value) => value === null || value === void 0 ? value : Number(value)
+};
+
+function SafeMarkup(validationOptions) {
+  return function(object, propertyName) {
+    classValidator.registerDecorator({
+      name: "safeMarkup",
+      target: object.constructor,
+      propertyName,
+      options: { message: validationMessage("kit.markup.executable"), ...validationOptions },
+      validator: {
+        validate(value) {
+          return typeof value !== "string" || !cooptypes._Common.Text.hasExecutableMarkup(value);
+        }
+      }
+    });
+  };
+}
+
 class HttpApiError extends common.HttpException {
   constructor(statusCode, message, isOperational = true, stack, subcode) {
     super(message, statusCode);
@@ -2108,6 +2187,7 @@ class HttpApiError extends common.HttpException {
 
 const ASSERT_PREFIX = /assertion failure with message: (.+?)(?:\n|$)/;
 const CODED = /^([A-Z][A-Z0-9]*(?:_[A-Z0-9]+)+):\s*(.*)$/s;
+const ENCODING = /^Encoding error at root<[^>]*>((?:\.[^.<:]+<[^>]*>)*):/;
 function parseChainAssert(message) {
   const assert = message.match(ASSERT_PREFIX);
   const body = (assert ? assert[1] : message).trim();
@@ -2123,7 +2203,23 @@ function chainErrorCode(error) {
   const raw = error?.message ?? String(error);
   return parseChainAssert(raw).code;
 }
+function chainRefusalOf(error) {
+  if (error instanceof DomainError)
+    return error;
+  const raw = error?.message ?? String(error);
+  const encoding = raw.match(ENCODING);
+  if (encoding) {
+    const field = encoding[1].split(".").filter(Boolean).map((part) => part.replace(/<[^>]*>$/, "")).join(".");
+    return DomainError.badRequest("CHAIN_ACTION_ARGUMENT_INVALID", { field });
+  }
+  if (!ASSERT_PREFIX.test(raw))
+    return null;
+  const { code, text } = parseChainAssert(raw);
+  return DomainError.badRequest(code ?? "CHAIN_ASSERT", { message: text });
+}
 function rethrowChainError(error) {
+  if (error instanceof DomainError)
+    throw error;
   const raw = error?.message ?? String(error);
   const match = raw.match(ASSERT_PREFIX);
   if (!match)
@@ -2154,6 +2250,7 @@ exports.HttpApiError = HttpApiError;
 exports.InjectBucket = InjectBucket;
 exports.LOG_EXTENSION_REPOSITORY = LOG_EXTENSION_REPOSITORY;
 exports.LangType = LangType;
+exports.LocalChangesCollector = LocalChangesCollector;
 exports.LogExtensionDomainEntity = LogExtensionDomainEntity;
 exports.ONBOARDING_EXPIRY_DAYS = ONBOARDING_EXPIRY_DAYS;
 exports.ONBOARDING_EXPIRY_MS = ONBOARDING_EXPIRY_MS;
@@ -2164,11 +2261,13 @@ exports.QuantityUtils = QuantityUtils;
 exports.ROLES_ANY_STATUS_KEY = ROLES_ANY_STATUS_KEY;
 exports.ROLES_DENY_SELF_KEY = ROLES_DENY_SELF_KEY;
 exports.SORT_FIELD_PATTERN = SORT_FIELD_PATTERN;
+exports.SafeMarkup = SafeMarkup;
 exports.UseBucket = UseBucket;
 exports.bucketProvidersFor = bucketProvidersFor;
 exports.bucketTokenFor = bucketTokenFor;
 exports.buildPaginationResult = buildPaginationResult;
 exports.chainErrorCode = chainErrorCode;
+exports.chainRefusalOf = chainRefusalOf;
 exports.chainTextDigest = chainTextDigest;
 exports.checkPaymentAmount = checkPaymentAmount;
 exports.checkPaymentSymbol = checkPaymentSymbol;
@@ -2186,8 +2285,10 @@ exports.getAmountPlusFee = getAmountPlusFee;
 exports.getAppliedBlockNum = getAppliedBlockNum;
 exports.hasServerSecret = hasServerSecret;
 exports.isChainTextDigest = isChainTextDigest;
+exports.isChainTextOf = isChainTextOf;
 exports.isExtensionAvailable = isExtensionAvailable;
 exports.mergeSecretConfig = mergeSecretConfig;
+exports.numericColumnTransformer = numericColumnTransformer;
 exports.paginationInputToOffset = paginationInputToOffset;
 exports.parseChainAssert = parseChainAssert;
 exports.platformSettings = platformSettings;

package/dist/index.d.cts

@@ -5,7 +5,8 @@ import { Reflector } from '@nestjs/core';
 import { Observable } from 'rxjs';
 import { ZodObject } from 'zod';
 import { Cooperative } from 'cooptypes';
-import { MigrationInterface, ObjectLiteral, Repository } from 'typeorm';
+import { MigrationInterface, ObjectLiteral, Repository, EntitySubscriberInterface, InsertEvent, UpdateEvent, RemoveEvent, TransactionCommitEvent, TransactionRollbackEvent, ValueTransformer } from 'typeorm';
+import { ValidationOptions } from 'class-validator';
 
 /**
  * Пути внутри объекта, по которым пайщик признаётся «своим» для поля.
@@ -1320,6 +1321,8 @@ declare class DomainToBlockchainUtils {
 declare function chainTextDigest(text: string | null | undefined): string;
 /** Значение из цепи — хеш текста, а не сам текст. */
 declare function isChainTextDigest(value: string | null | undefined): value is string;
+/** Хеш в цепи — хеш именно этого текста (регистр хеша не важен). */
+declare function isChainTextOf(text: string | null | undefined, chainValue: string | null | undefined): boolean;
 /**
  * Значение поля из цепи для записи в базу: хеш текст в базе не заменяет.
  * Строки, записанные до выноса текстов, несут сам текст и копируются как раньше.
@@ -1596,7 +1599,7 @@ declare class CurrencyValidationUtil {
     /**
      * Форматирует сумму с правильным символом валюты
      * @param value Числовое значение
-     * @param precision Количество знаков после запятой (по умолчанию из конфига)
+     * @param precision Количество знаков после запятой (по умолчанию из настроек платформы)
      * @returns string - отформатированная сумма
      */
     static formatAmount(value: number, precision?: number): string;
@@ -1631,6 +1634,58 @@ declare function sanitizeUserText<T extends string | null | undefined>(value: T)
  */
 declare function resolveSortColumn<T extends ObjectLiteral>(repository: Repository<T>, sortBy: string | undefined, fallback: string): string;
 
+/** Публикация сигнала ленты изменений: таблица базы, ключ строки, строка. */
+type LocalChangePublisher = (table: string, primary_key: string, row: Record<string, unknown> | undefined) => unknown;
+/**
+ * Сигналы ленты изменений для данных узла вне цепи — общая часть подписчика
+ * TypeORM для ядра и расширений со своей базой.
+ *
+ * Любая запись в наблюдаемую таблицу — через репозиторий, менеджер или
+ * построитель запросов — порождает сигнал «перечитай». Сигнал уходит после
+ * фиксации транзакции: стол по нему читает уже записанное, а откаченная запись
+ * сигнала не даёт. Сырой `query()` подписчик не видит — такую запись
+ * публикует сам её автор.
+ *
+ * Из `typeorm` здесь только типы: метаданные и события приходят от источника
+ * данных вызывающей стороны.
+ */
+declare class LocalChangesCollector implements EntitySubscriberInterface {
+    private readonly isWatched;
+    private readonly publish;
+    private readonly pending;
+    constructor(isWatched: (table: string) => boolean, publish: LocalChangePublisher);
+    afterInsert(event: InsertEvent<any>): void;
+    afterUpdate(event: UpdateEvent<any>): void;
+    afterRemove(event: RemoveEvent<any>): void;
+    afterTransactionCommit(event: TransactionCommitEvent): void;
+    afterTransactionRollback(event: TransactionRollbackEvent): void;
+    private collect;
+}
+
+/**
+ * Трансформер колонок `numeric`, которые в домене — число: Postgres отдаёт
+ * numeric строкой, а сущности и арифметика работают с `number`. Годится для
+ * количеств (0.5 кг) и сумм, которые домен держит числом (сумма платежа);
+ * денежные поля, которые домен держит строкой актива, его не используют.
+ *
+ * Один экземпляр на ядро и расширения — из пакета (из typeorm здесь только тип).
+ */
+declare const numericColumnTransformer: ValueTransformer;
+
+/**
+ * Текст, который уходит в подписываемый документ (повестка собрания, проект
+ * решения совета), без исполняемой разметки.
+ *
+ * Вёрстка допускается: проекты решений на утверждение совета несут абзацы,
+ * таблицы и стили документа. Отклоняются только скрипты, встраиваемые рамки и
+ * объекты, формы, обработчики событий и опасные ссылки — правило одно с
+ * очисткой редактора (`_Common.Text.hasExecutableMarkup` в cooptypes).
+ *
+ * Отказ, а не очистка: документ подписывается по хэшу, и переписанный текст
+ * был бы не тем, что ввёл человек (решение владельца 25.09.2026, C28-80).
+ */
+declare function SafeMarkup(validationOptions?: ValidationOptions): (object: object, propertyName: string) => void;
+
 /**
  * Ошибка API с кодом состояния HTTP.
  *
@@ -1647,35 +1702,6 @@ declare class HttpApiError extends HttpException {
     constructor(statusCode: HttpStatus, message: string, isOperational?: boolean, stack?: string, subcode?: any);
 }
 
-/**
- * Разбор отказа контракта. Контракт пишет причину как `КОД: текст`
- * (`GATEWAY_OUTCOME_NOT_FOUND: Объект возврата не существует…`); старые
- * отказы — одним текстом, без кода.
- */
-declare function parseChainAssert(message: string): {
-    code?: string;
-    text: string;
-};
-/**
- * Код отказа контракта — из DomainError, в который отказ уже превращён,
- * или из сырой ошибки цепи. Отказ без кода — undefined. Сравнивать отказы
- * контракта — по этому коду, а не по тексту: текст переводится и правится.
- */
-declare function chainErrorCode(error: unknown): string | undefined;
-/**
- * Пробросить отказ цепи человеку.
- *
- * `eosio::check` возвращает сообщение обёрнутым в `assertion failure with
- * message: ...`; пайщику нужна причина, а не обёртка виртуальной машины.
- * Живёт в каркасе, потому что в цепь ходит не одно расширение: вторая копия
- * этой чистки разошлась бы с первой на первом же новом формате ошибки.
- *
- * Отказ с кодом (`КОД: текст`) уходит с этим кодом, текст — из словаря,
- * а без записи в словаре — текст контракта. Отказ без кода — `CHAIN_ASSERT`,
- * прочий сбой цепи — `CHAIN_ERROR`, текст — параметром `message`.
- */
-declare function rethrowChainError(error: unknown): never;
-
 type DomainErrorParams = Record<string, string | number | boolean | null | undefined>;
 interface Branded {
     code: string;
@@ -1733,5 +1759,43 @@ declare function validationMessage(key: string, params?: DomainErrorParams): (ar
     constraints?: unknown[];
 }) => string;
 
-export { ActiveUserStatusGuard, AmountFormatterUtils, AssetUtils, AuthRoles, BaseExtensionModule, BucketRegistry, CandidateFilterInputDTO, CandidateOutputDTO, CandidateStatus, CurrencyValidationUtil, CurrentUser, DEFAULT_DOCUMENT_VERSION, DateUtils, DocumentAggregateDTO, DomainError, DomainToBlockchainUtils, EMPTY_HASH, EXTENSION_APP_TERMINATE_EVENT, EXTENSION_REPOSITORY, EXTENSION_SECRET_SET, EXTENSION_SECRET_UNSET, ExpenseProposalStatementGenerateDocumentInputDTO, ExpenseProposalStatementSignedDocumentInputDTO, ExpenseProposalStatementSignedMetaDocumentInputDTO, ExtensionAvailability, ExtensionConfigSuppliedBy, ExtensionDomainEntity, GenerateDocumentInputDTO, GenerateDocumentOptionsInputDTO, GenerateMetaDocumentInputDTO, GeneratedDocumentDTO, GqlJwtAuthGuard, HttpApiError, HttpJwtAuthGuard, IPNProvider, InjectBucket, LOG_EXTENSION_REPOSITORY, LangType, LogExtensionDomainEntity, MetaDocumentInputDTO, ONBOARDING_EXPIRY_DAYS, ONBOARDING_EXPIRY_MS, OptionalCurrentUser, OptionalGqlJwtAuthGuard, PaginationInputDTO, PaginationResult, PaginationUtils, PaymentProvider, PollingProvider, QuantityUtils, ROLES_ANY_STATUS_KEY, ROLES_DENY_SELF_KEY, RolesGuard, SORT_FIELD_PATTERN, SignatureInfoDTO, SignatureInfoInputDTO, SignedDigitalDocumentDTO, SignedDigitalDocumentInputDTO, TransactionDTO, UseBucket, bucketProvidersFor, bucketTokenFor, buildPaginationResult, chainErrorCode, chainTextDigest, checkPaymentAmount, checkPaymentSymbol, computeOnboardingExpiresAt, configureExtensionAuth, configurePlatformSettings, createPaginationResult, domainErrorMessage, extensionDatabaseMigrations, extensionEntities, generateHashFromString, generateRandomHash, generateUniqueHash, getAmountPlusFee, getAppliedBlockNum, hasServerSecret, isChainTextDigest, isExtensionAvailable, mergeSecretConfig, paginationInputToOffset, parseChainAssert, platformSettings, providerSuppliedPaths, redactSecretConfig, registerExtensionDatabaseMigrations, registerExtensionEntities, resetExtensionDatabaseMigrations, resetExtensionEntities, resolveChainText, resolveSortColumn, rethrowChainError, sanitizeUserText, validationMessage, verifySignedDocumentAgainstStoredDraft, waitForEvent };
-export type { AuthRolesOptions, BucketSource, BucketSpec, DeserializedDescriptionOfExtension, DomainErrorParams, EventSource, EventWait, ExcludeCommonProps, ExtensionAppTerminatePayload, ExtensionAuthOptions, ExtensionConfigFieldPolicy, ExtensionConfigPolicy, ExtensionDatabaseMigrationClass, ExtensionDomainInterface, ExtensionDomainRepository, ExtensionEntityClass, ExtensionSchemaMigrationAfterContext, GeneratedDocumentDomainInterface, GeneratedDocumentDraft, IDesktopConfig, IExtensionSchemaMigration, IRegistryExtension, IResolvedRegistryExtension, LoadGeneratedDocumentByDocHash, LogExtensionDomainInterface, LogExtensionDomainRepository, LogExtensionFilter, LogExtensionPaginationOptions, LogExtensionPaginationResult, PaymentDetails, PlatformBlockchainSettings, PlatformSettings, RegisteredBucket, RequireFields, SignedDocumentMetaCompareMode, SignedDocumentMetaVerification, SignedDocumentToVerify, TransactResultWithResponse };
+/**
+ * Разбор отказа контракта. Контракт пишет причину как `КОД: текст`
+ * (`GATEWAY_OUTCOME_NOT_FOUND: Объект возврата не существует…`); старые
+ * отказы — одним текстом, без кода.
+ */
+declare function parseChainAssert(message: string): {
+    code?: string;
+    text: string;
+};
+/**
+ * Код отказа контракта — из DomainError, в который отказ уже превращён,
+ * или из сырой ошибки цепи. Отказ без кода — undefined. Сравнивать отказы
+ * контракта — по этому коду, а не по тексту: текст переводится и правится.
+ */
+declare function chainErrorCode(error: unknown): string | undefined;
+/**
+ * Отказ контракта (`eosio::check`) как отказ с кодом; иной сбой цепи — null.
+ *
+ * Отказ контракта — ответ на действие пайщика, а не сбой сервера. Клиент цепи
+ * (@wharfkit/session) превращает его в простой Error, и без перевода он уходил
+ * ответом 500 без кода — в журнал ошибок как поломка (C28-80). Переводит
+ * единственная отправка в цепь, поэтому код получают все мутации сразу.
+ */
+declare function chainRefusalOf(error: unknown): DomainError | null;
+/**
+ * Пробросить отказ цепи человеку.
+ *
+ * `eosio::check` возвращает сообщение обёрнутым в `assertion failure with
+ * message: ...`; пайщику нужна причина, а не обёртка виртуальной машины.
+ * Живёт в каркасе, потому что в цепь ходит не одно расширение: вторая копия
+ * этой чистки разошлась бы с первой на первом же новом формате ошибки.
+ *
+ * Отказ с кодом (`КОД: текст`) уходит с этим кодом, текст — из словаря,
+ * а без записи в словаре — текст контракта. Отказ без кода — `CHAIN_ASSERT`,
+ * прочий сбой цепи — `CHAIN_ERROR`, текст — параметром `message`.
+ */
+declare function rethrowChainError(error: unknown): never;
+
+export { ActiveUserStatusGuard, AmountFormatterUtils, AssetUtils, AuthRoles, BaseExtensionModule, BucketRegistry, CandidateFilterInputDTO, CandidateOutputDTO, CandidateStatus, CurrencyValidationUtil, CurrentUser, DEFAULT_DOCUMENT_VERSION, DateUtils, DocumentAggregateDTO, DomainError, DomainToBlockchainUtils, EMPTY_HASH, EXTENSION_APP_TERMINATE_EVENT, EXTENSION_REPOSITORY, EXTENSION_SECRET_SET, EXTENSION_SECRET_UNSET, ExpenseProposalStatementGenerateDocumentInputDTO, ExpenseProposalStatementSignedDocumentInputDTO, ExpenseProposalStatementSignedMetaDocumentInputDTO, ExtensionAvailability, ExtensionConfigSuppliedBy, ExtensionDomainEntity, GenerateDocumentInputDTO, GenerateDocumentOptionsInputDTO, GenerateMetaDocumentInputDTO, GeneratedDocumentDTO, GqlJwtAuthGuard, HttpApiError, HttpJwtAuthGuard, IPNProvider, InjectBucket, LOG_EXTENSION_REPOSITORY, LangType, LocalChangesCollector, LogExtensionDomainEntity, MetaDocumentInputDTO, ONBOARDING_EXPIRY_DAYS, ONBOARDING_EXPIRY_MS, OptionalCurrentUser, OptionalGqlJwtAuthGuard, PaginationInputDTO, PaginationResult, PaginationUtils, PaymentProvider, PollingProvider, QuantityUtils, ROLES_ANY_STATUS_KEY, ROLES_DENY_SELF_KEY, RolesGuard, SORT_FIELD_PATTERN, SafeMarkup, SignatureInfoDTO, SignatureInfoInputDTO, SignedDigitalDocumentDTO, SignedDigitalDocumentInputDTO, TransactionDTO, UseBucket, bucketProvidersFor, bucketTokenFor, buildPaginationResult, chainErrorCode, chainRefusalOf, chainTextDigest, checkPaymentAmount, checkPaymentSymbol, computeOnboardingExpiresAt, configureExtensionAuth, configurePlatformSettings, createPaginationResult, domainErrorMessage, extensionDatabaseMigrations, extensionEntities, generateHashFromString, generateRandomHash, generateUniqueHash, getAmountPlusFee, getAppliedBlockNum, hasServerSecret, isChainTextDigest, isChainTextOf, isExtensionAvailable, mergeSecretConfig, numericColumnTransformer, paginationInputToOffset, parseChainAssert, platformSettings, providerSuppliedPaths, redactSecretConfig, registerExtensionDatabaseMigrations, registerExtensionEntities, resetExtensionDatabaseMigrations, resetExtensionEntities, resolveChainText, resolveSortColumn, rethrowChainError, sanitizeUserText, validationMessage, verifySignedDocumentAgainstStoredDraft, waitForEvent };
+export type { AuthRolesOptions, BucketSource, BucketSpec, DeserializedDescriptionOfExtension, DomainErrorParams, EventSource, EventWait, ExcludeCommonProps, ExtensionAppTerminatePayload, ExtensionAuthOptions, ExtensionConfigFieldPolicy, ExtensionConfigPolicy, ExtensionDatabaseMigrationClass, ExtensionDomainInterface, ExtensionDomainRepository, ExtensionEntityClass, ExtensionSchemaMigrationAfterContext, GeneratedDocumentDomainInterface, GeneratedDocumentDraft, IDesktopConfig, IExtensionSchemaMigration, IRegistryExtension, IResolvedRegistryExtension, LoadGeneratedDocumentByDocHash, LocalChangePublisher, LogExtensionDomainInterface, LogExtensionDomainRepository, LogExtensionFilter, LogExtensionPaginationOptions, LogExtensionPaginationResult, PaymentDetails, PlatformBlockchainSettings, PlatformSettings, RegisteredBucket, RequireFields, SignedDocumentMetaCompareMode, SignedDocumentMetaVerification, SignedDocumentToVerify, TransactResultWithResponse };

package/dist/index.d.mts

@@ -5,7 +5,8 @@ import { Reflector } from '@nestjs/core';
 import { Observable } from 'rxjs';
 import { ZodObject } from 'zod';
 import { Cooperative } from 'cooptypes';
-import { MigrationInterface, ObjectLiteral, Repository } from 'typeorm';
+import { MigrationInterface, ObjectLiteral, Repository, EntitySubscriberInterface, InsertEvent, UpdateEvent, RemoveEvent, TransactionCommitEvent, TransactionRollbackEvent, ValueTransformer } from 'typeorm';
+import { ValidationOptions } from 'class-validator';
 
 /**
  * Пути внутри объекта, по которым пайщик признаётся «своим» для поля.
@@ -1320,6 +1321,8 @@ declare class DomainToBlockchainUtils {
 declare function chainTextDigest(text: string | null | undefined): string;
 /** Значение из цепи — хеш текста, а не сам текст. */
 declare function isChainTextDigest(value: string | null | undefined): value is string;
+/** Хеш в цепи — хеш именно этого текста (регистр хеша не важен). */
+declare function isChainTextOf(text: string | null | undefined, chainValue: string | null | undefined): boolean;
 /**
  * Значение поля из цепи для записи в базу: хеш текст в базе не заменяет.
  * Строки, записанные до выноса текстов, несут сам текст и копируются как раньше.
@@ -1596,7 +1599,7 @@ declare class CurrencyValidationUtil {
     /**
      * Форматирует сумму с правильным символом валюты
      * @param value Числовое значение
-     * @param precision Количество знаков после запятой (по умолчанию из конфига)
+     * @param precision Количество знаков после запятой (по умолчанию из настроек платформы)
      * @returns string - отформатированная сумма
      */
     static formatAmount(value: number, precision?: number): string;
@@ -1631,6 +1634,58 @@ declare function sanitizeUserText<T extends string | null | undefined>(value: T)
  */
 declare function resolveSortColumn<T extends ObjectLiteral>(repository: Repository<T>, sortBy: string | undefined, fallback: string): string;
 
+/** Публикация сигнала ленты изменений: таблица базы, ключ строки, строка. */
+type LocalChangePublisher = (table: string, primary_key: string, row: Record<string, unknown> | undefined) => unknown;
+/**
+ * Сигналы ленты изменений для данных узла вне цепи — общая часть подписчика
+ * TypeORM для ядра и расширений со своей базой.
+ *
+ * Любая запись в наблюдаемую таблицу — через репозиторий, менеджер или
+ * построитель запросов — порождает сигнал «перечитай». Сигнал уходит после
+ * фиксации транзакции: стол по нему читает уже записанное, а откаченная запись
+ * сигнала не даёт. Сырой `query()` подписчик не видит — такую запись
+ * публикует сам её автор.
+ *
+ * Из `typeorm` здесь только типы: метаданные и события приходят от источника
+ * данных вызывающей стороны.
+ */
+declare class LocalChangesCollector implements EntitySubscriberInterface {
+    private readonly isWatched;
+    private readonly publish;
+    private readonly pending;
+    constructor(isWatched: (table: string) => boolean, publish: LocalChangePublisher);
+    afterInsert(event: InsertEvent<any>): void;
+    afterUpdate(event: UpdateEvent<any>): void;
+    afterRemove(event: RemoveEvent<any>): void;
+    afterTransactionCommit(event: TransactionCommitEvent): void;
+    afterTransactionRollback(event: TransactionRollbackEvent): void;
+    private collect;
+}
+
+/**
+ * Трансформер колонок `numeric`, которые в домене — число: Postgres отдаёт
+ * numeric строкой, а сущности и арифметика работают с `number`. Годится для
+ * количеств (0.5 кг) и сумм, которые домен держит числом (сумма платежа);
+ * денежные поля, которые домен держит строкой актива, его не используют.
+ *
+ * Один экземпляр на ядро и расширения — из пакета (из typeorm здесь только тип).
+ */
+declare const numericColumnTransformer: ValueTransformer;
+
+/**
+ * Текст, который уходит в подписываемый документ (повестка собрания, проект
+ * решения совета), без исполняемой разметки.
+ *
+ * Вёрстка допускается: проекты решений на утверждение совета несут абзацы,
+ * таблицы и стили документа. Отклоняются только скрипты, встраиваемые рамки и
+ * объекты, формы, обработчики событий и опасные ссылки — правило одно с
+ * очисткой редактора (`_Common.Text.hasExecutableMarkup` в cooptypes).
+ *
+ * Отказ, а не очистка: документ подписывается по хэшу, и переписанный текст
+ * был бы не тем, что ввёл человек (решение владельца 25.09.2026, C28-80).
+ */
+declare function SafeMarkup(validationOptions?: ValidationOptions): (object: object, propertyName: string) => void;
+
 /**
  * Ошибка API с кодом состояния HTTP.
  *
@@ -1647,35 +1702,6 @@ declare class HttpApiError extends HttpException {
     constructor(statusCode: HttpStatus, message: string, isOperational?: boolean, stack?: string, subcode?: any);
 }
 
-/**
- * Разбор отказа контракта. Контракт пишет причину как `КОД: текст`
- * (`GATEWAY_OUTCOME_NOT_FOUND: Объект возврата не существует…`); старые
- * отказы — одним текстом, без кода.
- */
-declare function parseChainAssert(message: string): {
-    code?: string;
-    text: string;
-};
-/**
- * Код отказа контракта — из DomainError, в который отказ уже превращён,
- * или из сырой ошибки цепи. Отказ без кода — undefined. Сравнивать отказы
- * контракта — по этому коду, а не по тексту: текст переводится и правится.
- */
-declare function chainErrorCode(error: unknown): string | undefined;
-/**
- * Пробросить отказ цепи человеку.
- *
- * `eosio::check` возвращает сообщение обёрнутым в `assertion failure with
- * message: ...`; пайщику нужна причина, а не обёртка виртуальной машины.
- * Живёт в каркасе, потому что в цепь ходит не одно расширение: вторая копия
- * этой чистки разошлась бы с первой на первом же новом формате ошибки.
- *
- * Отказ с кодом (`КОД: текст`) уходит с этим кодом, текст — из словаря,
- * а без записи в словаре — текст контракта. Отказ без кода — `CHAIN_ASSERT`,
- * прочий сбой цепи — `CHAIN_ERROR`, текст — параметром `message`.
- */
-declare function rethrowChainError(error: unknown): never;
-
 type DomainErrorParams = Record<string, string | number | boolean | null | undefined>;
 interface Branded {
     code: string;
@@ -1733,5 +1759,43 @@ declare function validationMessage(key: string, params?: DomainErrorParams): (ar
     constraints?: unknown[];
 }) => string;
 
-export { ActiveUserStatusGuard, AmountFormatterUtils, AssetUtils, AuthRoles, BaseExtensionModule, BucketRegistry, CandidateFilterInputDTO, CandidateOutputDTO, CandidateStatus, CurrencyValidationUtil, CurrentUser, DEFAULT_DOCUMENT_VERSION, DateUtils, DocumentAggregateDTO, DomainError, DomainToBlockchainUtils, EMPTY_HASH, EXTENSION_APP_TERMINATE_EVENT, EXTENSION_REPOSITORY, EXTENSION_SECRET_SET, EXTENSION_SECRET_UNSET, ExpenseProposalStatementGenerateDocumentInputDTO, ExpenseProposalStatementSignedDocumentInputDTO, ExpenseProposalStatementSignedMetaDocumentInputDTO, ExtensionAvailability, ExtensionConfigSuppliedBy, ExtensionDomainEntity, GenerateDocumentInputDTO, GenerateDocumentOptionsInputDTO, GenerateMetaDocumentInputDTO, GeneratedDocumentDTO, GqlJwtAuthGuard, HttpApiError, HttpJwtAuthGuard, IPNProvider, InjectBucket, LOG_EXTENSION_REPOSITORY, LangType, LogExtensionDomainEntity, MetaDocumentInputDTO, ONBOARDING_EXPIRY_DAYS, ONBOARDING_EXPIRY_MS, OptionalCurrentUser, OptionalGqlJwtAuthGuard, PaginationInputDTO, PaginationResult, PaginationUtils, PaymentProvider, PollingProvider, QuantityUtils, ROLES_ANY_STATUS_KEY, ROLES_DENY_SELF_KEY, RolesGuard, SORT_FIELD_PATTERN, SignatureInfoDTO, SignatureInfoInputDTO, SignedDigitalDocumentDTO, SignedDigitalDocumentInputDTO, TransactionDTO, UseBucket, bucketProvidersFor, bucketTokenFor, buildPaginationResult, chainErrorCode, chainTextDigest, checkPaymentAmount, checkPaymentSymbol, computeOnboardingExpiresAt, configureExtensionAuth, configurePlatformSettings, createPaginationResult, domainErrorMessage, extensionDatabaseMigrations, extensionEntities, generateHashFromString, generateRandomHash, generateUniqueHash, getAmountPlusFee, getAppliedBlockNum, hasServerSecret, isChainTextDigest, isExtensionAvailable, mergeSecretConfig, paginationInputToOffset, parseChainAssert, platformSettings, providerSuppliedPaths, redactSecretConfig, registerExtensionDatabaseMigrations, registerExtensionEntities, resetExtensionDatabaseMigrations, resetExtensionEntities, resolveChainText, resolveSortColumn, rethrowChainError, sanitizeUserText, validationMessage, verifySignedDocumentAgainstStoredDraft, waitForEvent };
-export type { AuthRolesOptions, BucketSource, BucketSpec, DeserializedDescriptionOfExtension, DomainErrorParams, EventSource, EventWait, ExcludeCommonProps, ExtensionAppTerminatePayload, ExtensionAuthOptions, ExtensionConfigFieldPolicy, ExtensionConfigPolicy, ExtensionDatabaseMigrationClass, ExtensionDomainInterface, ExtensionDomainRepository, ExtensionEntityClass, ExtensionSchemaMigrationAfterContext, GeneratedDocumentDomainInterface, GeneratedDocumentDraft, IDesktopConfig, IExtensionSchemaMigration, IRegistryExtension, IResolvedRegistryExtension, LoadGeneratedDocumentByDocHash, LogExtensionDomainInterface, LogExtensionDomainRepository, LogExtensionFilter, LogExtensionPaginationOptions, LogExtensionPaginationResult, PaymentDetails, PlatformBlockchainSettings, PlatformSettings, RegisteredBucket, RequireFields, SignedDocumentMetaCompareMode, SignedDocumentMetaVerification, SignedDocumentToVerify, TransactResultWithResponse };
+/**
+ * Разбор отказа контракта. Контракт пишет причину как `КОД: текст`
+ * (`GATEWAY_OUTCOME_NOT_FOUND: Объект возврата не существует…`); старые
+ * отказы — одним текстом, без кода.
+ */
+declare function parseChainAssert(message: string): {
+    code?: string;
+    text: string;
+};
+/**
+ * Код отказа контракта — из DomainError, в который отказ уже превращён,
+ * или из сырой ошибки цепи. Отказ без кода — undefined. Сравнивать отказы
+ * контракта — по этому коду, а не по тексту: текст переводится и правится.
+ */
+declare function chainErrorCode(error: unknown): string | undefined;
+/**
+ * Отказ контракта (`eosio::check`) как отказ с кодом; иной сбой цепи — null.
+ *
+ * Отказ контракта — ответ на действие пайщика, а не сбой сервера. Клиент цепи
+ * (@wharfkit/session) превращает его в простой Error, и без перевода он уходил
+ * ответом 500 без кода — в журнал ошибок как поломка (C28-80). Переводит
+ * единственная отправка в цепь, поэтому код получают все мутации сразу.
+ */
+declare function chainRefusalOf(error: unknown): DomainError | null;
+/**
+ * Пробросить отказ цепи человеку.
+ *
+ * `eosio::check` возвращает сообщение обёрнутым в `assertion failure with
+ * message: ...`; пайщику нужна причина, а не обёртка виртуальной машины.
+ * Живёт в каркасе, потому что в цепь ходит не одно расширение: вторая копия
+ * этой чистки разошлась бы с первой на первом же новом формате ошибки.
+ *
+ * Отказ с кодом (`КОД: текст`) уходит с этим кодом, текст — из словаря,
+ * а без записи в словаре — текст контракта. Отказ без кода — `CHAIN_ASSERT`,
+ * прочий сбой цепи — `CHAIN_ERROR`, текст — параметром `message`.
+ */
+declare function rethrowChainError(error: unknown): never;
+
+export { ActiveUserStatusGuard, AmountFormatterUtils, AssetUtils, AuthRoles, BaseExtensionModule, BucketRegistry, CandidateFilterInputDTO, CandidateOutputDTO, CandidateStatus, CurrencyValidationUtil, CurrentUser, DEFAULT_DOCUMENT_VERSION, DateUtils, DocumentAggregateDTO, DomainError, DomainToBlockchainUtils, EMPTY_HASH, EXTENSION_APP_TERMINATE_EVENT, EXTENSION_REPOSITORY, EXTENSION_SECRET_SET, EXTENSION_SECRET_UNSET, ExpenseProposalStatementGenerateDocumentInputDTO, ExpenseProposalStatementSignedDocumentInputDTO, ExpenseProposalStatementSignedMetaDocumentInputDTO, ExtensionAvailability, ExtensionConfigSuppliedBy, ExtensionDomainEntity, GenerateDocumentInputDTO, GenerateDocumentOptionsInputDTO, GenerateMetaDocumentInputDTO, GeneratedDocumentDTO, GqlJwtAuthGuard, HttpApiError, HttpJwtAuthGuard, IPNProvider, InjectBucket, LOG_EXTENSION_REPOSITORY, LangType, LocalChangesCollector, LogExtensionDomainEntity, MetaDocumentInputDTO, ONBOARDING_EXPIRY_DAYS, ONBOARDING_EXPIRY_MS, OptionalCurrentUser, OptionalGqlJwtAuthGuard, PaginationInputDTO, PaginationResult, PaginationUtils, PaymentProvider, PollingProvider, QuantityUtils, ROLES_ANY_STATUS_KEY, ROLES_DENY_SELF_KEY, RolesGuard, SORT_FIELD_PATTERN, SafeMarkup, SignatureInfoDTO, SignatureInfoInputDTO, SignedDigitalDocumentDTO, SignedDigitalDocumentInputDTO, TransactionDTO, UseBucket, bucketProvidersFor, bucketTokenFor, buildPaginationResult, chainErrorCode, chainRefusalOf, chainTextDigest, checkPaymentAmount, checkPaymentSymbol, computeOnboardingExpiresAt, configureExtensionAuth, configurePlatformSettings, createPaginationResult, domainErrorMessage, extensionDatabaseMigrations, extensionEntities, generateHashFromString, generateRandomHash, generateUniqueHash, getAmountPlusFee, getAppliedBlockNum, hasServerSecret, isChainTextDigest, isChainTextOf, isExtensionAvailable, mergeSecretConfig, numericColumnTransformer, paginationInputToOffset, parseChainAssert, platformSettings, providerSuppliedPaths, redactSecretConfig, registerExtensionDatabaseMigrations, registerExtensionEntities, resetExtensionDatabaseMigrations, resetExtensionEntities, resolveChainText, resolveSortColumn, rethrowChainError, sanitizeUserText, validationMessage, verifySignedDocumentAgainstStoredDraft, waitForEvent };
+export type { AuthRolesOptions, BucketSource, BucketSpec, DeserializedDescriptionOfExtension, DomainErrorParams, EventSource, EventWait, ExcludeCommonProps, ExtensionAppTerminatePayload, ExtensionAuthOptions, ExtensionConfigFieldPolicy, ExtensionConfigPolicy, ExtensionDatabaseMigrationClass, ExtensionDomainInterface, ExtensionDomainRepository, ExtensionEntityClass, ExtensionSchemaMigrationAfterContext, GeneratedDocumentDomainInterface, GeneratedDocumentDraft, IDesktopConfig, IExtensionSchemaMigration, IRegistryExtension, IResolvedRegistryExtension, LoadGeneratedDocumentByDocHash, LocalChangePublisher, LogExtensionDomainInterface, LogExtensionDomainRepository, LogExtensionFilter, LogExtensionPaginationOptions, LogExtensionPaginationResult, PaymentDetails, PlatformBlockchainSettings, PlatformSettings, RegisteredBucket, RequireFields, SignedDocumentMetaCompareMode, SignedDocumentMetaVerification, SignedDocumentToVerify, TransactResultWithResponse };

package/dist/index.d.ts

@@ -5,7 +5,8 @@ import { Reflector } from '@nestjs/core';
 import { Observable } from 'rxjs';
 import { ZodObject } from 'zod';
 import { Cooperative } from 'cooptypes';
-import { MigrationInterface, ObjectLiteral, Repository } from 'typeorm';
+import { MigrationInterface, ObjectLiteral, Repository, EntitySubscriberInterface, InsertEvent, UpdateEvent, RemoveEvent, TransactionCommitEvent, TransactionRollbackEvent, ValueTransformer } from 'typeorm';
+import { ValidationOptions } from 'class-validator';
 
 /**
  * Пути внутри объекта, по которым пайщик признаётся «своим» для поля.
@@ -1320,6 +1321,8 @@ declare class DomainToBlockchainUtils {
 declare function chainTextDigest(text: string | null | undefined): string;
 /** Значение из цепи — хеш текста, а не сам текст. */
 declare function isChainTextDigest(value: string | null | undefined): value is string;
+/** Хеш в цепи — хеш именно этого текста (регистр хеша не важен). */
+declare function isChainTextOf(text: string | null | undefined, chainValue: string | null | undefined): boolean;
 /**
  * Значение поля из цепи для записи в базу: хеш текст в базе не заменяет.
  * Строки, записанные до выноса текстов, несут сам текст и копируются как раньше.
@@ -1596,7 +1599,7 @@ declare class CurrencyValidationUtil {
     /**
      * Форматирует сумму с правильным символом валюты
      * @param value Числовое значение
-     * @param precision Количество знаков после запятой (по умолчанию из конфига)
+     * @param precision Количество знаков после запятой (по умолчанию из настроек платформы)
      * @returns string - отформатированная сумма
      */
     static formatAmount(value: number, precision?: number): string;
@@ -1631,6 +1634,58 @@ declare function sanitizeUserText<T extends string | null | undefined>(value: T)
  */
 declare function resolveSortColumn<T extends ObjectLiteral>(repository: Repository<T>, sortBy: string | undefined, fallback: string): string;
 
+/** Публикация сигнала ленты изменений: таблица базы, ключ строки, строка. */
+type LocalChangePublisher = (table: string, primary_key: string, row: Record<string, unknown> | undefined) => unknown;
+/**
+ * Сигналы ленты изменений для данных узла вне цепи — общая часть подписчика
+ * TypeORM для ядра и расширений со своей базой.
+ *
+ * Любая запись в наблюдаемую таблицу — через репозиторий, менеджер или
+ * построитель запросов — порождает сигнал «перечитай». Сигнал уходит после
+ * фиксации транзакции: стол по нему читает уже записанное, а откаченная запись
+ * сигнала не даёт. Сырой `query()` подписчик не видит — такую запись
+ * публикует сам её автор.
+ *
+ * Из `typeorm` здесь только типы: метаданные и события приходят от источника
+ * данных вызывающей стороны.
+ */
+declare class LocalChangesCollector implements EntitySubscriberInterface {
+    private readonly isWatched;
+    private readonly publish;
+    private readonly pending;
+    constructor(isWatched: (table: string) => boolean, publish: LocalChangePublisher);
+    afterInsert(event: InsertEvent<any>): void;
+    afterUpdate(event: UpdateEvent<any>): void;
+    afterRemove(event: RemoveEvent<any>): void;
+    afterTransactionCommit(event: TransactionCommitEvent): void;
+    afterTransactionRollback(event: TransactionRollbackEvent): void;
+    private collect;
+}
+
+/**
+ * Трансформер колонок `numeric`, которые в домене — число: Postgres отдаёт
+ * numeric строкой, а сущности и арифметика работают с `number`. Годится для
+ * количеств (0.5 кг) и сумм, которые домен держит числом (сумма платежа);
+ * денежные поля, которые домен держит строкой актива, его не используют.
+ *
+ * Один экземпляр на ядро и расширения — из пакета (из typeorm здесь только тип).
+ */
+declare const numericColumnTransformer: ValueTransformer;
+
+/**
+ * Текст, который уходит в подписываемый документ (повестка собрания, проект
+ * решения совета), без исполняемой разметки.
+ *
+ * Вёрстка допускается: проекты решений на утверждение совета несут абзацы,
+ * таблицы и стили документа. Отклоняются только скрипты, встраиваемые рамки и
+ * объекты, формы, обработчики событий и опасные ссылки — правило одно с
+ * очисткой редактора (`_Common.Text.hasExecutableMarkup` в cooptypes).
+ *
+ * Отказ, а не очистка: документ подписывается по хэшу, и переписанный текст
+ * был бы не тем, что ввёл человек (решение владельца 25.09.2026, C28-80).
+ */
+declare function SafeMarkup(validationOptions?: ValidationOptions): (object: object, propertyName: string) => void;
+
 /**
  * Ошибка API с кодом состояния HTTP.
  *
@@ -1647,35 +1702,6 @@ declare class HttpApiError extends HttpException {
     constructor(statusCode: HttpStatus, message: string, isOperational?: boolean, stack?: string, subcode?: any);
 }
 
-/**
- * Разбор отказа контракта. Контракт пишет причину как `КОД: текст`
- * (`GATEWAY_OUTCOME_NOT_FOUND: Объект возврата не существует…`); старые
- * отказы — одним текстом, без кода.
- */
-declare function parseChainAssert(message: string): {
-    code?: string;
-    text: string;
-};
-/**
- * Код отказа контракта — из DomainError, в который отказ уже превращён,
- * или из сырой ошибки цепи. Отказ без кода — undefined. Сравнивать отказы
- * контракта — по этому коду, а не по тексту: текст переводится и правится.
- */
-declare function chainErrorCode(error: unknown): string | undefined;
-/**
- * Пробросить отказ цепи человеку.
- *
- * `eosio::check` возвращает сообщение обёрнутым в `assertion failure with
- * message: ...`; пайщику нужна причина, а не обёртка виртуальной машины.
- * Живёт в каркасе, потому что в цепь ходит не одно расширение: вторая копия
- * этой чистки разошлась бы с первой на первом же новом формате ошибки.
- *
- * Отказ с кодом (`КОД: текст`) уходит с этим кодом, текст — из словаря,
- * а без записи в словаре — текст контракта. Отказ без кода — `CHAIN_ASSERT`,
- * прочий сбой цепи — `CHAIN_ERROR`, текст — параметром `message`.
- */
-declare function rethrowChainError(error: unknown): never;
-
 type DomainErrorParams = Record<string, string | number | boolean | null | undefined>;
 interface Branded {
     code: string;
@@ -1733,5 +1759,43 @@ declare function validationMessage(key: string, params?: DomainErrorParams): (ar
     constraints?: unknown[];
 }) => string;
 
-export { ActiveUserStatusGuard, AmountFormatterUtils, AssetUtils, AuthRoles, BaseExtensionModule, BucketRegistry, CandidateFilterInputDTO, CandidateOutputDTO, CandidateStatus, CurrencyValidationUtil, CurrentUser, DEFAULT_DOCUMENT_VERSION, DateUtils, DocumentAggregateDTO, DomainError, DomainToBlockchainUtils, EMPTY_HASH, EXTENSION_APP_TERMINATE_EVENT, EXTENSION_REPOSITORY, EXTENSION_SECRET_SET, EXTENSION_SECRET_UNSET, ExpenseProposalStatementGenerateDocumentInputDTO, ExpenseProposalStatementSignedDocumentInputDTO, ExpenseProposalStatementSignedMetaDocumentInputDTO, ExtensionAvailability, ExtensionConfigSuppliedBy, ExtensionDomainEntity, GenerateDocumentInputDTO, GenerateDocumentOptionsInputDTO, GenerateMetaDocumentInputDTO, GeneratedDocumentDTO, GqlJwtAuthGuard, HttpApiError, HttpJwtAuthGuard, IPNProvider, InjectBucket, LOG_EXTENSION_REPOSITORY, LangType, LogExtensionDomainEntity, MetaDocumentInputDTO, ONBOARDING_EXPIRY_DAYS, ONBOARDING_EXPIRY_MS, OptionalCurrentUser, OptionalGqlJwtAuthGuard, PaginationInputDTO, PaginationResult, PaginationUtils, PaymentProvider, PollingProvider, QuantityUtils, ROLES_ANY_STATUS_KEY, ROLES_DENY_SELF_KEY, RolesGuard, SORT_FIELD_PATTERN, SignatureInfoDTO, SignatureInfoInputDTO, SignedDigitalDocumentDTO, SignedDigitalDocumentInputDTO, TransactionDTO, UseBucket, bucketProvidersFor, bucketTokenFor, buildPaginationResult, chainErrorCode, chainTextDigest, checkPaymentAmount, checkPaymentSymbol, computeOnboardingExpiresAt, configureExtensionAuth, configurePlatformSettings, createPaginationResult, domainErrorMessage, extensionDatabaseMigrations, extensionEntities, generateHashFromString, generateRandomHash, generateUniqueHash, getAmountPlusFee, getAppliedBlockNum, hasServerSecret, isChainTextDigest, isExtensionAvailable, mergeSecretConfig, paginationInputToOffset, parseChainAssert, platformSettings, providerSuppliedPaths, redactSecretConfig, registerExtensionDatabaseMigrations, registerExtensionEntities, resetExtensionDatabaseMigrations, resetExtensionEntities, resolveChainText, resolveSortColumn, rethrowChainError, sanitizeUserText, validationMessage, verifySignedDocumentAgainstStoredDraft, waitForEvent };
-export type { AuthRolesOptions, BucketSource, BucketSpec, DeserializedDescriptionOfExtension, DomainErrorParams, EventSource, EventWait, ExcludeCommonProps, ExtensionAppTerminatePayload, ExtensionAuthOptions, ExtensionConfigFieldPolicy, ExtensionConfigPolicy, ExtensionDatabaseMigrationClass, ExtensionDomainInterface, ExtensionDomainRepository, ExtensionEntityClass, ExtensionSchemaMigrationAfterContext, GeneratedDocumentDomainInterface, GeneratedDocumentDraft, IDesktopConfig, IExtensionSchemaMigration, IRegistryExtension, IResolvedRegistryExtension, LoadGeneratedDocumentByDocHash, LogExtensionDomainInterface, LogExtensionDomainRepository, LogExtensionFilter, LogExtensionPaginationOptions, LogExtensionPaginationResult, PaymentDetails, PlatformBlockchainSettings, PlatformSettings, RegisteredBucket, RequireFields, SignedDocumentMetaCompareMode, SignedDocumentMetaVerification, SignedDocumentToVerify, TransactResultWithResponse };
+/**
+ * Разбор отказа контракта. Контракт пишет причину как `КОД: текст`
+ * (`GATEWAY_OUTCOME_NOT_FOUND: Объект возврата не существует…`); старые
+ * отказы — одним текстом, без кода.
+ */
+declare function parseChainAssert(message: string): {
+    code?: string;
+    text: string;
+};
+/**
+ * Код отказа контракта — из DomainError, в который отказ уже превращён,
+ * или из сырой ошибки цепи. Отказ без кода — undefined. Сравнивать отказы
+ * контракта — по этому коду, а не по тексту: текст переводится и правится.
+ */
+declare function chainErrorCode(error: unknown): string | undefined;
+/**
+ * Отказ контракта (`eosio::check`) как отказ с кодом; иной сбой цепи — null.
+ *
+ * Отказ контракта — ответ на действие пайщика, а не сбой сервера. Клиент цепи
+ * (@wharfkit/session) превращает его в простой Error, и без перевода он уходил
+ * ответом 500 без кода — в журнал ошибок как поломка (C28-80). Переводит
+ * единственная отправка в цепь, поэтому код получают все мутации сразу.
+ */
+declare function chainRefusalOf(error: unknown): DomainError | null;
+/**
+ * Пробросить отказ цепи человеку.
+ *
+ * `eosio::check` возвращает сообщение обёрнутым в `assertion failure with
+ * message: ...`; пайщику нужна причина, а не обёртка виртуальной машины.
+ * Живёт в каркасе, потому что в цепь ходит не одно расширение: вторая копия
+ * этой чистки разошлась бы с первой на первом же новом формате ошибки.
+ *
+ * Отказ с кодом (`КОД: текст`) уходит с этим кодом, текст — из словаря,
+ * а без записи в словаре — текст контракта. Отказ без кода — `CHAIN_ASSERT`,
+ * прочий сбой цепи — `CHAIN_ERROR`, текст — параметром `message`.
+ */
+declare function rethrowChainError(error: unknown): never;
+
+export { ActiveUserStatusGuard, AmountFormatterUtils, AssetUtils, AuthRoles, BaseExtensionModule, BucketRegistry, CandidateFilterInputDTO, CandidateOutputDTO, CandidateStatus, CurrencyValidationUtil, CurrentUser, DEFAULT_DOCUMENT_VERSION, DateUtils, DocumentAggregateDTO, DomainError, DomainToBlockchainUtils, EMPTY_HASH, EXTENSION_APP_TERMINATE_EVENT, EXTENSION_REPOSITORY, EXTENSION_SECRET_SET, EXTENSION_SECRET_UNSET, ExpenseProposalStatementGenerateDocumentInputDTO, ExpenseProposalStatementSignedDocumentInputDTO, ExpenseProposalStatementSignedMetaDocumentInputDTO, ExtensionAvailability, ExtensionConfigSuppliedBy, ExtensionDomainEntity, GenerateDocumentInputDTO, GenerateDocumentOptionsInputDTO, GenerateMetaDocumentInputDTO, GeneratedDocumentDTO, GqlJwtAuthGuard, HttpApiError, HttpJwtAuthGuard, IPNProvider, InjectBucket, LOG_EXTENSION_REPOSITORY, LangType, LocalChangesCollector, LogExtensionDomainEntity, MetaDocumentInputDTO, ONBOARDING_EXPIRY_DAYS, ONBOARDING_EXPIRY_MS, OptionalCurrentUser, OptionalGqlJwtAuthGuard, PaginationInputDTO, PaginationResult, PaginationUtils, PaymentProvider, PollingProvider, QuantityUtils, ROLES_ANY_STATUS_KEY, ROLES_DENY_SELF_KEY, RolesGuard, SORT_FIELD_PATTERN, SafeMarkup, SignatureInfoDTO, SignatureInfoInputDTO, SignedDigitalDocumentDTO, SignedDigitalDocumentInputDTO, TransactionDTO, UseBucket, bucketProvidersFor, bucketTokenFor, buildPaginationResult, chainErrorCode, chainRefusalOf, chainTextDigest, checkPaymentAmount, checkPaymentSymbol, computeOnboardingExpiresAt, configureExtensionAuth, configurePlatformSettings, createPaginationResult, domainErrorMessage, extensionDatabaseMigrations, extensionEntities, generateHashFromString, generateRandomHash, generateUniqueHash, getAmountPlusFee, getAppliedBlockNum, hasServerSecret, isChainTextDigest, isChainTextOf, isExtensionAvailable, mergeSecretConfig, numericColumnTransformer, paginationInputToOffset, parseChainAssert, platformSettings, providerSuppliedPaths, redactSecretConfig, registerExtensionDatabaseMigrations, registerExtensionEntities, resetExtensionDatabaseMigrations, resetExtensionEntities, resolveChainText, resolveSortColumn, rethrowChainError, sanitizeUserText, validationMessage, verifySignedDocumentAgainstStoredDraft, waitForEvent };
+export type { AuthRolesOptions, BucketSource, BucketSpec, DeserializedDescriptionOfExtension, DomainErrorParams, EventSource, EventWait, ExcludeCommonProps, ExtensionAppTerminatePayload, ExtensionAuthOptions, ExtensionConfigFieldPolicy, ExtensionConfigPolicy, ExtensionDatabaseMigrationClass, ExtensionDomainInterface, ExtensionDomainRepository, ExtensionEntityClass, ExtensionSchemaMigrationAfterContext, GeneratedDocumentDomainInterface, GeneratedDocumentDraft, IDesktopConfig, IExtensionSchemaMigration, IRegistryExtension, IResolvedRegistryExtension, LoadGeneratedDocumentByDocHash, LocalChangePublisher, LogExtensionDomainInterface, LogExtensionDomainRepository, LogExtensionFilter, LogExtensionPaginationOptions, LogExtensionPaginationResult, PaymentDetails, PlatformBlockchainSettings, PlatformSettings, RegisteredBucket, RequireFields, SignedDocumentMetaCompareMode, SignedDocumentMetaVerification, SignedDocumentToVerify, TransactResultWithResponse };

package/dist/index.mjs

@@ -5,7 +5,7 @@ import { Reflector } from '@nestjs/core';
 import { AuthGuard } from '@nestjs/passport';
 import { timingSafeEqual } from 'node:crypto';
 import { z } from 'zod';
-import { IsNumber, IsString, IsArray, ArrayMinSize, ValidateNested, IsEnum, IsInt, IsOptional, Matches, IsNotEmpty, IsObject } from 'class-validator';
+import { IsNumber, IsString, IsArray, ArrayMinSize, ValidateNested, IsEnum, IsInt, IsOptional, Matches, IsNotEmpty, IsIn, IsObject, registerDecorator } from 'class-validator';
 import { Type } from 'class-transformer';
 import { GraphQLJSON } from 'graphql-type-json';
 import { Classes } from '@coopenomics/sdk';
@@ -1078,7 +1078,9 @@ __decorateClass$7([
   Field(() => String, {
     description: '\u041D\u0430\u043F\u0440\u0430\u0432\u043B\u0435\u043D\u0438\u0435 \u0441\u043E\u0440\u0442\u0438\u0440\u043E\u0432\u043A\u0438 ("ASC" \u0438\u043B\u0438 "DESC")',
     defaultValue: "ASC"
-  })
+  }),
+  IsOptional(),
+  IsIn(["ASC", "DESC"], { message: validationMessage("kit.pagination.invalidSortOrder") })
 ], PaginationInputDTO.prototype, "sortOrder", 2);
 PaginationInputDTO = __decorateClass$7([
   InputType("PaginationInput")
@@ -1146,16 +1148,16 @@ class PaginationUtils {
   static validatePaginationOptions(options) {
     const { page = 1, limit = 10, sortBy, sortOrder = "ASC" } = options;
     if (page < 1) {
-      throw DomainError.internal("KIT_PAGE_NUMBER_INVALID");
+      throw DomainError.badRequest("KIT_PAGE_NUMBER_INVALID");
     }
     if (limit < 1 || limit > 1e3) {
-      throw DomainError.internal("KIT_PAGE_LIMIT_INVALID");
+      throw DomainError.badRequest("KIT_PAGE_LIMIT_INVALID");
     }
     if (sortOrder !== "ASC" && sortOrder !== "DESC") {
-      throw DomainError.internal("KIT_SORT_ORDER_INVALID");
+      throw DomainError.badRequest("KIT_SORT_ORDER_INVALID");
     }
     if (sortBy !== void 0 && sortBy !== null && !SORT_FIELD_PATTERN.test(sortBy)) {
-      throw DomainError.internal("KIT_SORT_FIELD_INVALID");
+      throw DomainError.badRequest("KIT_SORT_FIELD_INVALID");
     }
     return {
       page,
@@ -1525,7 +1527,7 @@ class CurrencyValidationUtil {
   static validateCurrencySymbol(amount, fieldName = t("kit.currency.defaultFieldName")) {
     if (!this.hasValidCurrencySymbol(amount)) {
       const expectedSymbol = platformSettings().blockchain.rootGovernSymbol;
-      throw DomainError.internal("KIT_CURRENCY_SYMBOL_INVALID", { fieldName, expectedSymbol });
+      throw DomainError.badRequest("KIT_CURRENCY_SYMBOL_INVALID", { fieldName, expectedSymbol });
     }
   }
   /**
@@ -1556,12 +1558,13 @@ class CurrencyValidationUtil {
   /**
    * Форматирует сумму с правильным символом валюты
    * @param value Числовое значение
-   * @param precision Количество знаков после запятой (по умолчанию из конфига)
+   * @param precision Количество знаков после запятой (по умолчанию из настроек платформы)
    * @returns string - отформатированная сумма
    */
   static formatAmount(value, precision) {
-    const actualPrecision = precision ?? config.blockchain.root_govern_precision;
-    const symbol = platformSettings().blockchain.rootGovernSymbol;
+    const { rootGovernPrecision, rootGovernSymbol } = platformSettings().blockchain;
+    const actualPrecision = precision ?? rootGovernPrecision;
+    const symbol = rootGovernSymbol;
     return `${value.toFixed(actualPrecision)} ${symbol}`;
   }
 }
@@ -1669,12 +1672,12 @@ let DomainToBlockchainUtils = class {
   formatQuantityWithPrecision(quantity) {
     const parts = quantity.split(" ");
     if (parts.length !== 2) {
-      throw DomainError.internal("KIT_QUANTITY_FORMAT_INVALID", { quantity });
+      throw DomainError.badRequest("KIT_QUANTITY_FORMAT_INVALID", { quantity });
     }
     const [amount, symbol] = parts;
     const numericAmount = parseFloat(amount);
     if (isNaN(numericAmount)) {
-      throw DomainError.internal("KIT_QUANTITY_AMOUNT_INVALID", { amount });
+      throw DomainError.badRequest("KIT_QUANTITY_AMOUNT_INVALID", { amount });
     }
     const { rootSymbol, rootPrecision, rootGovernSymbol, rootGovernPrecision } = platformSettings().blockchain;
     let precision;
@@ -1683,7 +1686,7 @@ let DomainToBlockchainUtils = class {
     } else if (symbol === rootGovernSymbol) {
       precision = rootGovernPrecision;
     } else {
-      throw DomainError.internal("KIT_SYMBOL_UNSUPPORTED", { symbol, rootSymbol, rootGovernSymbol });
+      throw DomainError.badRequest("KIT_SYMBOL_UNSUPPORTED", { symbol, rootSymbol, rootGovernSymbol });
     }
     return `${numericAmount.toFixed(precision)} ${symbol}`;
   }
@@ -1691,10 +1694,10 @@ let DomainToBlockchainUtils = class {
   formatNumericStringToAssetString(numericString, precision, symbol) {
     const numericValue = parseFloat(numericString);
     if (isNaN(numericValue)) {
-      throw DomainError.internal("KIT_NUMBER_INVALID", { value: numericString });
+      throw DomainError.badRequest("KIT_NUMBER_INVALID", { value: numericString });
     }
     if (numericValue < 0) {
-      throw DomainError.internal("KIT_NUMBER_NEGATIVE", { value: numericString });
+      throw DomainError.badRequest("KIT_NUMBER_NEGATIVE", { value: numericString });
     }
     return `${numericValue.toFixed(precision)} ${symbol}`;
   }
@@ -1725,7 +1728,7 @@ DomainToBlockchainUtils = __decorateClass([
   Injectable()
 ], DomainToBlockchainUtils);
 
-const DIGEST_RE = /^[0-9a-f]{64}$/;
+const DIGEST_RE = /^[0-9a-f]{64}$/i;
 function chainTextDigest(text) {
   if (!text)
     return "";
@@ -1734,6 +1737,9 @@ function chainTextDigest(text) {
 function isChainTextDigest(value) {
   return typeof value === "string" && DIGEST_RE.test(value);
 }
+function isChainTextOf(text, chainValue) {
+  return chainTextDigest(text) === (chainValue ?? "").toLowerCase();
+}
 function resolveChainText(chainValue, current) {
   return isChainTextDigest(chainValue) ? current ?? "" : chainValue;
 }
@@ -1824,17 +1830,17 @@ class AmountFormatterUtils {
    */
   static formatAmount(amountStr) {
     if (!amountStr || typeof amountStr !== "string") {
-      throw DomainError.internal("KIT_AMOUNT_FORMAT_INVALID", { amount: amountStr });
+      throw DomainError.badRequest("KIT_AMOUNT_FORMAT_INVALID", { amount: amountStr });
     }
     const parts = amountStr.trim().split(/\s+/);
     if (parts.length < 1 || !parts[0]) {
-      throw DomainError.internal("KIT_AMOUNT_FORMAT_INVALID", { amount: amountStr });
+      throw DomainError.badRequest("KIT_AMOUNT_FORMAT_INVALID", { amount: amountStr });
     }
     const amountPart = parts[0].replace(",", ".");
     const currency = parts.length >= 2 ? parts.slice(1).join(" ") : "";
     const amount = parseFloat(amountPart);
     if (isNaN(amount)) {
-      throw DomainError.internal("KIT_AMOUNT_NUMBER_INVALID", { value: parts[0] });
+      throw DomainError.badRequest("KIT_AMOUNT_NUMBER_INVALID", { value: parts[0] });
     }
     const formattedAmount = amount.toLocaleString("ru-RU", {
       minimumFractionDigits: 2,
@@ -1910,7 +1916,7 @@ class QuantityUtils {
     } else if (symbol === rootGovernSymbol) {
       return rootGovernPrecision;
     } else {
-      throw DomainError.internal("KIT_SYMBOL_UNSUPPORTED", { symbol, rootSymbol, rootGovernSymbol });
+      throw DomainError.badRequest("KIT_SYMBOL_UNSUPPORTED", { symbol, rootSymbol, rootGovernSymbol });
     }
   }
   /**
@@ -1920,7 +1926,7 @@ class QuantityUtils {
   static validateSymbol(symbol) {
     if (!this.isSupportedSymbol(symbol)) {
       const { rootSymbol, rootGovernSymbol } = platformSettings().blockchain;
-      throw DomainError.internal("KIT_SYMBOL_UNSUPPORTED", { symbol, rootSymbol, rootGovernSymbol });
+      throw DomainError.badRequest("KIT_SYMBOL_UNSUPPORTED", { symbol, rootSymbol, rootGovernSymbol });
     }
   }
   /**
@@ -1932,7 +1938,7 @@ class QuantityUtils {
   static formatQuantityForBlockchain(amount, symbol) {
     this.validateSymbol(symbol);
     if (isNaN(amount) || amount < 0) {
-      throw DomainError.internal("KIT_NUMBER_INVALID", { value: amount });
+      throw DomainError.badRequest("KIT_NUMBER_INVALID", { value: amount });
     }
     const precision = this.getPrecisionForSymbol(symbol);
     const formattedAmount = amount.toFixed(precision);
@@ -1947,7 +1953,7 @@ class QuantityUtils {
   static combineQuantityAndSymbol(amount, symbol) {
     this.validateSymbol(symbol);
     if (isNaN(amount) || amount < 0) {
-      throw DomainError.internal("KIT_NUMBER_INVALID", { value: amount });
+      throw DomainError.badRequest("KIT_NUMBER_INVALID", { value: amount });
     }
     return `${amount} ${symbol}`;
   }
@@ -1959,12 +1965,12 @@ class QuantityUtils {
   static parseQuantityString(quantity) {
     const parts = quantity.split(" ");
     if (parts.length !== 2) {
-      throw DomainError.internal("KIT_QUANTITY_FORMAT_INVALID", { quantity });
+      throw DomainError.badRequest("KIT_QUANTITY_FORMAT_INVALID", { quantity });
     }
     const [amountStr, symbol] = parts;
     const amount = parseFloat(amountStr);
     if (isNaN(amount)) {
-      throw DomainError.internal("KIT_QUANTITY_AMOUNT_INVALID", { amount: amountStr });
+      throw DomainError.badRequest("KIT_QUANTITY_AMOUNT_INVALID", { amount: amountStr });
     }
     this.validateSymbol(symbol);
     return { amount, symbol };
@@ -2085,6 +2091,79 @@ function resolveSortColumn(repository, sortBy, fallback) {
   return isKnownColumn ? sortBy : fallback;
 }
 
+class LocalChangesCollector {
+  constructor(isWatched, publish) {
+    this.isWatched = isWatched;
+    this.publish = publish;
+    this.pending = /* @__PURE__ */ new WeakMap();
+  }
+  afterInsert(event) {
+    this.collect(event.metadata, event.queryRunner, event.entity);
+  }
+  afterUpdate(event) {
+    this.collect(event.metadata, event.queryRunner, { ...event.databaseEntity ?? {}, ...event.entity ?? {} });
+  }
+  afterRemove(event) {
+    const row = event.databaseEntity ?? event.entity;
+    this.collect(event.metadata, event.queryRunner, row, event.entityId);
+  }
+  afterTransactionCommit(event) {
+    const changes = this.pending.get(event.queryRunner);
+    if (!changes)
+      return;
+    this.pending.delete(event.queryRunner);
+    changes.forEach((c) => void this.publish(c.table, c.primary_key, c.row));
+  }
+  afterTransactionRollback(event) {
+    this.pending.delete(event.queryRunner);
+  }
+  collect(metadata, queryRunner, row, entityId) {
+    const table = metadata.tableName;
+    if (!this.isWatched(table))
+      return;
+    const change = { table, primary_key: primaryKeyOf(metadata, row, entityId), row };
+    if (queryRunner?.isTransactionActive) {
+      const list = this.pending.get(queryRunner) ?? [];
+      list.push(change);
+      this.pending.set(queryRunner, list);
+      return;
+    }
+    void this.publish(change.table, change.primary_key, change.row);
+  }
+}
+function primaryKeyOf(metadata, row, entityId) {
+  if (row) {
+    const ids = metadata.primaryColumns.map((c) => c.getEntityValue(row)).filter((v) => v !== void 0 && v !== null);
+    if (ids.length)
+      return ids.map(String).join(":");
+  }
+  if (entityId !== void 0 && entityId !== null) {
+    return typeof entityId === "object" ? Object.values(entityId).map(String).join(":") : String(entityId);
+  }
+  return "";
+}
+
+const numericColumnTransformer = {
+  to: (value) => value,
+  from: (value) => value === null || value === void 0 ? value : Number(value)
+};
+
+function SafeMarkup(validationOptions) {
+  return function(object, propertyName) {
+    registerDecorator({
+      name: "safeMarkup",
+      target: object.constructor,
+      propertyName,
+      options: { message: validationMessage("kit.markup.executable"), ...validationOptions },
+      validator: {
+        validate(value) {
+          return typeof value !== "string" || !_Common.Text.hasExecutableMarkup(value);
+        }
+      }
+    });
+  };
+}
+
 class HttpApiError extends HttpException {
   constructor(statusCode, message, isOperational = true, stack, subcode) {
     super(message, statusCode);
@@ -2100,6 +2179,7 @@ class HttpApiError extends HttpException {
 
 const ASSERT_PREFIX = /assertion failure with message: (.+?)(?:\n|$)/;
 const CODED = /^([A-Z][A-Z0-9]*(?:_[A-Z0-9]+)+):\s*(.*)$/s;
+const ENCODING = /^Encoding error at root<[^>]*>((?:\.[^.<:]+<[^>]*>)*):/;
 function parseChainAssert(message) {
   const assert = message.match(ASSERT_PREFIX);
   const body = (assert ? assert[1] : message).trim();
@@ -2115,7 +2195,23 @@ function chainErrorCode(error) {
   const raw = error?.message ?? String(error);
   return parseChainAssert(raw).code;
 }
+function chainRefusalOf(error) {
+  if (error instanceof DomainError)
+    return error;
+  const raw = error?.message ?? String(error);
+  const encoding = raw.match(ENCODING);
+  if (encoding) {
+    const field = encoding[1].split(".").filter(Boolean).map((part) => part.replace(/<[^>]*>$/, "")).join(".");
+    return DomainError.badRequest("CHAIN_ACTION_ARGUMENT_INVALID", { field });
+  }
+  if (!ASSERT_PREFIX.test(raw))
+    return null;
+  const { code, text } = parseChainAssert(raw);
+  return DomainError.badRequest(code ?? "CHAIN_ASSERT", { message: text });
+}
 function rethrowChainError(error) {
+  if (error instanceof DomainError)
+    throw error;
   const raw = error?.message ?? String(error);
   const match = raw.match(ASSERT_PREFIX);
   if (!match)
@@ -2124,4 +2220,4 @@ function rethrowChainError(error) {
   throw DomainError.badRequest(code ?? "CHAIN_ASSERT", { message: text });
 }
 
-export { ActiveUserStatusGuard, AmountFormatterUtils, AssetUtils, AuthRoles, BaseExtensionModule, BucketRegistry, CandidateFilterInputDTO, CandidateOutputDTO, CandidateStatus, CurrencyValidationUtil, CurrentUser, DEFAULT_DOCUMENT_VERSION, DateUtils, DocumentAggregateDTO, DomainError, DomainToBlockchainUtils, EMPTY_HASH, EXTENSION_APP_TERMINATE_EVENT, EXTENSION_REPOSITORY, EXTENSION_SECRET_SET, EXTENSION_SECRET_UNSET, ExpenseProposalStatementGenerateDocumentInputDTO, ExpenseProposalStatementSignedDocumentInputDTO, ExpenseProposalStatementSignedMetaDocumentInputDTO, ExtensionAvailability, ExtensionConfigSuppliedBy, ExtensionDomainEntity, GenerateDocumentInputDTO, GenerateDocumentOptionsInputDTO, GenerateMetaDocumentInputDTO, GeneratedDocumentDTO, GqlJwtAuthGuard, HttpApiError, HttpJwtAuthGuard, IPNProvider, InjectBucket, LOG_EXTENSION_REPOSITORY, LangType, LogExtensionDomainEntity, MetaDocumentInputDTO, ONBOARDING_EXPIRY_DAYS, ONBOARDING_EXPIRY_MS, OptionalCurrentUser, OptionalGqlJwtAuthGuard, PaginationInputDTO, PaginationResult, PaginationUtils, PaymentProvider, PollingProvider, QuantityUtils, ROLES_ANY_STATUS_KEY, ROLES_DENY_SELF_KEY, RolesGuard, SORT_FIELD_PATTERN, SignatureInfoDTO, SignatureInfoInputDTO, SignedDigitalDocumentDTO, SignedDigitalDocumentInputDTO, TransactionDTO, UseBucket, bucketProvidersFor, bucketTokenFor, buildPaginationResult, chainErrorCode, chainTextDigest, checkPaymentAmount, checkPaymentSymbol, computeOnboardingExpiresAt, configureExtensionAuth, configurePlatformSettings, createPaginationResult, domainErrorMessage, extensionDatabaseMigrations, extensionEntities, generateHashFromString, generateRandomHash, generateUniqueHash, getAmountPlusFee, getAppliedBlockNum, hasServerSecret, isChainTextDigest, isExtensionAvailable, mergeSecretConfig, paginationInputToOffset, parseChainAssert, platformSettings, providerSuppliedPaths, redactSecretConfig, registerExtensionDatabaseMigrations, registerExtensionEntities, resetExtensionDatabaseMigrations, resetExtensionEntities, resolveChainText, resolveSortColumn, rethrowChainError, sanitizeUserText, validationMessage, verifySignedDocumentAgainstStoredDraft, waitForEvent };
+export { ActiveUserStatusGuard, AmountFormatterUtils, AssetUtils, AuthRoles, BaseExtensionModule, BucketRegistry, CandidateFilterInputDTO, CandidateOutputDTO, CandidateStatus, CurrencyValidationUtil, CurrentUser, DEFAULT_DOCUMENT_VERSION, DateUtils, DocumentAggregateDTO, DomainError, DomainToBlockchainUtils, EMPTY_HASH, EXTENSION_APP_TERMINATE_EVENT, EXTENSION_REPOSITORY, EXTENSION_SECRET_SET, EXTENSION_SECRET_UNSET, ExpenseProposalStatementGenerateDocumentInputDTO, ExpenseProposalStatementSignedDocumentInputDTO, ExpenseProposalStatementSignedMetaDocumentInputDTO, ExtensionAvailability, ExtensionConfigSuppliedBy, ExtensionDomainEntity, GenerateDocumentInputDTO, GenerateDocumentOptionsInputDTO, GenerateMetaDocumentInputDTO, GeneratedDocumentDTO, GqlJwtAuthGuard, HttpApiError, HttpJwtAuthGuard, IPNProvider, InjectBucket, LOG_EXTENSION_REPOSITORY, LangType, LocalChangesCollector, LogExtensionDomainEntity, MetaDocumentInputDTO, ONBOARDING_EXPIRY_DAYS, ONBOARDING_EXPIRY_MS, OptionalCurrentUser, OptionalGqlJwtAuthGuard, PaginationInputDTO, PaginationResult, PaginationUtils, PaymentProvider, PollingProvider, QuantityUtils, ROLES_ANY_STATUS_KEY, ROLES_DENY_SELF_KEY, RolesGuard, SORT_FIELD_PATTERN, SafeMarkup, SignatureInfoDTO, SignatureInfoInputDTO, SignedDigitalDocumentDTO, SignedDigitalDocumentInputDTO, TransactionDTO, UseBucket, bucketProvidersFor, bucketTokenFor, buildPaginationResult, chainErrorCode, chainRefusalOf, chainTextDigest, checkPaymentAmount, checkPaymentSymbol, computeOnboardingExpiresAt, configureExtensionAuth, configurePlatformSettings, createPaginationResult, domainErrorMessage, extensionDatabaseMigrations, extensionEntities, generateHashFromString, generateRandomHash, generateUniqueHash, getAmountPlusFee, getAppliedBlockNum, hasServerSecret, isChainTextDigest, isChainTextOf, isExtensionAvailable, mergeSecretConfig, numericColumnTransformer, paginationInputToOffset, parseChainAssert, platformSettings, providerSuppliedPaths, redactSecretConfig, registerExtensionDatabaseMigrations, registerExtensionEntities, resetExtensionDatabaseMigrations, resetExtensionEntities, resolveChainText, resolveSortColumn, rethrowChainError, sanitizeUserText, validationMessage, verifySignedDocumentAgainstStoredDraft, waitForEvent };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@coopenomics/extension-kit",
   "type": "module",
-  "version": "2026.9.24-2",
+  "version": "2026.9.30",
   "description": "Служебный каркас расширения цифрового кооператива: базовый модуль, сущности и репозитории расширения, авторизация, каркас блокчейн-синхронизации, контракт миграций схемы, контракт реестра",
   "author": "Alex Ant <dacom.dark.sun@gmail.com>",
   "license": "MIT",
@@ -39,7 +39,7 @@
   },
   "peerDependencies": {
     "@coopenomics/i18n": "workspace:*",
-    "@coopenomics/sdk": "2026.9.24-2",
+    "@coopenomics/sdk": "2026.9.30",
     "@nestjs/common": "^10.0.0",
     "@nestjs/core": "^10.0.0",
     "@nestjs/graphql": "^12.2.1",
@@ -60,7 +60,7 @@
     "zod": "^3.0.0"
   },
   "devDependencies": {
-    "@coopenomics/i18n": "2026.9.24-2",
+    "@coopenomics/i18n": "2026.9.30",
     "@nestjs/common": "^10.0.0",
     "@nestjs/core": "^10.0.0",
     "@nestjs/graphql": "^12.2.1",
@@ -70,7 +70,7 @@
     "@wharfkit/session": "^1.4.0",
     "class-transformer": "^0.5.1",
     "class-validator": "^0.14.1",
-    "cooptypes": "2026.9.24-2",
+    "cooptypes": "2026.9.30",
     "graphql": "^16.9.0",
     "graphql-type-json": "^0.3.2",
     "moment": "^2.30.1",
@@ -82,5 +82,5 @@
     "unbuild": "^2.0.0",
     "zod": "^3.0.0"
   },
-  "gitHead": "08943be043e9451a6548b4934770d65ad37fa9e2"
+  "gitHead": "1346a804b5b9daec565a4bea5104510a6c832b0e"
 }