@coopenomics/notifications 2026.5.30-3 → 2026.7.17-3

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@coopenomics/notifications",
-  "version": "2026.5.30-3",
-  "description": "Библиотека типобезопасных workflow-уведомлений для Novu",
+  "version": "2026.7.17-3",
+  "description": "Каталог типобезопасных типов уведомлений и шаблонов Центра уведомлений",
   "type": "module",
   "private": false,
   "main": "dist/index.cjs",
@@ -22,14 +22,9 @@
     "build": "unbuild",
     "dev": "unbuild --watch",
     "clean": "rm -rf dist",
-    "sync": "node ./dist/sync/sync-runner.cjs",
-    "sync:dev": "node ./dist/sync/sync-runner.cjs --dev",
-    "sync:watch": "node ./dist/sync/sync-runner.cjs --dev",
     "test": "vitest run"
   },
   "dependencies": {
-    "axios": "^1.7.7",
-    "dotenv": "^17.1.0",
     "transliteration": "^2.3.5",
     "zod": "^3.22.4",
     "zod-to-json-schema": "^3.22.5"
@@ -43,9 +38,6 @@
     "unbuild": "^2.0.0",
     "vitest": "^4.0.18"
   },
-  "bin": {
-    "novu-sync": "./dist/sync/sync-runner.cjs"
-  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -53,5 +45,5 @@
       "require": "./dist/index.cjs"
     }
   },
-  "gitHead": "6490aa81f4caa0c58bfbddd434c38f5ff2ff898f"
+  "gitHead": "ed9b0879d5655b2c4c06a512aad28441d05f0782"
 }

package/src/workflows/approval-request/index.ts

