@coopenomics/extension-kit 2026.9.22 → 2026.9.24-2

package/dist/index.cjs

@@ -2,6 +2,7 @@
 
 const common = require('@nestjs/common');
 const graphql = require('@nestjs/graphql');
+const server = require('@coopenomics/i18n/server');
 const core = require('@nestjs/core');
 const passport = require('@nestjs/passport');
 const node_crypto = require('node:crypto');
@@ -12,16 +13,160 @@ const graphqlTypeJson = require('graphql-type-json');
 const sdk = require('@coopenomics/sdk');
 const antelope = require('@wharfkit/antelope');
 const moment = require('moment');
+const crypto = require('crypto');
 const moment$1 = require('moment-timezone');
 require('moment/locale/ru');
-const crypto = require('crypto');
 const cooptypes = require('cooptypes');
 
 function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e.default : e; }
 
 const moment__default = /*#__PURE__*/_interopDefaultCompat(moment);
-const moment__default$1 = /*#__PURE__*/_interopDefaultCompat(moment$1);
 const crypto__default = /*#__PURE__*/_interopDefaultCompat(crypto);
+const moment__default$1 = /*#__PURE__*/_interopDefaultCompat(moment$1);
+
+const DOMAIN_ERROR = Symbol.for("@coopenomics/extension-kit/DomainError");
+function domainErrorMessage(code, params = {}) {
+  const key = `errors.${code}`;
+  if (!server.te(key) && typeof params.message === "string")
+    return params.message;
+  return server.t(key, params);
+}
+function body(code, params, status) {
+  return { statusCode: status, code, params, message: domainErrorMessage(code, params) };
+}
+function brand(target, code, params) {
+  target.code = code;
+  target.params = params;
+  target[DOMAIN_ERROR] = true;
+  target.name = "DomainError";
+}
+class DomainError extends common.HttpException {
+  static [Symbol.hasInstance](value) {
+    return !!value && value[DOMAIN_ERROR] === true;
+  }
+  constructor(code, params = {}, status = common.HttpStatus.BAD_REQUEST) {
+    super(body(code, params, status), status);
+    brand(this, code, params);
+  }
+  /** Ключ сообщения в словаре. */
+  get messageKey() {
+    return `errors.${this.code}`;
+  }
+  static badRequest(code, params = {}) {
+    return new DomainBadRequest(code, params);
+  }
+  static unauthorized(code, params = {}) {
+    return new DomainUnauthorized(code, params);
+  }
+  static forbidden(code, params = {}) {
+    return new DomainForbidden(code, params);
+  }
+  static notFound(code, params = {}) {
+    return new DomainNotFound(code, params);
+  }
+  static conflict(code, params = {}) {
+    return new DomainConflict(code, params);
+  }
+  static unprocessable(code, params = {}) {
+    return new DomainUnprocessable(code, params);
+  }
+  static tooManyRequests(code, params = {}) {
+    return new DomainError(code, params, common.HttpStatus.TOO_MANY_REQUESTS);
+  }
+  static internal(code, params = {}) {
+    return new DomainInternal(code, params);
+  }
+  static badGateway(code, params = {}) {
+    return new DomainBadGateway(code, params);
+  }
+  static serviceUnavailable(code, params = {}) {
+    return new DomainServiceUnavailable(code, params);
+  }
+}
+class DomainBadGateway extends common.BadGatewayException {
+  constructor(code, params) {
+    super(body(code, params, common.HttpStatus.BAD_GATEWAY));
+    brand(this, code, params);
+  }
+  get messageKey() {
+    return `errors.${this.code}`;
+  }
+}
+class DomainServiceUnavailable extends common.ServiceUnavailableException {
+  constructor(code, params) {
+    super(body(code, params, common.HttpStatus.SERVICE_UNAVAILABLE));
+    brand(this, code, params);
+  }
+  get messageKey() {
+    return `errors.${this.code}`;
+  }
+}
+class DomainBadRequest extends common.BadRequestException {
+  constructor(code, params) {
+    super(body(code, params, common.HttpStatus.BAD_REQUEST));
+    brand(this, code, params);
+  }
+  get messageKey() {
+    return `errors.${this.code}`;
+  }
+}
+class DomainUnauthorized extends common.UnauthorizedException {
+  constructor(code, params) {
+    super(body(code, params, common.HttpStatus.UNAUTHORIZED));
+    brand(this, code, params);
+  }
+  get messageKey() {
+    return `errors.${this.code}`;
+  }
+}
+class DomainForbidden extends common.ForbiddenException {
+  constructor(code, params) {
+    super(body(code, params, common.HttpStatus.FORBIDDEN));
+    brand(this, code, params);
+  }
+  get messageKey() {
+    return `errors.${this.code}`;
+  }
+}
+class DomainNotFound extends common.NotFoundException {
+  constructor(code, params) {
+    super(body(code, params, common.HttpStatus.NOT_FOUND));
+    brand(this, code, params);
+  }
+  get messageKey() {
+    return `errors.${this.code}`;
+  }
+}
+class DomainConflict extends common.ConflictException {
+  constructor(code, params) {
+    super(body(code, params, common.HttpStatus.CONFLICT));
+    brand(this, code, params);
+  }
+  get messageKey() {
+    return `errors.${this.code}`;
+  }
+}
+class DomainUnprocessable extends common.UnprocessableEntityException {
+  constructor(code, params) {
+    super(body(code, params, common.HttpStatus.UNPROCESSABLE_ENTITY));
+    brand(this, code, params);
+  }
+  get messageKey() {
+    return `errors.${this.code}`;
+  }
+}
+class DomainInternal extends common.InternalServerErrorException {
+  constructor(code, params) {
+    super(body(code, params, common.HttpStatus.INTERNAL_SERVER_ERROR));
+    brand(this, code, params);
+  }
+  get messageKey() {
+    return `errors.${this.code}`;
+  }
+}
+function validationMessage(key, params = {}) {
+  return (args) => server.t(key, { property: args.property, value: String(args.value ?? ""), ...params });
+}
 
 const ROLES_DENY_SELF_KEY = "roles_deny_self";
 const ROLES_ANY_STATUS_KEY = "roles_any_status";
