@floristcloud/api-lib 1.2.113 → 1.2.114

package/build/constant/contact-phone.constant.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CONTACT_PHONE_LABEL_MAX_LENGTH = exports.CONTACT_PHONE_MAX_LENGTH = exports.CONTACT_PHONE_LIST_MAX_LENGTH = void 0;
+exports.MESSENGERS_REQUIRING_URL = exports.CONTACT_MESSENGER_URL_MAX_LENGTH = exports.CONTACT_PHONE_LABEL_MAX_LENGTH = exports.CONTACT_PHONE_MAX_LENGTH = exports.CONTACT_PHONE_LIST_MAX_LENGTH = void 0;
+const contact_messenger_enum_1 = require("../enum/contact-messenger.enum");
 // Ограничение на длину списка контактов вебшопа: блок контактов рисуется в шапке и в мобильном
 // меню, больше десятка номеров туда не помещается физически.
 exports.CONTACT_PHONE_LIST_MAX_LENGTH = 10;
@@ -9,3 +10,12 @@ exports.CONTACT_PHONE_LIST_MAX_LENGTH = 10;
 // укладывается с запасом, подпись отдела («отдел продаж», «склад») — в 64.
 exports.CONTACT_PHONE_MAX_LENGTH = 32;
 exports.CONTACT_PHONE_LABEL_MAX_LENGTH = 64;
+// Ссылка на мессенджер. Домены не фиксируем — max.ru уже отдаёт три разных формата (`/u/<хеш>`,
+// `/@bot`, `/join/<код>`), и привязка к хосту означала бы деплой на каждое изменение у мессенджера.
+exports.CONTACT_MESSENGER_URL_MAX_LENGTH = 255;
+// Мессенджеры, до которых нельзя дойти по номеру телефона: у них ссылка обязательна.
+// WhatsApp единственный выводится из номера — `https://wa.me/<цифры>`.
+// Telegram по номеру открывается только схемой `tg://` в установленном приложении, в вебе не
+// работает, поэтому нужен юзернейм. У MAX маршрута по номеру нет вовсе — только профиль по хешу
+// из QR-кода, `@бот` или инвайт в канал.
+exports.MESSENGERS_REQUIRING_URL = [contact_messenger_enum_1.ContactMessengerEnum.TELEGRAM, contact_messenger_enum_1.ContactMessengerEnum.MAX];

package/build/constant/validation-i18n-key.js

@@ -36,4 +36,6 @@ exports.ValidationI18nKey = {
     standingOrderCategoryRequired: 'validation.standingOrderCategoryRequired',
     standingOrderNameRequired: 'validation.standingOrderNameRequired',
     standingOrderQuantityRequired: 'validation.standingOrderQuantityRequired',
+    contactMessengerUrlRequired: 'validation.contactMessengerUrlRequired',
+    contactMessengerDuplicate: 'validation.contactMessengerDuplicate',
 };

package/build/constant/validation-i18n-message.js

