@coopenomics/extension-kit 2026.9.16-2 → 2026.9.19

package/dist/index.cjs

@@ -4,6 +4,7 @@ const common = require('@nestjs/common');
 const graphql = require('@nestjs/graphql');
 const core = require('@nestjs/core');
 const passport = require('@nestjs/passport');
+const node_crypto = require('node:crypto');
 const zod = require('zod');
 const classValidator = require('class-validator');
 const classTransformer = require('class-transformer');
@@ -14,6 +15,7 @@ const moment = require('moment');
 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; }
 
@@ -22,12 +24,15 @@ const moment__default$1 = /*#__PURE__*/_interopDefaultCompat(moment$1);
 const crypto__default = /*#__PURE__*/_interopDefaultCompat(crypto);
 
 const ROLES_DENY_SELF_KEY = "roles_deny_self";
+const ROLES_ANY_STATUS_KEY = "roles_any_status";
 function AuthRoles(roles, options = {}) {
   const self = options.self ?? [];
   const args = self.length ? `roles: ${JSON.stringify(roles)}, self: ${JSON.stringify(self)}` : `roles: ${JSON.stringify(roles)}`;
   const decorators = [common.SetMetadata("roles", roles), graphql.Directive(`@auth(${args})`)];
   if (options.allowSelf === false)
     decorators.push(common.SetMetadata(ROLES_DENY_SELF_KEY, true));
+  if (options.anyStatus === true)
+    decorators.push(common.SetMetadata(ROLES_ANY_STATUS_KEY, true));
   return common.applyDecorators(...decorators);
 }
 const CurrentUser = common.createParamDecorator((data, context) => {
@@ -52,7 +57,12 @@ function configureExtensionAuth(options) {
 function hasServerSecret(headers) {
   if (!serverSecret)
     return false;
-  return headers?.["server-secret"] === serverSecret;
+  const provided = headers?.["server-secret"];
+  if (typeof provided !== "string")
+    return false;
+  const a = Buffer.from(provided);
+  const b = Buffer.from(serverSecret);
+  return a.length === b.length && node_crypto.timingSafeEqual(a, b);
 }
 
 var __defProp$g = Object.defineProperty;
@@ -67,6 +77,8 @@ var __decorateClass$g = (decorators, target, key, kind) => {
   return result;
 };
 var __decorateParam = (index, decorator) => (target, key) => decorator(target, key, index);
+const ACTIVE_USER_STATUS = "active";
+const PARTICIPANT_ROLE = "user";
 exports.GqlJwtAuthGuard = class GqlJwtAuthGuard extends passport.AuthGuard("jwt") {
   getRequest(context) {
     const ctx = graphql.GqlExecutionContext.create(context);
@@ -158,6 +170,10 @@ exports.RolesGuard = class RolesGuard {
       return true;
     }
     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");
+      }
       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`);
@@ -167,7 +183,6 @@ exports.RolesGuard = __decorateClass$g([
   common.Injectable(),
   __decorateParam(0, common.Inject(core.Reflector))
 ], exports.RolesGuard);
-const ACTIVE_USER_STATUS = "active";
 exports.ActiveUserStatusGuard = class ActiveUserStatusGuard {
   canActivate(context) {
     const ctx = graphql.GqlExecutionContext.create(context);
@@ -1899,6 +1914,12 @@ function generateHashFromString(input) {
   return crypto__default.createHash("sha256").update(input).digest("hex");
 }
 
+function sanitizeUserText(value) {
+  if (typeof value !== "string" || !value)
+    return value;
+  return cooptypes._Common.Text.sanitizeEditorMarkdown(value);
+}
+
 function rethrowChainError(error) {
   const raw = error?.message ?? String(error);
   const match = raw.match(/assertion failure with message: (.+?)(?:\n|$)/);
@@ -1934,6 +1955,7 @@ exports.OptionalCurrentUser = OptionalCurrentUser;
 exports.PaginationResult = PaginationResult;
 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.UseBucket = UseBucket;
 exports.bucketProvidersFor = bucketProvidersFor;
@@ -1961,5 +1983,6 @@ exports.redactSecretConfig = redactSecretConfig;
 exports.registerExtensionEntities = registerExtensionEntities;
 exports.resetExtensionEntities = resetExtensionEntities;
 exports.rethrowChainError = rethrowChainError;
+exports.sanitizeUserText = sanitizeUserText;
 exports.verifySignedDocumentAgainstStoredDraft = verifySignedDocumentAgainstStoredDraft;
 exports.waitAfterTransactBeforeChainTableRead = waitAfterTransactBeforeChainTableRead;

package/dist/index.d.cts

@@ -24,9 +24,20 @@ interface AuthRolesOptions {
      * ставится `false`: иначе пайщик выполнил бы его над собой.
      */
     allowSelf?: boolean;
+    /**
+     * Пускает ли роль `user` пайщика, которого совет ещё не принял (или уже
+     * исключил). По умолчанию нет: `user` в списке ролей означает «принятый
+     * пайщик», и учётная запись со статусом вступления по роли не проходит —
+     * иначе любой, кто заполнил форму регистрации, читал бы реестры кооператива.
+     * `true` — для того, что нужно и кандидату: входящие уведомления о ходе
+     * его же заявления.
+     */
+    anyStatus?: boolean;
 }
 /** Ключ метаданных: самообход `RolesGuard` запрещён. */
 declare const ROLES_DENY_SELF_KEY = "roles_deny_self";
+/** Ключ метаданных: роль `user` проходит в любом статусе учётной записи. */
+declare const ROLES_ANY_STATUS_KEY = "roles_any_status";
 /**
  * Ограничение доступа к резолверу или к отдельному полю объекта.
  *
@@ -99,7 +110,12 @@ declare class HttpJwtAuthGuard extends HttpJwtAuthGuard_base {
  * 3. Пользователь обращается к своим ресурсам (`username` вложенный в `data`/`filter`
  *    либо плоским аргументом совпадает с `user.username`) — разрешено, если
  *    операция не объявила `AuthRoles(..., { allowSelf: false })`.
- * 4. У пользователя есть одна из разрешённых ролей — разрешено.
+ * 4. У пользователя есть одна из разрешённых ролей — разрешено. Роль `user`
+ *    при этом означает принятого пайщика: учётная запись в статусе вступления
+ *    или исключения по ней не проходит (если операция не объявила
+ *    `AuthRoles(..., { anyStatus: true })`). Совет по своей роли проходит в
+ *    любом статусе: членов совета, заведённых при установке, цепь в
+ *    `active` не переводит.
  * 5. Иначе — отказ.
  */
 declare class RolesGuard implements CanActivate {
@@ -833,6 +849,19 @@ interface DeserializedDescriptionOfExtension {
      * Необязательное поле.
      */
     maxRows?: number;
+    /**
+     * Сколько строк многострочное поле показывает сразу, до ввода текста. Поле
+     * растёт по мере ввода, но не бывает ниже этой высоты — по виду сразу понятно,
+     * что ответ ждут развёрнутый. Задание `minRows` само делает поле многострочным.
+     * Необязательное поле.
+     */
+    minRows?: number;
+    /**
+     * Текст-заполнитель внутри пустого поля: пример ответа или формата, чтобы
+     * поле не выглядело пустым. Исчезает, как только человек начинает ввод.
+     * Необязательное поле.
+     */
+    placeholder?: string;
     /**
      * Добавляет текст после значения поля в интерфейсе (например, символ валюты).
      * Необязательное поле.
@@ -1505,6 +1534,21 @@ declare class CurrencyValidationUtil {
     static formatAmount(value: number, precision?: number): string;
 }
 
+/**
+ * Очистка текста, который человек пишет в редакторе: описание проекта или
+ * задачи, приглашение, краткое содержание звонка.
+ *
+ * Правило одно на кабинет и сервер и живёт в `cooptypes`; здесь — только
+ * удобная точка вызова для расширений и обработка пустых значений. До
+ * 17.09.2026 очистка стояла лишь в редакторе, поэтому запрос напрямую в API
+ * клал в базу произвольную разметку, а она потом попадала в собираемые
+ * документы.
+ *
+ * Правило намеренно мягкое: описание живёт вперемешку с разметкой, таблицами и
+ * схемами BPMN — убирается только исполняемое.
+ */
+declare function sanitizeUserText<T extends string | null | undefined>(value: T): T;
+
 /**
  * Ошибка API с кодом состояния HTTP.
  *
@@ -1531,5 +1575,5 @@ declare class HttpApiError extends HttpException {
  */
 declare function rethrowChainError(error: unknown): never;
 
-export { ActiveUserStatusGuard, AmountFormatterUtils, AssetUtils, AuthRoles, BaseExtensionModule, BucketRegistry, CandidateFilterInputDTO, CandidateOutputDTO, CandidateStatus, CurrencyValidationUtil, CurrentUser, DEFAULT_DOCUMENT_VERSION, DateUtils, DocumentAggregateDTO, 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_DENY_SELF_KEY, RolesGuard, SignatureInfoDTO, SignatureInfoInputDTO, SignedDigitalDocumentDTO, SignedDigitalDocumentInputDTO, TransactionDTO, UseBucket, bucketProvidersFor, bucketTokenFor, buildPaginationResult, checkPaymentAmount, checkPaymentSymbol, computeOnboardingExpiresAt, configureExtensionAuth, configurePlatformSettings, createPaginationResult, extensionEntities, generateHashFromString, generateRandomHash, generateUniqueHash, getAmountPlusFee, getAppliedBlockNum, hasServerSecret, isExtensionAvailable, mergeSecretConfig, paginationInputToOffset, platformSettings, providerSuppliedPaths, redactSecretConfig, registerExtensionEntities, resetExtensionEntities, rethrowChainError, verifySignedDocumentAgainstStoredDraft, waitAfterTransactBeforeChainTableRead };
+export { ActiveUserStatusGuard, AmountFormatterUtils, AssetUtils, AuthRoles, BaseExtensionModule, BucketRegistry, CandidateFilterInputDTO, CandidateOutputDTO, CandidateStatus, CurrencyValidationUtil, CurrentUser, DEFAULT_DOCUMENT_VERSION, DateUtils, DocumentAggregateDTO, 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, SignatureInfoDTO, SignatureInfoInputDTO, SignedDigitalDocumentDTO, SignedDigitalDocumentInputDTO, TransactionDTO, UseBucket, bucketProvidersFor, bucketTokenFor, buildPaginationResult, checkPaymentAmount, checkPaymentSymbol, computeOnboardingExpiresAt, configureExtensionAuth, configurePlatformSettings, createPaginationResult, extensionEntities, generateHashFromString, generateRandomHash, generateUniqueHash, getAmountPlusFee, getAppliedBlockNum, hasServerSecret, isExtensionAvailable, mergeSecretConfig, paginationInputToOffset, platformSettings, providerSuppliedPaths, redactSecretConfig, registerExtensionEntities, resetExtensionEntities, rethrowChainError, sanitizeUserText, verifySignedDocumentAgainstStoredDraft, waitAfterTransactBeforeChainTableRead };
 export type { AuthRolesOptions, BucketSource, BucketSpec, DeserializedDescriptionOfExtension, ExcludeCommonProps, ExtensionAppTerminatePayload, ExtensionAuthOptions, ExtensionConfigFieldPolicy, ExtensionConfigPolicy, 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 };

package/dist/index.d.mts

@@ -24,9 +24,20 @@ interface AuthRolesOptions {
      * ставится `false`: иначе пайщик выполнил бы его над собой.
      */
     allowSelf?: boolean;
+    /**
+     * Пускает ли роль `user` пайщика, которого совет ещё не принял (или уже
+     * исключил). По умолчанию нет: `user` в списке ролей означает «принятый
+     * пайщик», и учётная запись со статусом вступления по роли не проходит —
+     * иначе любой, кто заполнил форму регистрации, читал бы реестры кооператива.
+     * `true` — для того, что нужно и кандидату: входящие уведомления о ходе
+     * его же заявления.
+     */
+    anyStatus?: boolean;
 }
 /** Ключ метаданных: самообход `RolesGuard` запрещён. */
 declare const ROLES_DENY_SELF_KEY = "roles_deny_self";
+/** Ключ метаданных: роль `user` проходит в любом статусе учётной записи. */
+declare const ROLES_ANY_STATUS_KEY = "roles_any_status";
 /**
  * Ограничение доступа к резолверу или к отдельному полю объекта.
  *
@@ -99,7 +110,12 @@ declare class HttpJwtAuthGuard extends HttpJwtAuthGuard_base {
  * 3. Пользователь обращается к своим ресурсам (`username` вложенный в `data`/`filter`
  *    либо плоским аргументом совпадает с `user.username`) — разрешено, если
  *    операция не объявила `AuthRoles(..., { allowSelf: false })`.
- * 4. У пользователя есть одна из разрешённых ролей — разрешено.
+ * 4. У пользователя есть одна из разрешённых ролей — разрешено. Роль `user`
+ *    при этом означает принятого пайщика: учётная запись в статусе вступления
+ *    или исключения по ней не проходит (если операция не объявила
+ *    `AuthRoles(..., { anyStatus: true })`). Совет по своей роли проходит в
+ *    любом статусе: членов совета, заведённых при установке, цепь в
+ *    `active` не переводит.
  * 5. Иначе — отказ.
  */
 declare class RolesGuard implements CanActivate {
@@ -833,6 +849,19 @@ interface DeserializedDescriptionOfExtension {
      * Необязательное поле.
      */
     maxRows?: number;
+    /**
+     * Сколько строк многострочное поле показывает сразу, до ввода текста. Поле
+     * растёт по мере ввода, но не бывает ниже этой высоты — по виду сразу понятно,
+     * что ответ ждут развёрнутый. Задание `minRows` само делает поле многострочным.
+     * Необязательное поле.
+     */
+    minRows?: number;
+    /**
+     * Текст-заполнитель внутри пустого поля: пример ответа или формата, чтобы
+     * поле не выглядело пустым. Исчезает, как только человек начинает ввод.
+     * Необязательное поле.
+     */
+    placeholder?: string;
     /**
      * Добавляет текст после значения поля в интерфейсе (например, символ валюты).
      * Необязательное поле.
@@ -1505,6 +1534,21 @@ declare class CurrencyValidationUtil {
     static formatAmount(value: number, precision?: number): string;
 }
 
+/**
+ * Очистка текста, который человек пишет в редакторе: описание проекта или
+ * задачи, приглашение, краткое содержание звонка.
+ *
+ * Правило одно на кабинет и сервер и живёт в `cooptypes`; здесь — только
+ * удобная точка вызова для расширений и обработка пустых значений. До
+ * 17.09.2026 очистка стояла лишь в редакторе, поэтому запрос напрямую в API
+ * клал в базу произвольную разметку, а она потом попадала в собираемые
+ * документы.
+ *
+ * Правило намеренно мягкое: описание живёт вперемешку с разметкой, таблицами и
+ * схемами BPMN — убирается только исполняемое.
+ */
+declare function sanitizeUserText<T extends string | null | undefined>(value: T): T;
+
 /**
  * Ошибка API с кодом состояния HTTP.
  *
@@ -1531,5 +1575,5 @@ declare class HttpApiError extends HttpException {
  */
 declare function rethrowChainError(error: unknown): never;
 
-export { ActiveUserStatusGuard, AmountFormatterUtils, AssetUtils, AuthRoles, BaseExtensionModule, BucketRegistry, CandidateFilterInputDTO, CandidateOutputDTO, CandidateStatus, CurrencyValidationUtil, CurrentUser, DEFAULT_DOCUMENT_VERSION, DateUtils, DocumentAggregateDTO, 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_DENY_SELF_KEY, RolesGuard, SignatureInfoDTO, SignatureInfoInputDTO, SignedDigitalDocumentDTO, SignedDigitalDocumentInputDTO, TransactionDTO, UseBucket, bucketProvidersFor, bucketTokenFor, buildPaginationResult, checkPaymentAmount, checkPaymentSymbol, computeOnboardingExpiresAt, configureExtensionAuth, configurePlatformSettings, createPaginationResult, extensionEntities, generateHashFromString, generateRandomHash, generateUniqueHash, getAmountPlusFee, getAppliedBlockNum, hasServerSecret, isExtensionAvailable, mergeSecretConfig, paginationInputToOffset, platformSettings, providerSuppliedPaths, redactSecretConfig, registerExtensionEntities, resetExtensionEntities, rethrowChainError, verifySignedDocumentAgainstStoredDraft, waitAfterTransactBeforeChainTableRead };
+export { ActiveUserStatusGuard, AmountFormatterUtils, AssetUtils, AuthRoles, BaseExtensionModule, BucketRegistry, CandidateFilterInputDTO, CandidateOutputDTO, CandidateStatus, CurrencyValidationUtil, CurrentUser, DEFAULT_DOCUMENT_VERSION, DateUtils, DocumentAggregateDTO, 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, SignatureInfoDTO, SignatureInfoInputDTO, SignedDigitalDocumentDTO, SignedDigitalDocumentInputDTO, TransactionDTO, UseBucket, bucketProvidersFor, bucketTokenFor, buildPaginationResult, checkPaymentAmount, checkPaymentSymbol, computeOnboardingExpiresAt, configureExtensionAuth, configurePlatformSettings, createPaginationResult, extensionEntities, generateHashFromString, generateRandomHash, generateUniqueHash, getAmountPlusFee, getAppliedBlockNum, hasServerSecret, isExtensionAvailable, mergeSecretConfig, paginationInputToOffset, platformSettings, providerSuppliedPaths, redactSecretConfig, registerExtensionEntities, resetExtensionEntities, rethrowChainError, sanitizeUserText, verifySignedDocumentAgainstStoredDraft, waitAfterTransactBeforeChainTableRead };
 export type { AuthRolesOptions, BucketSource, BucketSpec, DeserializedDescriptionOfExtension, ExcludeCommonProps, ExtensionAppTerminatePayload, ExtensionAuthOptions, ExtensionConfigFieldPolicy, ExtensionConfigPolicy, 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 };

package/dist/index.d.ts

@@ -24,9 +24,20 @@ interface AuthRolesOptions {
      * ставится `false`: иначе пайщик выполнил бы его над собой.
      */
     allowSelf?: boolean;
+    /**
+     * Пускает ли роль `user` пайщика, которого совет ещё не принял (или уже
+     * исключил). По умолчанию нет: `user` в списке ролей означает «принятый
+     * пайщик», и учётная запись со статусом вступления по роли не проходит —
+     * иначе любой, кто заполнил форму регистрации, читал бы реестры кооператива.
+     * `true` — для того, что нужно и кандидату: входящие уведомления о ходе
+     * его же заявления.
+     */
+    anyStatus?: boolean;
 }
 /** Ключ метаданных: самообход `RolesGuard` запрещён. */
 declare const ROLES_DENY_SELF_KEY = "roles_deny_self";
+/** Ключ метаданных: роль `user` проходит в любом статусе учётной записи. */
+declare const ROLES_ANY_STATUS_KEY = "roles_any_status";
 /**
  * Ограничение доступа к резолверу или к отдельному полю объекта.
  *
@@ -99,7 +110,12 @@ declare class HttpJwtAuthGuard extends HttpJwtAuthGuard_base {
  * 3. Пользователь обращается к своим ресурсам (`username` вложенный в `data`/`filter`
  *    либо плоским аргументом совпадает с `user.username`) — разрешено, если
  *    операция не объявила `AuthRoles(..., { allowSelf: false })`.
- * 4. У пользователя есть одна из разрешённых ролей — разрешено.
+ * 4. У пользователя есть одна из разрешённых ролей — разрешено. Роль `user`
+ *    при этом означает принятого пайщика: учётная запись в статусе вступления
+ *    или исключения по ней не проходит (если операция не объявила
+ *    `AuthRoles(..., { anyStatus: true })`). Совет по своей роли проходит в
+ *    любом статусе: членов совета, заведённых при установке, цепь в
+ *    `active` не переводит.
  * 5. Иначе — отказ.
  */
 declare class RolesGuard implements CanActivate {
@@ -833,6 +849,19 @@ interface DeserializedDescriptionOfExtension {
      * Необязательное поле.
      */
     maxRows?: number;
+    /**
+     * Сколько строк многострочное поле показывает сразу, до ввода текста. Поле
+     * растёт по мере ввода, но не бывает ниже этой высоты — по виду сразу понятно,
+     * что ответ ждут развёрнутый. Задание `minRows` само делает поле многострочным.
+     * Необязательное поле.
+     */
+    minRows?: number;
+    /**
+     * Текст-заполнитель внутри пустого поля: пример ответа или формата, чтобы
+     * поле не выглядело пустым. Исчезает, как только человек начинает ввод.
+     * Необязательное поле.
+     */
+    placeholder?: string;
     /**
      * Добавляет текст после значения поля в интерфейсе (например, символ валюты).
      * Необязательное поле.
@@ -1505,6 +1534,21 @@ declare class CurrencyValidationUtil {
     static formatAmount(value: number, precision?: number): string;
 }
 
+/**
+ * Очистка текста, который человек пишет в редакторе: описание проекта или
+ * задачи, приглашение, краткое содержание звонка.
+ *
+ * Правило одно на кабинет и сервер и живёт в `cooptypes`; здесь — только
+ * удобная точка вызова для расширений и обработка пустых значений. До
+ * 17.09.2026 очистка стояла лишь в редакторе, поэтому запрос напрямую в API
+ * клал в базу произвольную разметку, а она потом попадала в собираемые
+ * документы.
+ *
+ * Правило намеренно мягкое: описание живёт вперемешку с разметкой, таблицами и
+ * схемами BPMN — убирается только исполняемое.
+ */
+declare function sanitizeUserText<T extends string | null | undefined>(value: T): T;
+
 /**
  * Ошибка API с кодом состояния HTTP.
  *
@@ -1531,5 +1575,5 @@ declare class HttpApiError extends HttpException {
  */
 declare function rethrowChainError(error: unknown): never;
 
-export { ActiveUserStatusGuard, AmountFormatterUtils, AssetUtils, AuthRoles, BaseExtensionModule, BucketRegistry, CandidateFilterInputDTO, CandidateOutputDTO, CandidateStatus, CurrencyValidationUtil, CurrentUser, DEFAULT_DOCUMENT_VERSION, DateUtils, DocumentAggregateDTO, 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_DENY_SELF_KEY, RolesGuard, SignatureInfoDTO, SignatureInfoInputDTO, SignedDigitalDocumentDTO, SignedDigitalDocumentInputDTO, TransactionDTO, UseBucket, bucketProvidersFor, bucketTokenFor, buildPaginationResult, checkPaymentAmount, checkPaymentSymbol, computeOnboardingExpiresAt, configureExtensionAuth, configurePlatformSettings, createPaginationResult, extensionEntities, generateHashFromString, generateRandomHash, generateUniqueHash, getAmountPlusFee, getAppliedBlockNum, hasServerSecret, isExtensionAvailable, mergeSecretConfig, paginationInputToOffset, platformSettings, providerSuppliedPaths, redactSecretConfig, registerExtensionEntities, resetExtensionEntities, rethrowChainError, verifySignedDocumentAgainstStoredDraft, waitAfterTransactBeforeChainTableRead };
+export { ActiveUserStatusGuard, AmountFormatterUtils, AssetUtils, AuthRoles, BaseExtensionModule, BucketRegistry, CandidateFilterInputDTO, CandidateOutputDTO, CandidateStatus, CurrencyValidationUtil, CurrentUser, DEFAULT_DOCUMENT_VERSION, DateUtils, DocumentAggregateDTO, 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, SignatureInfoDTO, SignatureInfoInputDTO, SignedDigitalDocumentDTO, SignedDigitalDocumentInputDTO, TransactionDTO, UseBucket, bucketProvidersFor, bucketTokenFor, buildPaginationResult, checkPaymentAmount, checkPaymentSymbol, computeOnboardingExpiresAt, configureExtensionAuth, configurePlatformSettings, createPaginationResult, extensionEntities, generateHashFromString, generateRandomHash, generateUniqueHash, getAmountPlusFee, getAppliedBlockNum, hasServerSecret, isExtensionAvailable, mergeSecretConfig, paginationInputToOffset, platformSettings, providerSuppliedPaths, redactSecretConfig, registerExtensionEntities, resetExtensionEntities, rethrowChainError, sanitizeUserText, verifySignedDocumentAgainstStoredDraft, waitAfterTransactBeforeChainTableRead };
 export type { AuthRolesOptions, BucketSource, BucketSpec, DeserializedDescriptionOfExtension, ExcludeCommonProps, ExtensionAppTerminatePayload, ExtensionAuthOptions, ExtensionConfigFieldPolicy, ExtensionConfigPolicy, 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 };

package/dist/index.mjs

@@ -2,6 +2,7 @@ import { createParamDecorator, UnauthorizedException, SetMetadata, applyDecorato
 import { GqlExecutionContext, Directive, Field, InputType, registerEnumType, Int, IntersectionType, OmitType, ObjectType } from '@nestjs/graphql';
 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 { Type } from 'class-transformer';
@@ -12,14 +13,18 @@ import moment from 'moment';
 import moment$1 from 'moment-timezone';
 import 'moment/locale/ru';
 import crypto from 'crypto';
+import { _Common } from 'cooptypes';
 
 const ROLES_DENY_SELF_KEY = "roles_deny_self";
+const ROLES_ANY_STATUS_KEY = "roles_any_status";
 function AuthRoles(roles, options = {}) {
   const self = options.self ?? [];
   const args = self.length ? `roles: ${JSON.stringify(roles)}, self: ${JSON.stringify(self)}` : `roles: ${JSON.stringify(roles)}`;
   const decorators = [SetMetadata("roles", roles), Directive(`@auth(${args})`)];
   if (options.allowSelf === false)
     decorators.push(SetMetadata(ROLES_DENY_SELF_KEY, true));
+  if (options.anyStatus === true)
+    decorators.push(SetMetadata(ROLES_ANY_STATUS_KEY, true));
   return applyDecorators(...decorators);
 }
 const CurrentUser = createParamDecorator((data, context) => {
@@ -44,7 +49,12 @@ function configureExtensionAuth(options) {
 function hasServerSecret(headers) {
   if (!serverSecret)
     return false;
-  return headers?.["server-secret"] === serverSecret;
+  const provided = headers?.["server-secret"];
+  if (typeof provided !== "string")
+    return false;
+  const a = Buffer.from(provided);
+  const b = Buffer.from(serverSecret);
+  return a.length === b.length && timingSafeEqual(a, b);
 }
 
 var __defProp$g = Object.defineProperty;
@@ -59,6 +69,8 @@ var __decorateClass$g = (decorators, target, key, kind) => {
   return result;
 };
 var __decorateParam = (index, decorator) => (target, key) => decorator(target, key, index);
+const ACTIVE_USER_STATUS = "active";
+const PARTICIPANT_ROLE = "user";
 let GqlJwtAuthGuard = class extends AuthGuard("jwt") {
   getRequest(context) {
     const ctx = GqlExecutionContext.create(context);
@@ -150,6 +162,10 @@ let RolesGuard = class {
       return true;
     }
     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 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");
+      }
       return true;
     }
     throw new UnauthorizedException(`\u041D\u0435\u0434\u043E\u0441\u0442\u0430\u0442\u043E\u0447\u043D\u043E \u043F\u0440\u0430\u0432 \u0434\u043E\u0441\u0442\u0443\u043F\u0430`);
@@ -159,7 +175,6 @@ RolesGuard = __decorateClass$g([
   Injectable(),
   __decorateParam(0, Inject(Reflector))
 ], RolesGuard);
-const ACTIVE_USER_STATUS = "active";
 let ActiveUserStatusGuard = class {
   canActivate(context) {
     const ctx = GqlExecutionContext.create(context);
@@ -1891,6 +1906,12 @@ function generateHashFromString(input) {
   return crypto.createHash("sha256").update(input).digest("hex");
 }
 
+function sanitizeUserText(value) {
+  if (typeof value !== "string" || !value)
+    return value;
+  return _Common.Text.sanitizeEditorMarkdown(value);
+}
+
 function rethrowChainError(error) {
   const raw = error?.message ?? String(error);
   const match = raw.match(/assertion failure with message: (.+?)(?:\n|$)/);
@@ -1898,4 +1919,4 @@ function rethrowChainError(error) {
   throw new BadRequestException(clean);
 }
 
-export { ActiveUserStatusGuard, AmountFormatterUtils, AssetUtils, AuthRoles, BaseExtensionModule, BucketRegistry, CandidateFilterInputDTO, CandidateOutputDTO, CandidateStatus, CurrencyValidationUtil, CurrentUser, DEFAULT_DOCUMENT_VERSION, DateUtils, DocumentAggregateDTO, 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_DENY_SELF_KEY, RolesGuard, SignatureInfoDTO, SignatureInfoInputDTO, SignedDigitalDocumentDTO, SignedDigitalDocumentInputDTO, TransactionDTO, UseBucket, bucketProvidersFor, bucketTokenFor, buildPaginationResult, checkPaymentAmount, checkPaymentSymbol, computeOnboardingExpiresAt, configureExtensionAuth, configurePlatformSettings, createPaginationResult, extensionEntities, generateHashFromString, generateRandomHash, generateUniqueHash, getAmountPlusFee, getAppliedBlockNum, hasServerSecret, isExtensionAvailable, mergeSecretConfig, paginationInputToOffset, platformSettings, providerSuppliedPaths, redactSecretConfig, registerExtensionEntities, resetExtensionEntities, rethrowChainError, verifySignedDocumentAgainstStoredDraft, waitAfterTransactBeforeChainTableRead };
+export { ActiveUserStatusGuard, AmountFormatterUtils, AssetUtils, AuthRoles, BaseExtensionModule, BucketRegistry, CandidateFilterInputDTO, CandidateOutputDTO, CandidateStatus, CurrencyValidationUtil, CurrentUser, DEFAULT_DOCUMENT_VERSION, DateUtils, DocumentAggregateDTO, 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, SignatureInfoDTO, SignatureInfoInputDTO, SignedDigitalDocumentDTO, SignedDigitalDocumentInputDTO, TransactionDTO, UseBucket, bucketProvidersFor, bucketTokenFor, buildPaginationResult, checkPaymentAmount, checkPaymentSymbol, computeOnboardingExpiresAt, configureExtensionAuth, configurePlatformSettings, createPaginationResult, extensionEntities, generateHashFromString, generateRandomHash, generateUniqueHash, getAmountPlusFee, getAppliedBlockNum, hasServerSecret, isExtensionAvailable, mergeSecretConfig, paginationInputToOffset, platformSettings, providerSuppliedPaths, redactSecretConfig, registerExtensionEntities, resetExtensionEntities, rethrowChainError, sanitizeUserText, verifySignedDocumentAgainstStoredDraft, waitAfterTransactBeforeChainTableRead };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@coopenomics/extension-kit",
   "type": "module",
-  "version": "2026.9.16-2",
+  "version": "2026.9.19",
   "description": "Служебный каркас расширения цифрового кооператива: базовый модуль, сущности и репозитории расширения, авторизация, каркас блокчейн-синхронизации, контракт миграций схемы, контракт реестра",
   "author": "Alex Ant <dacom.dark.sun@gmail.com>",
   "license": "MIT",
@@ -38,7 +38,7 @@
     "typecheck": "tsc --noEmit"
   },
   "peerDependencies": {
-    "@coopenomics/sdk": "2026.9.16-2",
+    "@coopenomics/sdk": "2026.9.19",
     "@nestjs/common": "^10.0.0",
     "@nestjs/core": "^10.0.0",
     "@nestjs/graphql": "^12.2.1",
@@ -68,7 +68,7 @@
     "@wharfkit/session": "^1.4.0",
     "class-transformer": "^0.5.1",
     "class-validator": "^0.14.1",
-    "cooptypes": "2026.9.16-2",
+    "cooptypes": "2026.9.19",
     "graphql": "^16.9.0",
     "graphql-type-json": "^0.3.2",
     "moment": "^2.30.1",
@@ -80,5 +80,5 @@
     "unbuild": "^2.0.0",
     "zod": "^3.0.0"
   },
-  "gitHead": "97b9f48f94efe92b20cecb66630e8bf821c73b59"
+  "gitHead": "902bd2627e36f1ac40dd09ef42627c0c53c3cdb1"
 }