@@ -39,7 +184,7 @@ const CurrentUser = common.createParamDecorator((data, context) => {
   const ctx = graphql.GqlExecutionContext.create(context);
   const request = ctx.getContext().req;
   if (!request?.user) {
-    throw new common.UnauthorizedException("\u041F\u043E\u043B\u044C\u0437\u043E\u0432\u0430\u0442\u0435\u043B\u044C \u043D\u0435 \u0430\u0432\u0442\u043E\u0440\u0438\u0437\u043E\u0432\u0430\u043D");
+    throw DomainError.unauthorized("KIT_USER_NOT_AUTHORIZED");
   }
   return request?.user;
 });
@@ -122,7 +267,7 @@ exports.OptionalGqlJwtAuthGuard = class OptionalGqlJwtAuthGuard extends passport
     if (err instanceof Error) {
       throw err;
     }
-    throw new common.UnauthorizedException("\u0421\u0435\u0441\u0441\u0438\u044F \u0437\u0430\u0432\u0435\u0440\u0448\u0435\u043D\u0430, \u0442\u0440\u0435\u0431\u0443\u0435\u0442\u0441\u044F \u043F\u043E\u0432\u0442\u043E\u0440\u043D\u0430\u044F \u0430\u0432\u0442\u043E\u0440\u0438\u0437\u0430\u0446\u0438\u044F");
+    throw DomainError.unauthorized("KIT_SESSION_ENDED");
   }
 };
 exports.OptionalGqlJwtAuthGuard = __decorateClass$g([
@@ -172,11 +317,11 @@ exports.RolesGuard = class RolesGuard {
     if (allowedRoles.includes(user.role)) {
       const anyStatus = this.reflector.get(ROLES_ANY_STATUS_KEY, context.getHandler()) === true;
       if (user.role === PARTICIPANT_ROLE && !anyStatus && user.status !== ACTIVE_USER_STATUS) {
-        throw new common.ForbiddenException("\u0414\u043E\u0441\u0442\u0443\u043F \u0442\u043E\u043B\u044C\u043A\u043E \u0434\u043B\u044F \u043F\u0430\u0439\u0449\u0438\u043A\u043E\u0432 \u043A\u043E\u043E\u043F\u0435\u0440\u0430\u0442\u0438\u0432\u0430");
+        throw DomainError.forbidden("KIT_MEMBERS_ONLY");
       }
       return true;
     }
-    throw new common.UnauthorizedException(`\u041D\u0435\u0434\u043E\u0441\u0442\u0430\u0442\u043E\u0447\u043D\u043E \u043F\u0440\u0430\u0432 \u0434\u043E\u0441\u0442\u0443\u043F\u0430`);
+    throw DomainError.unauthorized("KIT_INSUFFICIENT_RIGHTS");
   }
 };
 exports.RolesGuard = __decorateClass$g([
@@ -192,12 +337,10 @@ exports.ActiveUserStatusGuard = class ActiveUserStatusGuard {
     }
     const user = request.user;
     if (!user?.status) {
-      throw new common.ForbiddenException("\u0422\u0440\u0435\u0431\u0443\u0435\u0442\u0441\u044F \u0430\u0432\u0442\u043E\u0440\u0438\u0437\u043E\u0432\u0430\u043D\u043D\u044B\u0439 \u043F\u043E\u043B\u044C\u0437\u043E\u0432\u0430\u0442\u0435\u043B\u044C");
+      throw DomainError.forbidden("KIT_AUTHORIZED_USER_REQUIRED");
     }
     if (user.status !== ACTIVE_USER_STATUS) {
-      throw new common.ForbiddenException(
-        "\u0414\u043E\u0441\u0442\u0443\u043F \u0442\u043E\u043B\u044C\u043A\u043E \u0434\u043B\u044F \u043F\u0430\u0439\u0449\u0438\u043A\u043E\u0432 \u0432 \u0441\u0442\u0430\u0442\u0443\u0441\u0435 \xABactive\xBB"
-      );
+      throw DomainError.forbidden("KIT_ACTIVE_MEMBERS_ONLY");
     }
     return true;
   }
@@ -262,6 +405,7 @@ const BucketRegistry = {
     const existing = REGISTERED.get(cls);
     if (existing && existing.name !== spec.name) {
       throw new Error(
+        // i18n-ignore: ошибка регистрации бакета при старте, до пайщика не доходит
         `BucketRegistry: \u043A\u043B\u0430\u0441\u0441 ${cls.name} \u0443\u0436\u0435 \u0437\u0430\u0440\u0435\u0433\u0438\u0441\u0442\u0440\u0438\u0440\u043E\u0432\u0430\u043D \u043F\u043E\u0434 \u0431\u0430\u043A\u0435\u0442\u043E\u043C '${existing.name}', \u043F\u043E\u0432\u0442\u043E\u0440\u043D\u0430\u044F \u0440\u0435\u0433\u0438\u0441\u0442\u0440\u0430\u0446\u0438\u044F \u043F\u043E\u0434 '${spec.name}' \u0437\u0430\u043F\u0440\u0435\u0449\u0435\u043D\u0430`
       );
     }
@@ -298,6 +442,7 @@ function bucketProvidersFor(fileStoragePortToken, consumers) {
     const spec = BucketRegistry.get(cls);
     if (!spec) {
       throw new Error(
+        // i18n-ignore: ошибка объявления хранилища при старте, до пайщика не доходит
         `bucketProvidersFor: \u043A\u043B\u0430\u0441\u0441 ${cls.name} \u043D\u0435 \u043F\u043E\u043C\u0435\u0447\u0435\u043D @UseBucket \u2014 \u043E\u0431\u044A\u044F\u0432\u0438\u0442\u0435 \u0445\u0440\u0430\u043D\u0438\u043B\u0438\u0449\u0435 \u0440\u044F\u0434\u043E\u043C \u0441 \u0441\u0435\u0440\u0432\u0438\u0441\u043E\u043C`
       );
     }
@@ -655,7 +800,7 @@ __decorateClass$a([
   graphql.Field(() => String, { description: "\u0421\u0440\u043E\u043A \u0438\u0441\u043F\u043E\u043B\u043D\u0435\u043D\u0438\u044F (\xAB\u0432 \u0441\u0440\u043E\u043A \u0434\u043E\xBB), \u0444\u043E\u0440\u043C\u0430\u0442 DD.MM.YYYY" }),
   classValidator.IsString(),
   classValidator.Matches(/^\d{2}\.\d{2}\.\d{4}$/, {
-    message: "\u0423\u043A\u0430\u0436\u0438\u0442\u0435 \u0441\u0440\u043E\u043A \u0438\u0441\u043F\u043E\u043B\u043D\u0435\u043D\u0438\u044F \u0440\u0430\u0441\u0445\u043E\u0434\u0430 \u0432 \u0444\u043E\u0440\u043C\u0430\u0442\u0435 \u0414\u0414.\u041C\u041C.\u0413\u0413\u0413\u0413"
+    message: validationMessage("kit.expenseStatement.dueDateFormat")
   })
 ], ExpenseProposalHeaderInputDTO.prototype, "deadline", 2);
 __decorateClass$a([
@@ -882,6 +1027,7 @@ let entities;
 function registerExtensionEntities(list) {
   if (entities) {
     throw new Error(
+      // i18n-ignore: ошибка сборки приложения при старте, до пайщика не доходит
       "\u0421\u043E\u0441\u0442\u0430\u0432 \u0442\u0430\u0431\u043B\u0438\u0446 \u0440\u0430\u0441\u0448\u0438\u0440\u0435\u043D\u0438\u0439 \u0443\u0436\u0435 \u043E\u0431\u044A\u044F\u0432\u043B\u0435\u043D: registerExtensionEntities() \u0432\u044B\u0437\u044B\u0432\u0430\u0435\u0442\u0441\u044F \u043E\u0434\u0438\u043D \u0440\u0430\u0437 \u043F\u0440\u0438 \u0441\u0442\u0430\u0440\u0442\u0435"
     );
   }
@@ -894,6 +1040,23 @@ function resetExtensionEntities() {
   entities = void 0;
 }
 
+let migrations;
+function registerExtensionDatabaseMigrations(list) {
+  if (migrations) {
+    throw new Error(
+      // i18n-ignore: ошибка сборки composition root для разработчика, до пайщика не доходит
+      "\u041C\u0438\u0433\u0440\u0430\u0446\u0438\u0438 \u0442\u0430\u0431\u043B\u0438\u0446 \u0440\u0430\u0441\u0448\u0438\u0440\u0435\u043D\u0438\u0439 \u0443\u0436\u0435 \u043E\u0431\u044A\u044F\u0432\u043B\u0435\u043D\u044B: registerExtensionDatabaseMigrations() \u0432\u044B\u0437\u044B\u0432\u0430\u0435\u0442\u0441\u044F \u043E\u0434\u0438\u043D \u0440\u0430\u0437 \u043F\u0440\u0438 \u0441\u0442\u0430\u0440\u0442\u0435"
+    );
+  }
+  migrations = [...list];
+}
+function extensionDatabaseMigrations() {
+  return migrations ?? [];
+}
+function resetExtensionDatabaseMigrations() {
+  migrations = void 0;
+}
+
 var __defProp$7 = Object.defineProperty;
 var __getOwnPropDesc$7 = Object.getOwnPropertyDescriptor;
 var __decorateClass$7 = (decorators, target, key, kind) => {
@@ -905,6 +1068,7 @@ var __decorateClass$7 = (decorators, target, key, kind) => {
     __defProp$7(target, key, result);
   return result;
 };
+const SORT_FIELD_PATTERN = /^([A-Za-z_][A-Za-z0-9_]*(:(asc|desc))?)?$/i;
 exports.PaginationInputDTO = class PaginationInputDTO {
 };
 __decorateClass$7([
@@ -914,7 +1078,9 @@ __decorateClass$7([
   graphql.Field(() => graphql.Int, { description: "\u041A\u043E\u043B\u0438\u0447\u0435\u0441\u0442\u0432\u043E \u044D\u043B\u0435\u043C\u0435\u043D\u0442\u043E\u0432 \u043D\u0430 \u0441\u0442\u0440\u0430\u043D\u0438\u0446\u0435", defaultValue: 10 })
 ], exports.PaginationInputDTO.prototype, "limit", 2);
 __decorateClass$7([
-  graphql.Field(() => String, { nullable: true, description: '\u041A\u043B\u044E\u0447 \u0441\u043E\u0440\u0442\u0438\u0440\u043E\u0432\u043A\u0438 (\u043D\u0430\u043F\u0440\u0438\u043C\u0435\u0440, "name")' })
+  graphql.Field(() => String, { nullable: true, description: '\u041A\u043B\u044E\u0447 \u0441\u043E\u0440\u0442\u0438\u0440\u043E\u0432\u043A\u0438 (\u043D\u0430\u043F\u0440\u0438\u043C\u0435\u0440, "name")' }),
+  classValidator.IsOptional(),
+  classValidator.Matches(SORT_FIELD_PATTERN, { message: validationMessage("kit.pagination.invalidSortField") })
 ], exports.PaginationInputDTO.prototype, "sortBy", 2);
 __decorateClass$7([
   graphql.Field(() => String, {
@@ -988,13 +1154,16 @@ class PaginationUtils {
   static validatePaginationOptions(options) {
     const { page = 1, limit = 10, sortBy, sortOrder = "ASC" } = options;
     if (page < 1) {
-      throw new Error("\u041D\u043E\u043C\u0435\u0440 \u0441\u0442\u0440\u0430\u043D\u0438\u0446\u044B \u0434\u043E\u043B\u0436\u0435\u043D \u0431\u044B\u0442\u044C \u0431\u043E\u043B\u044C\u0448\u0435 0");
+      throw DomainError.internal("KIT_PAGE_NUMBER_INVALID");
     }
     if (limit < 1 || limit > 1e3) {
-      throw new Error("\u041A\u043E\u043B\u0438\u0447\u0435\u0441\u0442\u0432\u043E \u044D\u043B\u0435\u043C\u0435\u043D\u0442\u043E\u0432 \u043D\u0430 \u0441\u0442\u0440\u0430\u043D\u0438\u0446\u0435 \u0434\u043E\u043B\u0436\u043D\u043E \u0431\u044B\u0442\u044C \u043E\u0442 1 \u0434\u043E 1000");
+      throw DomainError.internal("KIT_PAGE_LIMIT_INVALID");
     }
     if (sortOrder !== "ASC" && sortOrder !== "DESC") {
-      throw new Error("\u041D\u0430\u043F\u0440\u0430\u0432\u043B\u0435\u043D\u0438\u0435 \u0441\u043E\u0440\u0442\u0438\u0440\u043E\u0432\u043A\u0438 \u0434\u043E\u043B\u0436\u043D\u043E \u0431\u044B\u0442\u044C ASC \u0438\u043B\u0438 DESC");
+      throw DomainError.internal("KIT_SORT_ORDER_INVALID");
+    }
+    if (sortBy !== void 0 && sortBy !== null && !SORT_FIELD_PATTERN.test(sortBy)) {
+      throw DomainError.internal("KIT_SORT_FIELD_INVALID");
     }
     return {
       page,
@@ -1124,6 +1293,7 @@ function configurePlatformSettings(value) {
 function platformSettings() {
   if (!settings) {
     throw new Error(
+      // i18n-ignore: ошибка сборки приложения при старте, до пайщика не доходит
       "\u041D\u0430\u0441\u0442\u0440\u043E\u0439\u043A\u0438 \u043A\u043E\u043D\u0442\u0443\u0440\u0430 \u043D\u0435 \u0437\u0430\u0434\u0430\u043D\u044B: composition root \u043E\u0431\u044F\u0437\u0430\u043D \u0432\u044B\u0437\u0432\u0430\u0442\u044C configurePlatformSettings() \u043F\u0440\u0438 \u0441\u0442\u0430\u0440\u0442\u0435"
     );
   }
@@ -1341,19 +1511,6 @@ exports.DocumentAggregateDTO = __decorateClass$1([
   graphql.ObjectType("DocumentAggregate")
 ], exports.DocumentAggregateDTO);
 
-class HttpApiError extends common.HttpException {
-  constructor(statusCode, message, isOperational = true, stack, subcode) {
-    super(message, statusCode);
-    this.isOperational = isOperational;
-    this.subcode = subcode;
-    if (stack) {
-      this.stack = stack;
-    } else {
-      Error.captureStackTrace(this, this.constructor);
-    }
-  }
-}
-
 class CurrencyValidationUtil {
   /**
    * Проверяет, что сумма содержит правильный символ валюты
@@ -1373,10 +1530,10 @@ class CurrencyValidationUtil {
    * @param fieldName Название поля для сообщения об ошибке (по умолчанию "сумма")
    * @throws Error если символ валюты неправильный
    */
-  static validateCurrencySymbol(amount, fieldName = "\u0441\u0443\u043C\u043C\u0430") {
+  static validateCurrencySymbol(amount, fieldName = server.t("kit.currency.defaultFieldName")) {
     if (!this.hasValidCurrencySymbol(amount)) {
       const expectedSymbol = platformSettings().blockchain.rootGovernSymbol;
-      throw new Error(`\u041D\u0435\u0432\u0435\u0440\u043D\u044B\u0439 \u0441\u0438\u043C\u0432\u043E\u043B \u0432\u0430\u043B\u044E\u0442\u044B \u0432 ${fieldName}. \u041E\u0436\u0438\u0434\u0430\u043B\u0441\u044F: ${expectedSymbol}`);
+      throw DomainError.internal("KIT_CURRENCY_SYMBOL_INVALID", { fieldName, expectedSymbol });
     }
   }
   /**
@@ -1420,18 +1577,12 @@ class CurrencyValidationUtil {
 async function verifySignedDocumentAgainstStoredDraft(loadGeneratedByDocHash, signed, metaVerifications) {
   const generated = await loadGeneratedByDocHash(signed.doc_hash);
   if (!generated) {
-    throw new HttpApiError(
-      common.HttpStatus.BAD_REQUEST,
-      `\u0421\u0433\u0435\u043D\u0435\u0440\u0438\u0440\u043E\u0432\u0430\u043D\u043D\u044B\u0439 \u0434\u043E\u043A\u0443\u043C\u0435\u043D\u0442 \u0441 \u0445\u0435\u0448\u0435\u043C ${signed.doc_hash} \u043D\u0435 \u043D\u0430\u0439\u0434\u0435\u043D. \u0421\u043D\u0430\u0447\u0430\u043B\u0430 \u0441\u0433\u0435\u043D\u0435\u0440\u0438\u0440\u0443\u0439\u0442\u0435 \u0434\u043E\u043A\u0443\u043C\u0435\u043D\u0442.`
-    );
+    throw DomainError.badRequest("KIT_GENERATED_DOCUMENT_NOT_FOUND", { docHash: signed.doc_hash });
   }
   const comparison = await sdk.Classes.Document.compareDocuments(signed, generated);
   if (!comparison.isValid) {
-    const differences = Object.entries(comparison.differences).map(([field, values]) => `${field}: \u043E\u0436\u0438\u0434\u0430\u043B\u043E\u0441\u044C "${values.expected}", \u043F\u043E\u043B\u0443\u0447\u0435\u043D\u043E "${values.actual}"`).join("; ");
-    throw new HttpApiError(
-      common.HttpStatus.BAD_REQUEST,
-      `\u0421\u0432\u0435\u0440\u043A\u0430 \u043F\u043E\u0434\u043F\u0438\u0441\u0430\u043D\u043D\u043E\u0433\u043E \u0434\u043E\u043A\u0443\u043C\u0435\u043D\u0442\u0430 \u0441 \u0447\u0435\u0440\u043D\u043E\u0432\u0438\u043A\u043E\u043C \u043D\u0435 \u043F\u0440\u043E\u0448\u043B\u0430: ${differences}. \u0412\u043E\u0437\u043C\u043E\u0436\u043D\u0430 \u043F\u043E\u0434\u043C\u0435\u043D\u0430 \u0434\u043E\u043A\u0443\u043C\u0435\u043D\u0442\u0430.`
-    );
+    const differences = Object.entries(comparison.differences).map(([field, values]) => server.t("kit.documentVerification.fieldDifference", { field, expected: values.expected, actual: values.actual })).join("; ");
+    throw DomainError.badRequest("KIT_DOCUMENT_DRAFT_MISMATCH", { differences });
   }
   if (!metaVerifications || metaVerifications.length === 0) {
     return;
@@ -1441,10 +1592,7 @@ async function verifySignedDocumentAgainstStoredDraft(loadGeneratedByDocHash, si
     const raw = meta[field];
     const actualStr = typeof raw === "string" ? raw.trim() : raw !== void 0 && raw !== null ? String(raw).trim() : "";
     if (!actualStr) {
-      throw new HttpApiError(
-        common.HttpStatus.BAD_REQUEST,
-        `\u0412 \u043C\u0435\u0442\u0430\u0434\u0430\u043D\u043D\u044B\u0445 \u0434\u043E\u043A\u0443\u043C\u0435\u043D\u0442\u0430 \u043E\u0442\u0441\u0443\u0442\u0441\u0442\u0432\u0443\u0435\u0442 \u043F\u043E\u043B\u0435 \xAB${field}\xBB, \u0442\u0440\u0435\u0431\u0443\u0435\u043C\u043E\u0435 \u0434\u043B\u044F \u0441\u0432\u0435\u0440\u043A\u0438.`
-      );
+      throw DomainError.badRequest("KIT_DOCUMENT_META_FIELD_MISSING", { field });
     }
     const expectedTrimmed = expected.trim();
     switch (mode) {
@@ -1452,39 +1600,27 @@ async function verifySignedDocumentAgainstStoredDraft(loadGeneratedByDocHash, si
         const parsedExpected = CurrencyValidationUtil.extractAmountValue(expectedTrimmed);
         const parsedActual = CurrencyValidationUtil.extractAmountValue(actualStr);
         if (Number.isNaN(parsedExpected) || Number.isNaN(parsedActual)) {
-          throw new HttpApiError(
-            common.HttpStatus.BAD_REQUEST,
-            `\u041D\u0435\u043A\u043E\u0440\u0440\u0435\u043A\u0442\u043D\u044B\u0439 \u0444\u043E\u0440\u043C\u0430\u0442 \u0441\u0443\u043C\u043C\u044B \u0432 \u043F\u043E\u043B\u0435 \xAB${field}\xBB \u0438\u043B\u0438 \u0432 \u043E\u0436\u0438\u0434\u0430\u0435\u043C\u043E\u043C \u0437\u043D\u0430\u0447\u0435\u043D\u0438\u0438.`
-          );
+          throw DomainError.badRequest("KIT_DOCUMENT_AMOUNT_FORMAT_INVALID", { field });
         }
         if (CurrencyValidationUtil.formatAmount(parsedExpected) !== CurrencyValidationUtil.formatAmount(parsedActual)) {
-          throw new HttpApiError(
-            common.HttpStatus.BAD_REQUEST,
-            `\u0417\u043D\u0430\u0447\u0435\u043D\u0438\u0435 \u043F\u043E\u043B\u044F \xAB${field}\xBB \u0432 \u0434\u043E\u043A\u0443\u043C\u0435\u043D\u0442\u0435 (${actualStr}) \u043D\u0435 \u0441\u043E\u0432\u043F\u0430\u0434\u0430\u0435\u0442 \u0441 \u043E\u0436\u0438\u0434\u0430\u0435\u043C\u044B\u043C (${expectedTrimmed}). \u0412\u043E\u0437\u043C\u043E\u0436\u043D\u0430 \u043F\u043E\u0434\u043C\u0435\u043D\u0430 \u0434\u043E\u043A\u0443\u043C\u0435\u043D\u0442\u0430.`
-          );
+          throw DomainError.badRequest("KIT_DOCUMENT_FIELD_MISMATCH", { field, actual: actualStr, expected: expectedTrimmed });
         }
         break;
       }
       case "string_trim": {
         if (actualStr !== expectedTrimmed) {
-          throw new HttpApiError(
-            common.HttpStatus.BAD_REQUEST,
-            `\u0417\u043D\u0430\u0447\u0435\u043D\u0438\u0435 \u043F\u043E\u043B\u044F \xAB${field}\xBB \u0432 \u0434\u043E\u043A\u0443\u043C\u0435\u043D\u0442\u0435 (${actualStr}) \u043D\u0435 \u0441\u043E\u0432\u043F\u0430\u0434\u0430\u0435\u0442 \u0441 \u043E\u0436\u0438\u0434\u0430\u0435\u043C\u044B\u043C (${expectedTrimmed}). \u0412\u043E\u0437\u043C\u043E\u0436\u043D\u0430 \u043F\u043E\u0434\u043C\u0435\u043D\u0430 \u0434\u043E\u043A\u0443\u043C\u0435\u043D\u0442\u0430.`
-          );
+          throw DomainError.badRequest("KIT_DOCUMENT_FIELD_MISMATCH", { field, actual: actualStr, expected: expectedTrimmed });
         }
         break;
       }
       case "hex_case_insensitive": {
         if (actualStr.toLowerCase() !== expectedTrimmed.toLowerCase()) {
-          throw new HttpApiError(
-            common.HttpStatus.BAD_REQUEST,
-            `\u0417\u043D\u0430\u0447\u0435\u043D\u0438\u0435 \u043F\u043E\u043B\u044F \xAB${field}\xBB \u0432 \u0434\u043E\u043A\u0443\u043C\u0435\u043D\u0442\u0435 (${actualStr}) \u043D\u0435 \u0441\u043E\u0432\u043F\u0430\u0434\u0430\u0435\u0442 \u0441 \u043E\u0436\u0438\u0434\u0430\u0435\u043C\u044B\u043C (${expectedTrimmed}). \u0412\u043E\u0437\u043C\u043E\u0436\u043D\u0430 \u043F\u043E\u0434\u043C\u0435\u043D\u0430 \u0434\u043E\u043A\u0443\u043C\u0435\u043D\u0442\u0430.`
-          );
+          throw DomainError.badRequest("KIT_DOCUMENT_FIELD_MISMATCH", { field, actual: actualStr, expected: expectedTrimmed });
         }
         break;
       }
       default:
-        throw new HttpApiError(common.HttpStatus.INTERNAL_SERVER_ERROR, `\u041D\u0435\u0438\u0437\u0432\u0435\u0441\u0442\u043D\u044B\u0439 \u0440\u0435\u0436\u0438\u043C \u0441\u0440\u0430\u0432\u043D\u0435\u043D\u0438\u044F meta: ${String(mode)}`);
+        throw DomainError.internal("KIT_DOCUMENT_COMPARE_MODE_UNKNOWN", { mode: String(mode) });
     }
   }
 }
@@ -1541,12 +1677,12 @@ exports.DomainToBlockchainUtils = class DomainToBlockchainUtils {
   formatQuantityWithPrecision(quantity) {
     const parts = quantity.split(" ");
     if (parts.length !== 2) {
-      throw new Error(`\u041D\u0435\u0432\u0435\u0440\u043D\u044B\u0439 \u0444\u043E\u0440\u043C\u0430\u0442 quantity: ${quantity}. \u041E\u0436\u0438\u0434\u0430\u0435\u0442\u0441\u044F "\u0447\u0438\u0441\u043B\u043E \u0441\u0438\u043C\u0432\u043E\u043B"`);
+      throw DomainError.internal("KIT_QUANTITY_FORMAT_INVALID", { quantity });
     }
     const [amount, symbol] = parts;
     const numericAmount = parseFloat(amount);
     if (isNaN(numericAmount)) {
-      throw new Error(`\u041D\u0435\u043A\u043E\u0440\u0440\u0435\u043A\u0442\u043D\u043E\u0435 \u0447\u0438\u0441\u043B\u043E\u0432\u043E\u0435 \u0437\u043D\u0430\u0447\u0435\u043D\u0438\u0435 \u0432 quantity: ${amount}`);
+      throw DomainError.internal("KIT_QUANTITY_AMOUNT_INVALID", { amount });
     }
     const { rootSymbol, rootPrecision, rootGovernSymbol, rootGovernPrecision } = platformSettings().blockchain;
     let precision;
@@ -1555,7 +1691,7 @@ exports.DomainToBlockchainUtils = class DomainToBlockchainUtils {
     } else if (symbol === rootGovernSymbol) {
       precision = rootGovernPrecision;
     } else {
-      throw new Error(`\u041D\u0435\u043F\u043E\u0434\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u0435\u043C\u044B\u0439 \u0441\u0438\u043C\u0432\u043E\u043B: ${symbol}. \u041F\u043E\u0434\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u044E\u0442\u0441\u044F \u0442\u043E\u043B\u044C\u043A\u043E: ${rootSymbol}, ${rootGovernSymbol}`);
+      throw DomainError.internal("KIT_SYMBOL_UNSUPPORTED", { symbol, rootSymbol, rootGovernSymbol });
     }
     return `${numericAmount.toFixed(precision)} ${symbol}`;
   }
@@ -1563,10 +1699,10 @@ exports.DomainToBlockchainUtils = class DomainToBlockchainUtils {
   formatNumericStringToAssetString(numericString, precision, symbol) {
     const numericValue = parseFloat(numericString);
     if (isNaN(numericValue)) {
-      throw new Error(`\u041D\u0435\u043A\u043E\u0440\u0440\u0435\u043A\u0442\u043D\u043E\u0435 \u0447\u0438\u0441\u043B\u043E\u0432\u043E\u0435 \u0437\u043D\u0430\u0447\u0435\u043D\u0438\u0435: ${numericString}`);
+      throw DomainError.internal("KIT_NUMBER_INVALID", { value: numericString });
     }
     if (numericValue < 0) {
-      throw new Error(`\u0417\u043D\u0430\u0447\u0435\u043D\u0438\u0435 \u043D\u0435 \u043C\u043E\u0436\u0435\u0442 \u0431\u044B\u0442\u044C \u043E\u0442\u0440\u0438\u0446\u0430\u0442\u0435\u043B\u044C\u043D\u044B\u043C: ${numericString}`);
+      throw DomainError.internal("KIT_NUMBER_NEGATIVE", { value: numericString });
     }
     return `${numericValue.toFixed(precision)} ${symbol}`;
   }
@@ -1597,6 +1733,19 @@ exports.DomainToBlockchainUtils = __decorateClass([
   common.Injectable()
 ], exports.DomainToBlockchainUtils);
 
+const DIGEST_RE = /^[0-9a-f]{64}$/;
+function chainTextDigest(text) {
+  if (!text)
+    return "";
+  return crypto.createHash("sha256").update(text, "utf8").digest("hex");
+}
+function isChainTextDigest(value) {
+  return typeof value === "string" && DIGEST_RE.test(value);
+}
+function resolveChainText(chainValue, current) {
+  return isChainTextDigest(chainValue) ? current ?? "" : chainValue;
+}
+
 class AssetUtils {
   /**
    * Парсит строку ассета и возвращает числовое значение и символ
@@ -1683,17 +1832,17 @@ class AmountFormatterUtils {
    */
   static formatAmount(amountStr) {
     if (!amountStr || typeof amountStr !== "string") {
-      throw new Error(`\u041D\u0435\u0432\u0435\u0440\u043D\u044B\u0439 \u0444\u043E\u0440\u043C\u0430\u0442 \u0441\u0443\u043C\u043C\u044B: ${amountStr}. \u041E\u0436\u0438\u0434\u0430\u0435\u0442\u0441\u044F "\u0447\u0438\u0441\u043B\u043E" \u0438\u043B\u0438 "\u0447\u0438\u0441\u043B\u043E \u0432\u0430\u043B\u044E\u0442\u0430"`);
+      throw DomainError.internal("KIT_AMOUNT_FORMAT_INVALID", { amount: amountStr });
     }
     const parts = amountStr.trim().split(/\s+/);
     if (parts.length < 1 || !parts[0]) {
-      throw new Error(`\u041D\u0435\u0432\u0435\u0440\u043D\u044B\u0439 \u0444\u043E\u0440\u043C\u0430\u0442 \u0441\u0443\u043C\u043C\u044B: ${amountStr}. \u041E\u0436\u0438\u0434\u0430\u0435\u0442\u0441\u044F "\u0447\u0438\u0441\u043B\u043E" \u0438\u043B\u0438 "\u0447\u0438\u0441\u043B\u043E \u0432\u0430\u043B\u044E\u0442\u0430"`);
+      throw DomainError.internal("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 new Error(`\u041D\u0435\u043A\u043E\u0440\u0440\u0435\u043A\u0442\u043D\u043E\u0435 \u0447\u0438\u0441\u043B\u043E\u0432\u043E\u0435 \u0437\u043D\u0430\u0447\u0435\u043D\u0438\u0435 \u0432 \u0441\u0443\u043C\u043C\u0435: ${parts[0]}`);
+      throw DomainError.internal("KIT_AMOUNT_NUMBER_INVALID", { value: parts[0] });
     }
     const formattedAmount = amount.toLocaleString("ru-RU", {
       minimumFractionDigits: 2,
@@ -1738,7 +1887,7 @@ function checkPaymentAmount(incomeAmount, expectedAmount, tolerancePercentage) {
   if (incomeAmount < expectedAmount - tolerance) {
     return {
       status: "error",
-      message: `\u041D\u0435\u0434\u043E\u0441\u0442\u0430\u0442\u043E\u0447\u043D\u043E \u0441\u0440\u0435\u0434\u0441\u0442\u0432, \u043F\u043E\u0441\u0442\u0443\u043F\u0438\u043B\u043E: ${incomeAmount}, \u043E\u0436\u0438\u0434\u0430\u0435\u0442\u0441\u044F: ${expectedAmount}`
+      message: server.t("kit.payments.insufficientFunds", { income: incomeAmount, expected: expectedAmount })
     };
   }
   return {
@@ -1769,7 +1918,7 @@ class QuantityUtils {
     } else if (symbol === rootGovernSymbol) {
       return rootGovernPrecision;
     } else {
-      throw new Error(`\u041D\u0435\u043F\u043E\u0434\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u0435\u043C\u044B\u0439 \u0441\u0438\u043C\u0432\u043E\u043B: ${symbol}. \u041F\u043E\u0434\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u044E\u0442\u0441\u044F \u0442\u043E\u043B\u044C\u043A\u043E: ${rootSymbol}, ${rootGovernSymbol}`);
+      throw DomainError.internal("KIT_SYMBOL_UNSUPPORTED", { symbol, rootSymbol, rootGovernSymbol });
     }
   }
   /**
@@ -1779,7 +1928,7 @@ class QuantityUtils {
   static validateSymbol(symbol) {
     if (!this.isSupportedSymbol(symbol)) {
       const { rootSymbol, rootGovernSymbol } = platformSettings().blockchain;
-      throw new Error(`\u041D\u0435\u043F\u043E\u0434\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u0435\u043C\u044B\u0439 \u0441\u0438\u043C\u0432\u043E\u043B: ${symbol}. \u041F\u043E\u0434\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u044E\u0442\u0441\u044F \u0442\u043E\u043B\u044C\u043A\u043E: ${rootSymbol}, ${rootGovernSymbol}`);
+      throw DomainError.internal("KIT_SYMBOL_UNSUPPORTED", { symbol, rootSymbol, rootGovernSymbol });
     }
   }
   /**
@@ -1791,7 +1940,7 @@ class QuantityUtils {
   static formatQuantityForBlockchain(amount, symbol) {
     this.validateSymbol(symbol);
     if (isNaN(amount) || amount < 0) {
-      throw new Error(`\u041D\u0435\u043A\u043E\u0440\u0440\u0435\u043A\u0442\u043D\u043E\u0435 \u0447\u0438\u0441\u043B\u043E\u0432\u043E\u0435 \u0437\u043D\u0430\u0447\u0435\u043D\u0438\u0435: ${amount}`);
+      throw DomainError.internal("KIT_NUMBER_INVALID", { value: amount });
     }
     const precision = this.getPrecisionForSymbol(symbol);
     const formattedAmount = amount.toFixed(precision);
@@ -1806,7 +1955,7 @@ class QuantityUtils {
   static combineQuantityAndSymbol(amount, symbol) {
     this.validateSymbol(symbol);
     if (isNaN(amount) || amount < 0) {
-      throw new Error(`\u041D\u0435\u043A\u043E\u0440\u0440\u0435\u043A\u0442\u043D\u043E\u0435 \u0447\u0438\u0441\u043B\u043E\u0432\u043E\u0435 \u0437\u043D\u0430\u0447\u0435\u043D\u0438\u0435: ${amount}`);
+      throw DomainError.internal("KIT_NUMBER_INVALID", { value: amount });
     }
     return `${amount} ${symbol}`;
   }
@@ -1818,12 +1967,12 @@ class QuantityUtils {
   static parseQuantityString(quantity) {
     const parts = quantity.split(" ");
     if (parts.length !== 2) {
-      throw new Error(`\u041D\u0435\u0432\u0435\u0440\u043D\u044B\u0439 \u0444\u043E\u0440\u043C\u0430\u0442 quantity: ${quantity}. \u041E\u0436\u0438\u0434\u0430\u0435\u0442\u0441\u044F "\u0447\u0438\u0441\u043B\u043E \u0441\u0438\u043C\u0432\u043E\u043B"`);
+      throw DomainError.internal("KIT_QUANTITY_FORMAT_INVALID", { quantity });
     }
     const [amountStr, symbol] = parts;
     const amount = parseFloat(amountStr);
     if (isNaN(amount)) {
-      throw new Error(`\u041D\u0435\u043A\u043E\u0440\u0440\u0435\u043A\u0442\u043D\u043E\u0435 \u0447\u0438\u0441\u043B\u043E\u0432\u043E\u0435 \u0437\u043D\u0430\u0447\u0435\u043D\u0438\u0435 \u0432 quantity: ${amountStr}`);
+      throw DomainError.internal("KIT_QUANTITY_AMOUNT_INVALID", { amount: amountStr });
     }
     this.validateSymbol(symbol);
     return { amount, symbol };
@@ -1886,14 +2035,29 @@ class DateUtils {
   }
 }
 
-async function waitAfterTransactBeforeChainTableRead() {
-  const ms = platformSettings().blockchain.postTransactChainReadDelayMs;
-  if (typeof ms !== "number" || !Number.isFinite(ms) || ms <= 0) {
-    return;
-  }
-  await new Promise((resolve) => {
-    setTimeout(resolve, ms);
+function waitForEvent(source, event, match, timeoutMs) {
+  let settle;
+  const promise = new Promise((resolve) => {
+    settle = resolve;
   });
+  let done = false;
+  let timer;
+  const listener = (payload) => {
+    if (match(payload))
+      finish(payload);
+  };
+  function finish(value) {
+    if (done)
+      return;
+    done = true;
+    if (timer)
+      clearTimeout(timer);
+    source.off(event, listener);
+    settle(value);
+  }
+  source.on(event, listener);
+  timer = setTimeout(() => finish(null), timeoutMs);
+  return { promise, cancel: () => finish(null) };
 }
 
 function getAppliedBlockNum(transactResult) {
@@ -1920,11 +2084,52 @@ function sanitizeUserText(value) {
   return cooptypes._Common.Text.sanitizeEditorMarkdown(value);
 }
 
+function resolveSortColumn(repository, sortBy, fallback) {
+  if (!sortBy)
+    return fallback;
+  const isKnownColumn = repository.metadata.columns.some(
+    (column) => column.propertyName === sortBy || column.databaseName === sortBy
+  );
+  return isKnownColumn ? sortBy : fallback;
+}
+
+class HttpApiError extends common.HttpException {
+  constructor(statusCode, message, isOperational = true, stack, subcode) {
+    super(message, statusCode);
+    this.isOperational = isOperational;
+    this.subcode = subcode;
+    if (stack) {
+      this.stack = stack;
+    } else {
+      Error.captureStackTrace(this, this.constructor);
+    }
+  }
+}
+
+const ASSERT_PREFIX = /assertion failure with message: (.+?)(?:\n|$)/;
+const CODED = /^([A-Z][A-Z0-9]*(?:_[A-Z0-9]+)+):\s*(.*)$/s;
+function parseChainAssert(message) {
+  const assert = message.match(ASSERT_PREFIX);
+  const body = (assert ? assert[1] : message).trim();
+  const coded = body.match(CODED);
+  return coded ? { code: coded[1], text: coded[2].trim() } : { text: body };
+}
+function chainErrorCode(error) {
+  if (error instanceof DomainError) {
+    if (error.code !== "CHAIN_ASSERT" && error.code !== "CHAIN_ERROR")
+      return error.code;
+    return typeof error.params.message === "string" ? parseChainAssert(error.params.message).code : void 0;
+  }
+  const raw = error?.message ?? String(error);
+  return parseChainAssert(raw).code;
+}
 function rethrowChainError(error) {
   const raw = error?.message ?? String(error);
-  const match = raw.match(/assertion failure with message: (.+?)(?:\n|$)/);
-  const clean = match ? match[1].trim() : raw;
-  throw new common.BadRequestException(clean);
+  const match = raw.match(ASSERT_PREFIX);
+  if (!match)
+    throw DomainError.badRequest("CHAIN_ERROR", { message: raw });
+  const { code, text } = parseChainAssert(raw);
+  throw DomainError.badRequest(code ?? "CHAIN_ASSERT", { message: text });
 }
 
 exports.AmountFormatterUtils = AmountFormatterUtils;
@@ -1936,6 +2141,7 @@ exports.CurrencyValidationUtil = CurrencyValidationUtil;
 exports.CurrentUser = CurrentUser;
 exports.DEFAULT_DOCUMENT_VERSION = DEFAULT_DOCUMENT_VERSION;
 exports.DateUtils = DateUtils;
+exports.DomainError = DomainError;
 exports.EMPTY_HASH = EMPTY_HASH;
 exports.EXTENSION_APP_TERMINATE_EVENT = EXTENSION_APP_TERMINATE_EVENT;
 exports.EXTENSION_REPOSITORY = EXTENSION_REPOSITORY;
@@ -1957,16 +2163,21 @@ exports.PaginationUtils = PaginationUtils;
 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.UseBucket = UseBucket;
 exports.bucketProvidersFor = bucketProvidersFor;
 exports.bucketTokenFor = bucketTokenFor;
 exports.buildPaginationResult = buildPaginationResult;
+exports.chainErrorCode = chainErrorCode;
+exports.chainTextDigest = chainTextDigest;
 exports.checkPaymentAmount = checkPaymentAmount;
 exports.checkPaymentSymbol = checkPaymentSymbol;
 exports.computeOnboardingExpiresAt = computeOnboardingExpiresAt;
 exports.configureExtensionAuth = configureExtensionAuth;
 exports.configurePlatformSettings = configurePlatformSettings;
 exports.createPaginationResult = createPaginationResult;
+exports.domainErrorMessage = domainErrorMessage;
+exports.extensionDatabaseMigrations = extensionDatabaseMigrations;
 exports.extensionEntities = extensionEntities;
 exports.generateHashFromString = generateHashFromString;
 exports.generateRandomHash = generateRandomHash;
@@ -1974,15 +2185,22 @@ exports.generateUniqueHash = generateUniqueHash;
 exports.getAmountPlusFee = getAmountPlusFee;
 exports.getAppliedBlockNum = getAppliedBlockNum;
 exports.hasServerSecret = hasServerSecret;
+exports.isChainTextDigest = isChainTextDigest;
 exports.isExtensionAvailable = isExtensionAvailable;
 exports.mergeSecretConfig = mergeSecretConfig;
 exports.paginationInputToOffset = paginationInputToOffset;
+exports.parseChainAssert = parseChainAssert;
 exports.platformSettings = platformSettings;
 exports.providerSuppliedPaths = providerSuppliedPaths;
 exports.redactSecretConfig = redactSecretConfig;
+exports.registerExtensionDatabaseMigrations = registerExtensionDatabaseMigrations;
 exports.registerExtensionEntities = registerExtensionEntities;
+exports.resetExtensionDatabaseMigrations = resetExtensionDatabaseMigrations;
 exports.resetExtensionEntities = resetExtensionEntities;
+exports.resolveChainText = resolveChainText;
+exports.resolveSortColumn = resolveSortColumn;
 exports.rethrowChainError = rethrowChainError;
 exports.sanitizeUserText = sanitizeUserText;
+exports.validationMessage = validationMessage;
 exports.verifySignedDocumentAgainstStoredDraft = verifySignedDocumentAgainstStoredDraft;
-exports.waitAfterTransactBeforeChainTableRead = waitAfterTransactBeforeChainTableRead;
+exports.waitForEvent = waitForEvent;