@@ -39,6 +39,8 @@ exports.VALIDATION_I18N_MESSAGE = {
     [validation_i18n_key_1.ValidationI18nKey.standingOrderCategoryRequired]: 'Category is required',
     [validation_i18n_key_1.ValidationI18nKey.standingOrderNameRequired]: 'Name is required',
     [validation_i18n_key_1.ValidationI18nKey.standingOrderQuantityRequired]: 'Quantity is required',
+    [validation_i18n_key_1.ValidationI18nKey.contactMessengerUrlRequired]: 'This messenger cannot be reached by phone number, provide a link',
+    [validation_i18n_key_1.ValidationI18nKey.contactMessengerDuplicate]: 'The same messenger is listed twice for this contact',
 };
 /**
  * A validation `message` is a stable i18n token when it matches this pattern (e.g. `validation.dateRange`).

package/build/schemas/settings/settings.schema.js

@@ -1,10 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.UpdateSettingsRequestSchema = exports.CreateSettingsSchema = exports.SettingsForAdminSchema = exports.SettingsSchema = exports.DeliveryPricingTierSchema = exports.DisableOrdersMessageSchema = exports.ContactPhoneListSchema = exports.ContactPhoneSchema = exports.ImportantMessageSchema = exports.SettingsWorkingHoursSchema = void 0;
+exports.UpdateSettingsRequestSchema = exports.CreateSettingsSchema = exports.SettingsForAdminSchema = exports.SettingsSchema = exports.DeliveryPricingTierSchema = exports.DisableOrdersMessageSchema = exports.ContactPhoneListSchema = exports.ContactPhoneSchema = exports.ContactMessengerLinkSchema = exports.ImportantMessageSchema = exports.SettingsWorkingHoursSchema = void 0;
 const zod_1 = require("zod");
 const enum_1 = require("../../enum");
 const contact_phone_constant_1 = require("../../constant/contact-phone.constant");
 const settings_constant_1 = require("../../constant/settings.constant");
+const validation_i18n_key_1 = require("../../constant/validation-i18n-key");
 const webshop_main_display_mode_enum_1 = require("../../enum/webshop-main-display-mode.enum");
 const menu_items_url_enum_1 = require("../../enum/menu-items-url.enum");
 const non_negative_money_schema_1 = require("../non-negative-money.schema");
@@ -23,12 +24,39 @@ exports.ImportantMessageSchema = zod_1.z.object({
     description: zod_1.z.string(),
     isActive: zod_1.z.boolean(),
 });
+// Мессенджер контакта. `url === null` означает «собрать ссылку из номера» — так умеет только
+// WhatsApp, поэтому для остальных ссылка обязательна (см. MESSENGERS_REQUIRING_URL и проверку ниже).
+exports.ContactMessengerLinkSchema = zod_1.z.object({
+    type: zod_1.z.nativeEnum(enum_1.ContactMessengerEnum),
+    url: zod_1.z.string().url().max(contact_phone_constant_1.CONTACT_MESSENGER_URL_MAX_LENGTH).nullable(),
+});
 // Один контакт из блока контактов вебшопа: номер, подпись отдела («отдел продаж», «склад») и
 // мессенджеры, доступные по этому же номеру. Порядок вывода задаётся порядком элементов в массиве.
-exports.ContactPhoneSchema = zod_1.z.object({
+exports.ContactPhoneSchema = zod_1.z
+    .object({
     phone: zod_1.z.string().min(1).max(contact_phone_constant_1.CONTACT_PHONE_MAX_LENGTH),
     label: zod_1.z.string().max(contact_phone_constant_1.CONTACT_PHONE_LABEL_MAX_LENGTH).nullable(),
-    messengers: zod_1.z.array(zod_1.z.nativeEnum(enum_1.ContactMessengerEnum)),
+    messengers: zod_1.z.array(exports.ContactMessengerLinkSchema),
+})
+    .superRefine(({ messengers }, ctx) => {
+    const seen = new Set();
+    messengers.forEach((messenger, index) => {
+        if (!messenger.url && contact_phone_constant_1.MESSENGERS_REQUIRING_URL.includes(messenger.type)) {
+            ctx.addIssue({
+                code: zod_1.z.ZodIssueCode.custom,
+                path: ['messengers', index, 'url'],
+                message: validation_i18n_key_1.ValidationI18nKey.contactMessengerUrlRequired,
+            });
+        }
+        if (seen.has(messenger.type)) {
+            ctx.addIssue({
+                code: zod_1.z.ZodIssueCode.custom,
+                path: ['messengers', index, 'type'],
+                message: validation_i18n_key_1.ValidationI18nKey.contactMessengerDuplicate,
+            });
+        }
+        seen.add(messenger.type);
+    });
 });
 exports.ContactPhoneListSchema = zod_1.z.array(exports.ContactPhoneSchema).max(contact_phone_constant_1.CONTACT_PHONE_LIST_MAX_LENGTH);
 // Один потолок на все три схемы настроек: колонка `disable_orders_message` — TEXT, длину держит
@@ -85,6 +113,7 @@ exports.SettingsSchema = zod_1.z.object({
     phoneSales: zod_1.z.string().nullable(),
     phoneWhatsappSales: zod_1.z.string().nullable(),
     telegramChannel: zod_1.z.string().nullable(),
+    maxChannel: zod_1.z.string().nullable(),
     contactPhoneList: exports.ContactPhoneListSchema.nullable(),
     menuItemsSort: zod_1.z.array(zod_1.z.nativeEnum(menu_items_url_enum_1.MenuItemsUrlEnum)).nullable(),
     phoneCountryCode: zod_1.z.array(zod_1.z.string()),
@@ -173,6 +202,7 @@ exports.CreateSettingsSchema = zod_1.z.object({
     phoneSales: zod_1.z.string().nullable().optional(),
     phoneWhatsappSales: zod_1.z.string().nullable().optional(),
     telegramChannel: zod_1.z.string().nullable().optional(),
+    maxChannel: zod_1.z.string().nullable().optional(),
     contactPhoneList: exports.ContactPhoneListSchema.nullable().optional(),
     menuItemsSort: zod_1.z.array(zod_1.z.nativeEnum(menu_items_url_enum_1.MenuItemsUrlEnum)).nullable().optional(),
     phoneCountryCode: zod_1.z.array(zod_1.z.string()).optional(),
@@ -236,6 +266,7 @@ exports.UpdateSettingsRequestSchema = zod_1.z.object({
     phoneSales: zod_1.z.string().nullable().optional(),
     phoneWhatsappSales: zod_1.z.string().nullable().optional(),
     telegramChannel: zod_1.z.string().nullable().optional(),
+    maxChannel: zod_1.z.string().nullable().optional(),
     contactPhoneList: exports.ContactPhoneListSchema.nullable().optional(),
     menuItemsSort: zod_1.z.array(zod_1.z.nativeEnum(menu_items_url_enum_1.MenuItemsUrlEnum)).nullable().optional(),
     phoneCountryCode: zod_1.z.array(zod_1.z.string()).optional(),

package/constant/contact-phone.constant.ts

@@ -1,3 +1,5 @@
+import { ContactMessengerEnum } from '../enum/contact-messenger.enum';
+
 // Ограничение на длину списка контактов вебшопа: блок контактов рисуется в шапке и в мобильном
 // меню, больше десятка номеров туда не помещается физически.
 export const CONTACT_PHONE_LIST_MAX_LENGTH = 10;
@@ -7,3 +9,14 @@ export const CONTACT_PHONE_LIST_MAX_LENGTH = 10;
 // укладывается с запасом, подпись отдела («отдел продаж», «склад») — в 64.
 export const CONTACT_PHONE_MAX_LENGTH = 32;
 export const CONTACT_PHONE_LABEL_MAX_LENGTH = 64;
+
+// Ссылка на мессенджер. Домены не фиксируем — max.ru уже отдаёт три разных формата (`/u/<хеш>`,
+// `/@bot`, `/join/<код>`), и привязка к хосту означала бы деплой на каждое изменение у мессенджера.
+export const CONTACT_MESSENGER_URL_MAX_LENGTH = 255;
+
+// Мессенджеры, до которых нельзя дойти по номеру телефона: у них ссылка обязательна.
+// WhatsApp единственный выводится из номера — `https://wa.me/<цифры>`.
+// Telegram по номеру открывается только схемой `tg://` в установленном приложении, в вебе не
+// работает, поэтому нужен юзернейм. У MAX маршрута по номеру нет вовсе — только профиль по хешу
+// из QR-кода, `@бот` или инвайт в канал.
+export const MESSENGERS_REQUIRING_URL: ContactMessengerEnum[] = [ContactMessengerEnum.TELEGRAM, ContactMessengerEnum.MAX];

package/constant/validation-i18n-key.ts

@@ -33,6 +33,8 @@ export const ValidationI18nKey = {
     standingOrderCategoryRequired: 'validation.standingOrderCategoryRequired',
     standingOrderNameRequired: 'validation.standingOrderNameRequired',
     standingOrderQuantityRequired: 'validation.standingOrderQuantityRequired',
+    contactMessengerUrlRequired: 'validation.contactMessengerUrlRequired',
+    contactMessengerDuplicate: 'validation.contactMessengerDuplicate',
 } as const;
 
 export type ValidationI18nKeyType = (typeof ValidationI18nKey)[keyof typeof ValidationI18nKey];

package/constant/validation-i18n-message.ts

@@ -37,6 +37,8 @@ export const VALIDATION_I18N_MESSAGE: Record<ValidationI18nKeyType, string> = {
     [ValidationI18nKey.standingOrderCategoryRequired]: 'Category is required',
     [ValidationI18nKey.standingOrderNameRequired]: 'Name is required',
     [ValidationI18nKey.standingOrderQuantityRequired]: 'Quantity is required',
+    [ValidationI18nKey.contactMessengerUrlRequired]: 'This messenger cannot be reached by phone number, provide a link',
+    [ValidationI18nKey.contactMessengerDuplicate]: 'The same messenger is listed twice for this contact',
 };
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@floristcloud/api-lib",
-    "version": "1.2.113",
+    "version": "1.2.114",
     "description": "",
     "main": "./build/index.js",
     "scripts": {

package/schemas/settings/settings.schema.ts

@@ -8,14 +8,16 @@ import {
     WebshopModeEnum,
 } from '../../enum';
 import {
+    CONTACT_MESSENGER_URL_MAX_LENGTH,
     CONTACT_PHONE_LABEL_MAX_LENGTH,
     CONTACT_PHONE_LIST_MAX_LENGTH,
     CONTACT_PHONE_MAX_LENGTH,
+    MESSENGERS_REQUIRING_URL,
 } from '../../constant/contact-phone.constant';
 import { DISABLE_ORDERS_MESSAGE_MAX_LENGTH } from '../../constant/settings.constant';
+import { ValidationI18nKey } from '../../constant/validation-i18n-key';
 import { WebshopMainDisplayModeEnum } from '../../enum/webshop-main-display-mode.enum';
 import { MenuItemsUrlEnum } from '../../enum/menu-items-url.enum';
-import { MoneySchema } from '../money.schema';
 import { NonNegativeMoneySchema } from '../non-negative-money.schema';
 
 export const SettingsWorkingHoursSchema = z.object({
@@ -35,13 +37,43 @@ export const ImportantMessageSchema = z.object({
     isActive: z.boolean(),
 });
 
+// Мессенджер контакта. `url === null` означает «собрать ссылку из номера» — так умеет только
+// WhatsApp, поэтому для остальных ссылка обязательна (см. MESSENGERS_REQUIRING_URL и проверку ниже).
+export const ContactMessengerLinkSchema = z.object({
+    type: z.nativeEnum(ContactMessengerEnum),
+    url: z.string().url().max(CONTACT_MESSENGER_URL_MAX_LENGTH).nullable(),
+});
+
 // Один контакт из блока контактов вебшопа: номер, подпись отдела («отдел продаж», «склад») и
 // мессенджеры, доступные по этому же номеру. Порядок вывода задаётся порядком элементов в массиве.
-export const ContactPhoneSchema = z.object({
-    phone: z.string().min(1).max(CONTACT_PHONE_MAX_LENGTH),
-    label: z.string().max(CONTACT_PHONE_LABEL_MAX_LENGTH).nullable(),
-    messengers: z.array(z.nativeEnum(ContactMessengerEnum)),
-});
+export const ContactPhoneSchema = z
+    .object({
+        phone: z.string().min(1).max(CONTACT_PHONE_MAX_LENGTH),
+        label: z.string().max(CONTACT_PHONE_LABEL_MAX_LENGTH).nullable(),
+        messengers: z.array(ContactMessengerLinkSchema),
+    })
+    .superRefine(({ messengers }, ctx) => {
+        const seen = new Set<ContactMessengerEnum>();
+
+        messengers.forEach((messenger, index) => {
+            if (!messenger.url && MESSENGERS_REQUIRING_URL.includes(messenger.type)) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    path: ['messengers', index, 'url'],
+                    message: ValidationI18nKey.contactMessengerUrlRequired,
+                });
+            }
+
+            if (seen.has(messenger.type)) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    path: ['messengers', index, 'type'],
+                    message: ValidationI18nKey.contactMessengerDuplicate,
+                });
+            }
+            seen.add(messenger.type);
+        });
+    });
 
 export const ContactPhoneListSchema = z.array(ContactPhoneSchema).max(CONTACT_PHONE_LIST_MAX_LENGTH);
 
@@ -101,6 +133,7 @@ export const SettingsSchema = z.object({
     phoneSales: z.string().nullable(),
     phoneWhatsappSales: z.string().nullable(),
     telegramChannel: z.string().nullable(),
+    maxChannel: z.string().nullable(),
     contactPhoneList: ContactPhoneListSchema.nullable(),
     menuItemsSort: z.array(z.nativeEnum(MenuItemsUrlEnum)).nullable(),
     phoneCountryCode: z.array(z.string()),
@@ -193,6 +226,7 @@ export const CreateSettingsSchema = z.object({
     phoneSales: z.string().nullable().optional(),
     phoneWhatsappSales: z.string().nullable().optional(),
     telegramChannel: z.string().nullable().optional(),
+    maxChannel: z.string().nullable().optional(),
     contactPhoneList: ContactPhoneListSchema.nullable().optional(),
     menuItemsSort: z.array(z.nativeEnum(MenuItemsUrlEnum)).nullable().optional(),
     phoneCountryCode: z.array(z.string()).optional(),
@@ -259,6 +293,7 @@ export const UpdateSettingsRequestSchema = z.object({
     phoneSales: z.string().nullable().optional(),
     phoneWhatsappSales: z.string().nullable().optional(),
     telegramChannel: z.string().nullable().optional(),
+    maxChannel: z.string().nullable().optional(),
     contactPhoneList: ContactPhoneListSchema.nullable().optional(),
     menuItemsSort: z.array(z.nativeEnum(MenuItemsUrlEnum)).nullable().optional(),
     phoneCountryCode: z.array(z.string()).optional(),