@@ -40,7 +40,7 @@ export const workflow: WorkflowDefinition<IWorkflow> = WorkflowBuilder
     createInAppStep(
       'approval-request-notification',
       'Новый запрос на одобрение действия',
-      'Запрос: {{payload.requestTitle}}<br>Автор: {{payload.authorName}}'
+      'Запрос: {{payload.requestTitle}}\nАвтор: {{payload.authorName}}'
     ),
     createPushStep(
       'approval-request-push',

package/src/workflows/expense-advance-report-reminder/index.ts

@@ -0,0 +1,58 @@
+import { z } from 'zod';
+import { WorkflowDefinition } from '../../types';
+import { WorkflowBuilder } from '../../base/workflow-builder';
+import { createEmailStep, createInAppStep } from '../../base/defaults';
+import { BaseWorkflowPayload } from '../../types';
+import { slugify } from '../../utils';
+
+// Одна строка-аванс в дайджесте напоминания.
+const advanceItemSchema = z.object({
+  description: z.string(), // Назначение расхода (item.description)
+  amount: z.string(), // Сумма выданного аванса (asset-строка)
+  url: z.string(), // Прямая ссылка на страницу этого расхода
+});
+
+// Напоминание пайщику отчитаться по выданным авансам под отчёт.
+// `period` — техническое поле (ISO-неделя): входит в payload, чтобы
+// идемпотентность Центра уведомлений гасила повторы в пределах недели и
+// пропускала ровно одно письмо на следующей неделе. В шаблоне не рендерится.
+export const expenseAdvanceReportReminderPayloadSchema = z.object({
+  coopName: z.string(),
+  period: z.string(),
+  count: z.number(),
+  link: z.string(), // Основная CTA-ссылка (на сам расход, если он один, иначе на личную страницу «Платежи»)
+  advances: z.array(advanceItemSchema),
+});
+export type IPayload = z.infer<typeof expenseAdvanceReportReminderPayloadSchema>;
+export interface IWorkflow extends BaseWorkflowPayload, IPayload {}
+
+export const name = 'Напоминание об отчёте по авансу';
+export const id = slugify(name);
+
+export const workflow: WorkflowDefinition<IWorkflow> = WorkflowBuilder
+  .create<IWorkflow>()
+  .name(name)
+  .workflowId(id)
+  .description('Еженедельное напоминание пайщику предоставить отчёт по выданному авансу под отчёт')
+  .payloadSchema(expenseAdvanceReportReminderPayloadSchema)
+  .tags(['expense', 'financial'])
+  .addSteps([
+    createEmailStep(
+      'expense-advance-report-reminder-email',
+      'Ожидается отчёт по авансу под отчёт — {{payload.coopName}}',
+      'Уважаемый пайщик!<br><br>' +
+        'По {% if payload.count > 1 %}следующим авансам под отчёт{% else %}авансу под отчёт{% endif %}, ' +
+        'полученным в кооперативе «{{payload.coopName}}», ещё не предоставлен отчёт:<br><br>' +
+        '{% for advance in payload.advances %}• {{advance.description}} — {{advance.amount}} — ' +
+        '<a href="{{advance.url}}">открыть расход</a><br>{% endfor %}' +
+        '<br>Пожалуйста, приложите подтверждающие документы (чек, акт) на странице расхода в личном ' +
+        'кабинете — после этого отчёт будет подан автоматически.<br><br>' +
+        '<a href="{{payload.link}}">Перейти к моим авансам</a>'
+    ),
+    createInAppStep(
+      'expense-advance-report-reminder-inapp',
+      'Ожидается отчёт по авансу под отчёт',
+      'По вашим авансам под отчёт ещё не предоставлен отчёт. Приложите подтверждающие документы в личном кабинете.'
+    ),
+  ])
+  .build();

package/src/workflows/index.ts

@@ -7,6 +7,7 @@ import { workflow as approvalRequestWorkflow } from './approval-request';
 import { workflow as decisionApprovedWorkflow } from './decision-approved';
 import { workflow as paymentPaidWorkflow } from './payment-paid';
 import { workflow as paymentCancelledWorkflow } from './payment-cancelled';
+import { workflow as paymentRefundedWorkflow } from './payment-refunded';
 import { workflow as meetInitialWorkflow } from './meet-initial';
 import { workflow as meetReminderStartWorkflow } from './meet-reminder-start';
 import { workflow as meetStartedWorkflow } from './meet-started';
@@ -19,10 +20,12 @@ import { workflow as newDepositPaymentRequestWorkflow } from './new-deposit-paym
 import { workflow as resetKeyWorkflow } from './reset-key';
 import { workflow as inviteWorkflow } from './invite';
 import { workflow as emailVerificationWorkflow } from './email-verification';
+import { workflow as membershipExitConfirmationWorkflow } from './membership-exit-confirmation';
 import { workflow as serverProvisionedWorkflow } from './server-provisioned';
 import { workflow as decisionExpiredWorkflow } from './decision-expired';
 import { workflow as chatcoopCalendarEventCreatedWorkflow } from './chatcoop-calendar-event-created';
 import { workflow as chatcoopCalendarEventUpdatedWorkflow } from './chatcoop-calendar-event-updated';
+import { workflow as expenseAdvanceReportReminderWorkflow } from './expense-advance-report-reminder';
 
 // Импортируем все воркфлоу
 export * as Welcome from './welcome';
@@ -32,6 +35,7 @@ export * as ApprovalRequest from './approval-request';
 export * as DecisionApproved from './decision-approved';
 export * as PaymentPaid from './payment-paid';
 export * as PaymentCancelled from './payment-cancelled';
+export * as PaymentRefunded from './payment-refunded';
 export * as MeetInitial from './meet-initial';
 export * as MeetReminderStart from './meet-reminder-start';
 export * as MeetStarted from './meet-started';
@@ -44,10 +48,12 @@ export * as NewDepositPaymentRequest from './new-deposit-payment-request';
 export * as ResetKey from './reset-key';
 export * as Invite from './invite';
 export * as EmailVerification from './email-verification';
+export * as MembershipExitConfirmation from './membership-exit-confirmation';
 export * as ServerProvisioned from './server-provisioned';
 export * as DecisionExpired from './decision-expired';
 export * as ChatCoopCalendarEventCreated from './chatcoop-calendar-event-created';
 export * as ChatCoopCalendarEventUpdated from './chatcoop-calendar-event-updated';
+export * as ExpenseAdvanceReportReminder from './expense-advance-report-reminder';
 
 // Массив всех воркфлоу для автоматической регистрации
 export const allWorkflows: WorkflowDefinition[] = [
@@ -58,6 +64,7 @@ export const allWorkflows: WorkflowDefinition[] = [
   decisionApprovedWorkflow,
   paymentPaidWorkflow,
   paymentCancelledWorkflow,
+  paymentRefundedWorkflow,
   meetInitialWorkflow,
   meetReminderStartWorkflow,
   meetStartedWorkflow,
@@ -70,10 +77,12 @@ export const allWorkflows: WorkflowDefinition[] = [
   resetKeyWorkflow,
   inviteWorkflow,
   emailVerificationWorkflow,
+  membershipExitConfirmationWorkflow,
   serverProvisionedWorkflow,
   decisionExpiredWorkflow,
   chatcoopCalendarEventCreatedWorkflow,
   chatcoopCalendarEventUpdatedWorkflow,
+  expenseAdvanceReportReminderWorkflow,
 ];
 
 // Экспортируем воркфлоу по ID для удобного доступа

package/src/workflows/membership-exit-confirmation/index.ts

@@ -0,0 +1,38 @@
+import { WorkflowDefinition, type BaseWorkflowPayload } from '../../types';
+import { WorkflowBuilder } from '../../base/workflow-builder';
+import { createEmailStep } from '../../base/defaults';
+import { z } from 'zod';
+import { slugify } from '../../utils';
+
+// Схема payload для письма-подтверждения выхода из кооператива
+export const membershipExitConfirmationPayloadSchema = z.object({
+  confirmationUrl: z.string(),
+});
+
+export type IPayload = z.infer<typeof membershipExitConfirmationPayloadSchema>;
+
+export interface IWorkflow extends BaseWorkflowPayload, IPayload {}
+
+export const name = 'Подтверждение выхода из кооператива';
+export const id = slugify(name);
+
+export const workflow: WorkflowDefinition<IWorkflow> = WorkflowBuilder
+  .create<IWorkflow>()
+  .name(name)
+  .workflowId(id)
+  .description('Подтверждение по email заявления о добровольном выходе пайщика из кооператива')
+  .payloadSchema(membershipExitConfirmationPayloadSchema)
+  .tags(['auth'])
+  .addSteps([
+    createEmailStep(
+      'membership-exit-confirmation-email',
+      'Подтверждение выхода из кооператива',
+      'Здравствуйте!<br><br>' +
+      'Вы подали заявление о добровольном выходе из кооператива. Это действие необратимо: ' +
+      'после подтверждения запускается процедура выхода и возврата паевого взноса, а ваш аккаунт блокируется.<br><br>' +
+      'Если вы действительно хотите выйти из кооператива, перейдите по ссылке для подтверждения: ' +
+      '<a href="{{payload.confirmationUrl}}">{{payload.confirmationUrl}}</a><br><br>' +
+      'Если вы не подавали такое заявление — просто проигнорируйте это письмо, ничего не произойдёт.'
+    ),
+  ])
+  .build();

package/src/workflows/new-agenda-item/index.ts

@@ -40,7 +40,7 @@ export const workflow: WorkflowDefinition<IWorkflow> = WorkflowBuilder
     createInAppStep(
       'new-agenda-item-notification',
       'Новый вопрос на повестке совета',
-      '{{payload.itemTitle}}<br>От: {{payload.authorName}}'
+      '{{payload.itemTitle}}\nОт: {{payload.authorName}}'
     ),
     createPushStep(
       'new-agenda-item-push',

package/src/workflows/payment-refunded/index.ts

@@ -0,0 +1,51 @@
+
+import { WorkflowDefinition } from '../../types';
+import { WorkflowBuilder } from '../../base/workflow-builder';
+import { z } from 'zod';
+import { BaseWorkflowPayload } from '../../types';
+import { createEmailStep, createInAppStep, createPushStep } from '../../base/defaults';
+import { slugify } from '../../utils';
+
+// Схема исходящего платежа пайщику. Это НЕ обязательно возврат взноса — тем же
+// каналом идут оплата аванса под отчёт, доплата по перерасходу и пр., поэтому
+// текст универсальный «Платёж выполнен», без привязки к типу платежа.
+export const paymentRefundedPayloadSchema = z.object({
+  userName: z.string(),
+  paymentAmount: z.string(),
+  paymentCurrency: z.string(),
+  paymentDate: z.string(),
+  paymentUrl: z.string().optional(),
+});
+
+export type IPayload = z.infer<typeof paymentRefundedPayloadSchema>;
+
+export interface IWorkflow extends BaseWorkflowPayload, IPayload {}
+
+export const name = 'Платёж выполнен';
+export const id = slugify(name);
+
+export const workflow: WorkflowDefinition<IWorkflow> = WorkflowBuilder
+  .create<IWorkflow>()
+  .name(name)
+  .workflowId(id)
+  .description('Уведомление о выполненном исходящем платеже пайщику (аванс, возврат, доплата и пр.)')
+  .payloadSchema(paymentRefundedPayloadSchema)
+  .tags(['user']) // Для всех пользователей
+  .addSteps([
+    createEmailStep(
+      'payment-refunded-email',
+      'Платёж выполнен',
+      'Уважаемый {{payload.userName}}!<br><br>Вам выполнен платёж.<br><br>Сумма: <strong>{{payload.paymentAmount}} {{payload.paymentCurrency}}</strong><br><br>Дата: {{payload.paymentDate}}<br><br>Подробная информация доступна по ссылке: {{payload.paymentUrl}}'
+    ),
+    createInAppStep(
+      'payment-refunded-notification',
+      'Платёж выполнен',
+      'Платёж на сумму {{payload.paymentAmount}} {{payload.paymentCurrency}} выполнен'
+    ),
+    createPushStep(
+      'payment-refunded-push',
+      'Платёж выполнен',
+      'Платёж {{payload.paymentAmount}} {{payload.paymentCurrency}} выполнен'
+    ),
+  ])
+  .build();