@floristcloud/api-lib 1.2.153 → 1.2.154

package/build/commands/index.js

@@ -69,6 +69,7 @@ __exportStar(require("./integration"), exports);
 __exportStar(require("./account-deletion-request"), exports);
 __exportStar(require("./service"), exports);
 __exportStar(require("./order-service-line"), exports);
+__exportStar(require("./order-attachment"), exports);
 // Session contracts exported individually to avoid webpack TDZ issues with Next.js SSG
 var session_logout_command_1 = require("./session/session-logout.command");
 Object.defineProperty(exports, "SessionLogoutContractCommand", { enumerable: true, get: function () { return session_logout_command_1.SessionLogoutContractCommand; } });

package/build/commands/order-attachment/create-order-attachment.command.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreateOrderAttachmentContractCommand = void 0;
+const order_attachment_schema_1 = require("../../schemas/order-attachment/order-attachment.schema");
+var CreateOrderAttachmentContractCommand;
+(function (CreateOrderAttachmentContractCommand) {
+    CreateOrderAttachmentContractCommand.RequestSchema = order_attachment_schema_1.CreateOrderAttachmentRequestSchema;
+    CreateOrderAttachmentContractCommand.ResponseSchema = order_attachment_schema_1.CreateOrderAttachmentResponseSchema;
+})(CreateOrderAttachmentContractCommand || (exports.CreateOrderAttachmentContractCommand = CreateOrderAttachmentContractCommand = {}));

package/build/commands/order-attachment/delete-order-attachment.command.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeleteOrderAttachmentContractCommand = void 0;
+const order_attachment_schema_1 = require("../../schemas/order-attachment/order-attachment.schema");
+var DeleteOrderAttachmentContractCommand;
+(function (DeleteOrderAttachmentContractCommand) {
+    DeleteOrderAttachmentContractCommand.ResponseSchema = order_attachment_schema_1.DeleteOrderAttachmentResponseSchema;
+})(DeleteOrderAttachmentContractCommand || (exports.DeleteOrderAttachmentContractCommand = DeleteOrderAttachmentContractCommand = {}));

package/build/commands/order-attachment/get-order-attachment-list-for-client.query.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetOrderAttachmentListForClientContractQuery = void 0;
+const order_attachment_for_client_schema_1 = require("../../schemas/order-attachment/order-attachment-for-client.schema");
+var GetOrderAttachmentListForClientContractQuery;
+(function (GetOrderAttachmentListForClientContractQuery) {
+    GetOrderAttachmentListForClientContractQuery.ResponseSchema = order_attachment_for_client_schema_1.GetOrderAttachmentListForClientResponseSchema;
+})(GetOrderAttachmentListForClientContractQuery || (exports.GetOrderAttachmentListForClientContractQuery = GetOrderAttachmentListForClientContractQuery = {}));

package/build/commands/order-attachment/get-order-attachment-list.query.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetOrderAttachmentListContractQuery = void 0;
+const order_attachment_schema_1 = require("../../schemas/order-attachment/order-attachment.schema");
+var GetOrderAttachmentListContractQuery;
+(function (GetOrderAttachmentListContractQuery) {
+    GetOrderAttachmentListContractQuery.ResponseSchema = order_attachment_schema_1.GetOrderAttachmentListResponseSchema;
+})(GetOrderAttachmentListContractQuery || (exports.GetOrderAttachmentListContractQuery = GetOrderAttachmentListContractQuery = {}));

package/build/commands/order-attachment/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./create-order-attachment.command"), exports);
+__exportStar(require("./update-order-attachment.command"), exports);
+__exportStar(require("./delete-order-attachment.command"), exports);
+__exportStar(require("./get-order-attachment-list.query"), exports);
+__exportStar(require("./get-order-attachment-list-for-client.query"), exports);

package/build/commands/order-attachment/update-order-attachment.command.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateOrderAttachmentContractCommand = void 0;
+const order_attachment_schema_1 = require("../../schemas/order-attachment/order-attachment.schema");
+var UpdateOrderAttachmentContractCommand;
+(function (UpdateOrderAttachmentContractCommand) {
+    UpdateOrderAttachmentContractCommand.RequestSchema = order_attachment_schema_1.UpdateOrderAttachmentRequestSchema;
+    UpdateOrderAttachmentContractCommand.ResponseSchema = order_attachment_schema_1.UpdateOrderAttachmentResponseSchema;
+})(UpdateOrderAttachmentContractCommand || (exports.UpdateOrderAttachmentContractCommand = UpdateOrderAttachmentContractCommand = {}));

package/build/constant/error.js

@@ -460,6 +460,11 @@ exports.ERRORS = {
     ORDER_SERVICE_LINE_NOT_DELETED: { code: 'OSL004', message: 'Service in order not deleted', httpCode: 500 },
     ORDER_SERVICE_LINE_NOT_UPDATED: { code: 'OSL005', message: 'Service in order not updated', httpCode: 500 },
     ORDER_SERVICE_LINE_MODIFY_NOT_ALLOWED: { code: 'OSL006', message: 'Modifying order services is not allowed', httpCode: 409 },
+    ORDER_ATTACHMENT_NOT_CREATED: { code: 'OAT001', message: 'Failed to attach file to order', httpCode: 500 },
+    ORDER_ATTACHMENT_FETCH_FAILED: { code: 'OAT002', message: 'Error when retrieving order attachments', httpCode: 500 },
+    ORDER_ATTACHMENT_NOT_FOUND: { code: 'OAT003', message: 'Order attachment not found', httpCode: 404 },
+    ORDER_ATTACHMENT_NOT_DELETED: { code: 'OAT004', message: 'Order attachment not deleted', httpCode: 500 },
+    ORDER_ATTACHMENT_NOT_UPDATED: { code: 'OAT005', message: 'Order attachment not updated', httpCode: 500 },
     //ORDER DELIVERY
     ORDER_DELIVERY_ALREADY_EXIST: { code: 'OD006', message: 'Delivery for the order already exists', httpCode: 409 },
     ORDER_DELIVERY_NOT_CREATED: { code: 'OD007', message: 'Failed to create order delivery', httpCode: 500 },

package/build/enum/action-log-type.enum.js

@@ -76,6 +76,9 @@ var ActionLogTypeEnum;
     ActionLogTypeEnum["DELETE_COLLECTION_ITEMS"] = "DELETE_COLLECTION_ITEMS";
     ActionLogTypeEnum["MOVE_COLLECTION_ITEMS"] = "MOVE_COLLECTION_ITEMS";
     ActionLogTypeEnum["UPDATE_COLLECTION_ITEM_MULTIPLICITY_OPTIONS"] = "UPDATE_COLLECTION_ITEM_MULTIPLICITY_OPTIONS";
+    ActionLogTypeEnum["CREATE_ORDER_ATTACHMENT"] = "CREATE_ORDER_ATTACHMENT";
+    ActionLogTypeEnum["UPDATE_ORDER_ATTACHMENT"] = "UPDATE_ORDER_ATTACHMENT";
+    ActionLogTypeEnum["DELETE_ORDER_ATTACHMENT"] = "DELETE_ORDER_ATTACHMENT";
     ActionLogTypeEnum["UPDATE_CLIENT_MARKING"] = "UPDATE_CLIENT_MARKING";
     ActionLogTypeEnum["UPDATE_CLIENT_PROFILE"] = "UPDATE_CLIENT_PROFILE";
     ActionLogTypeEnum["COPY_PREORDER_COLLECTION"] = "COPY_PREORDER_COLLECTION";

package/build/enum/index.js

@@ -21,6 +21,8 @@ __exportStar(require("./outbound-sync-intent.enum"), exports);
 __exportStar(require("./outbound-sync-status.enum"), exports);
 __exportStar(require("./order-type.enum"), exports);
 __exportStar(require("./order-status.enum"), exports);
+__exportStar(require("./order-attachment-type.enum"), exports);
+__exportStar(require("./order-attachment-updated-field.enum"), exports);
 __exportStar(require("./order-product-verify-source.enum"), exports);
 __exportStar(require("./order-restricted-status-list"), exports);
 __exportStar(require("./order-balance-status-list"), exports);

package/build/enum/order-attachment-type.enum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OrderAttachmentTypeEnum = void 0;
+/** Что прикрепили к заказу: загруженный файл или внешняя ссылка. */
+var OrderAttachmentTypeEnum;
+(function (OrderAttachmentTypeEnum) {
+    OrderAttachmentTypeEnum["FILE"] = "FILE";
+    OrderAttachmentTypeEnum["LINK"] = "LINK";
+})(OrderAttachmentTypeEnum || (exports.OrderAttachmentTypeEnum = OrderAttachmentTypeEnum = {}));

package/build/enum/order-attachment-updated-field.enum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OrderAttachmentUpdatedFieldEnum = void 0;
+/** Поля вложения заказа, изменение которых попадает в журнал. Ссылку и тип не правят: их меняют пересозданием. */
+var OrderAttachmentUpdatedFieldEnum;
+(function (OrderAttachmentUpdatedFieldEnum) {
+    OrderAttachmentUpdatedFieldEnum["NAME"] = "NAME";
+    OrderAttachmentUpdatedFieldEnum["IS_VISIBLE_TO_CLIENT"] = "IS_VISIBLE_TO_CLIENT";
+})(OrderAttachmentUpdatedFieldEnum || (exports.OrderAttachmentUpdatedFieldEnum = OrderAttachmentUpdatedFieldEnum = {}));

package/build/schemas/action-log/action-log-payload.schema.js

@@ -78,6 +78,9 @@ const collection_items_move_action_log_schema_1 = require("./collection-items-mo
 const collection_item_multiplicity_options_action_log_schema_1 = require("./collection-item-multiplicity-options-action-log.schema");
 const client_marking_action_log_schema_1 = require("./client-marking-action-log.schema");
 const client_profile_action_log_schema_1 = require("./client-profile-action-log.schema");
+const order_attachment_create_action_log_schema_1 = require("./order-attachment-create-action-log.schema");
+const order_attachment_update_action_log_schema_1 = require("./order-attachment-update-action-log.schema");
+const order_attachment_delete_action_log_schema_1 = require("./order-attachment-delete-action-log.schema");
 exports.ActionLogPayloadSchema = zod_1.z.union([
     order_delete_action_log_payload_schema_1.OrderDeleteActionLogPayloadSchema,
     order_merge_action_log_schema_1.OrderMergeActionLogSchema,
@@ -152,5 +155,8 @@ exports.ActionLogPayloadSchema = zod_1.z.union([
     collection_item_multiplicity_options_action_log_schema_1.CollectionItemMultiplicityOptionsActionLogSchema,
     client_marking_action_log_schema_1.ClientMarkingActionLogSchema,
     client_profile_action_log_schema_1.ClientProfileActionLogSchema,
+    order_attachment_create_action_log_schema_1.OrderAttachmentCreateActionLogSchema,
+    order_attachment_update_action_log_schema_1.OrderAttachmentUpdateActionLogSchema,
+    order_attachment_delete_action_log_schema_1.OrderAttachmentDeleteActionLogSchema,
     zod_1.z.null(),
 ]);

package/build/schemas/action-log/action-log.schema.js

@@ -74,6 +74,9 @@ const collection_items_delete_action_log_schema_1 = require("./collection-items-
 const pre_order_collection_copy_action_log_schema_1 = require("./pre-order-collection-copy-action-log.schema");
 const collection_items_move_action_log_schema_1 = require("./collection-items-move-action-log.schema");
 const collection_item_multiplicity_options_action_log_schema_1 = require("./collection-item-multiplicity-options-action-log.schema");
+const order_attachment_create_action_log_schema_1 = require("./order-attachment-create-action-log.schema");
+const order_attachment_update_action_log_schema_1 = require("./order-attachment-update-action-log.schema");
+const order_attachment_delete_action_log_schema_1 = require("./order-attachment-delete-action-log.schema");
 const client_marking_action_log_schema_1 = require("./client-marking-action-log.schema");
 const client_profile_action_log_schema_1 = require("./client-profile-action-log.schema");
 const BaseActionFields = zod_1.z.object({
@@ -456,6 +459,24 @@ exports.ActionLogSchema = zod_1.z.discriminatedUnion('actionType', [
         payload: collection_item_multiplicity_options_action_log_schema_1.CollectionItemMultiplicityOptionsActionLogSchema,
     })
         .merge(BaseActionFields),
+    zod_1.z
+        .object({
+        actionType: zod_1.z.literal(enum_1.ActionLogTypeEnum.CREATE_ORDER_ATTACHMENT),
+        payload: order_attachment_create_action_log_schema_1.OrderAttachmentCreateActionLogSchema,
+    })
+        .merge(BaseActionFields),
+    zod_1.z
+        .object({
+        actionType: zod_1.z.literal(enum_1.ActionLogTypeEnum.UPDATE_ORDER_ATTACHMENT),
+        payload: order_attachment_update_action_log_schema_1.OrderAttachmentUpdateActionLogSchema,
+    })
+        .merge(BaseActionFields),
+    zod_1.z
+        .object({
+        actionType: zod_1.z.literal(enum_1.ActionLogTypeEnum.DELETE_ORDER_ATTACHMENT),
+        payload: order_attachment_delete_action_log_schema_1.OrderAttachmentDeleteActionLogSchema,
+    })
+        .merge(BaseActionFields),
     zod_1.z
         .object({
         actionType: zod_1.z.literal(enum_1.ActionLogTypeEnum.UPDATE_CLIENT_MARKING),

package/build/schemas/action-log/index.js

@@ -97,3 +97,7 @@ __exportStar(require("./collection-item-multiplicity-options-action-log.schema")
 __exportStar(require("./client-marking-action-log.schema"), exports);
 __exportStar(require("./client-profile-action-log.schema"), exports);
 __exportStar(require("./pre-order-collection-copy-action-log.schema"), exports);
+__exportStar(require("./order-attachment-info.schema"), exports);
+__exportStar(require("./order-attachment-create-action-log.schema"), exports);
+__exportStar(require("./order-attachment-update-action-log.schema"), exports);
+__exportStar(require("./order-attachment-delete-action-log.schema"), exports);

package/build/schemas/action-log/order-attachment-create-action-log.schema.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OrderAttachmentCreateActionLogSchema = void 0;
+const zod_1 = require("zod");
+const order_attachment_info_schema_1 = require("./order-attachment-info.schema");
+/** К заказу прикрепили файл или ссылку. */
+exports.OrderAttachmentCreateActionLogSchema = zod_1.z.object({
+    attachment: order_attachment_info_schema_1.OrderAttachmentInfoSchema,
+});

package/build/schemas/action-log/order-attachment-delete-action-log.schema.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OrderAttachmentDeleteActionLogSchema = void 0;
+const zod_1 = require("zod");
+const order_attachment_info_schema_1 = require("./order-attachment-info.schema");
+/** Вложение сняли с заказа. Снимок берётся до удаления: записи в базе после него уже нет. */
+exports.OrderAttachmentDeleteActionLogSchema = zod_1.z.object({
+    attachment: order_attachment_info_schema_1.OrderAttachmentInfoSchema,
+});

package/build/schemas/action-log/order-attachment-info.schema.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OrderAttachmentInfoSchema = void 0;
+const zod_1 = require("zod");
+const order_attachment_type_enum_1 = require("../../enum/order-attachment-type.enum");
+/** Снимок вложения заказа на момент события: чем прикрепили, как подписано и видит ли клиент. */
+exports.OrderAttachmentInfoSchema = zod_1.z.object({
+    orderUUID: zod_1.z.string(),
+    attachmentUUID: zod_1.z.string(),
+    type: zod_1.z.nativeEnum(order_attachment_type_enum_1.OrderAttachmentTypeEnum),
+    name: zod_1.z.string(),
+    url: zod_1.z.string(),
+    isVisibleToClient: zod_1.z.boolean(),
+});

package/build/schemas/action-log/order-attachment-update-action-log.schema.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OrderAttachmentUpdateActionLogSchema = void 0;
+const zod_1 = require("zod");
+const order_attachment_updated_field_enum_1 = require("../../enum/order-attachment-updated-field.enum");
+const order_attachment_info_schema_1 = require("./order-attachment-info.schema");
+/**
+ * Правка вложения: снимок до правки и изменённые поля. Переключатель видимости меняет то, что
+ * контрагент видит в своём заказе, поэтому смена этого поля должна быть видна в истории.
+ */
+exports.OrderAttachmentUpdateActionLogSchema = zod_1.z.object({
+    attachment: order_attachment_info_schema_1.OrderAttachmentInfoSchema,
+    changes: zod_1.z
+        .array(zod_1.z.object({
+        field: zod_1.z.nativeEnum(order_attachment_updated_field_enum_1.OrderAttachmentUpdatedFieldEnum),
+        oldValue: zod_1.z.string().nullable(),
+        newValue: zod_1.z.string().nullable(),
+    }))
+        .min(1),
+});

package/build/schemas/index.js

@@ -74,6 +74,8 @@ __exportStar(require("./discount-rules/discount-rules.schema"), exports);
 __exportStar(require("./package/validate-package.schema"), exports);
 __exportStar(require("./service/service.schema"), exports);
 __exportStar(require("./order-service-line/order-service-line.schema"), exports);
+__exportStar(require("./order-attachment/order-attachment.schema"), exports);
+__exportStar(require("./order-attachment/order-attachment-for-client.schema"), exports);
 __exportStar(require("./distribution/validate-distribution-by-product.schema"), exports);
 __exportStar(require("./consignment/consignment-distribution-validation.schema"), exports);
 __exportStar(require("./product-image-template/product-image-template.schema"), exports);

package/build/schemas/order-attachment/order-attachment-for-client.schema.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetOrderAttachmentListForClientResponseSchema = exports.OrderAttachmentForClientSchema = void 0;
+const zod_1 = require("zod");
+const order_attachment_schema_1 = require("./order-attachment.schema");
+/** Вложение глазами клиента: без автора-сотрудника и без флага видимости, который для него всегда включён. */
+exports.OrderAttachmentForClientSchema = order_attachment_schema_1.OrderAttachmentSchema.pick({
+    uuid: true,
+    orderUUID: true,
+    type: true,
+    name: true,
+    url: true,
+    createdAt: true,
+});
+exports.GetOrderAttachmentListForClientResponseSchema = zod_1.z.object({
+    data: zod_1.z.object({
+        attachmentList: zod_1.z.array(exports.OrderAttachmentForClientSchema),
+    }),
+});

package/build/schemas/order-attachment/order-attachment.schema.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeleteOrderAttachmentResponseSchema = exports.GetOrderAttachmentListResponseSchema = exports.UpdateOrderAttachmentResponseSchema = exports.UpdateOrderAttachmentRequestSchema = exports.CreateOrderAttachmentResponseSchema = exports.CreateOrderAttachmentRequestSchema = exports.OrderAttachmentSchema = void 0;
+const zod_1 = require("zod");
+const order_attachment_type_enum_1 = require("../../enum/order-attachment-type.enum");
+/**
+ * Ссылка на файл в бакете (для FILE её отдаёт `PUT /files/upload-file`) или внешний адрес (для LINK).
+ * Схему не сужаем до домена CDN: в LINK кладут ссылки на сторонние сервисы доставки.
+ *
+ * Протокол только http/https: `z.url()` сам по себе принимает и `javascript:`, и `data:text/html`,
+ * а вложение с включённой видимостью витрина отдаёт клиенту и рисует ссылкой — то есть сотрудник
+ * мог бы подложить контрагенту исполняемый адрес.
+ */
+const OrderAttachmentUrlSchema = zod_1.z.url({ protocol: /^https?$/ }).max(2048);
+const OrderAttachmentNameSchema = zod_1.z.string().trim().min(1).max(255);
+exports.OrderAttachmentSchema = zod_1.z.object({
+    uuid: zod_1.z.uuid(),
+    orderUUID: zod_1.z.uuid(),
+    type: zod_1.z.nativeEnum(order_attachment_type_enum_1.OrderAttachmentTypeEnum),
+    name: OrderAttachmentNameSchema,
+    url: OrderAttachmentUrlSchema,
+    isVisibleToClient: zod_1.z.boolean(),
+    createdByUserUUID: zod_1.z.uuid(),
+    createdAt: zod_1.z.date(),
+    updatedAt: zod_1.z.date(),
+});
+exports.CreateOrderAttachmentRequestSchema = zod_1.z.object({
+    type: zod_1.z.nativeEnum(order_attachment_type_enum_1.OrderAttachmentTypeEnum),
+    name: OrderAttachmentNameSchema,
+    url: OrderAttachmentUrlSchema,
+    // По умолчанию вложение внутреннее: клиент увидит его, только когда это включат явно.
+    isVisibleToClient: zod_1.z.boolean().optional().default(false),
+});
+exports.CreateOrderAttachmentResponseSchema = zod_1.z.object({
+    data: exports.OrderAttachmentSchema,
+});
+exports.UpdateOrderAttachmentRequestSchema = zod_1.z
+    .object({
+    name: OrderAttachmentNameSchema.optional(),
+    isVisibleToClient: zod_1.z.boolean().optional(),
+})
+    .refine(data => data.name !== undefined || data.isVisibleToClient !== undefined, {
+    message: 'validation.emptyUpdate',
+});
+exports.UpdateOrderAttachmentResponseSchema = zod_1.z.object({
+    data: exports.OrderAttachmentSchema,
+});
+exports.GetOrderAttachmentListResponseSchema = zod_1.z.object({
+    data: zod_1.z.object({
+        attachmentList: zod_1.z.array(exports.OrderAttachmentSchema),
+    }),
+});
+exports.DeleteOrderAttachmentResponseSchema = zod_1.z.object({
+    data: zod_1.z.object({
+        success: zod_1.z.boolean(),
+    }),
+});

package/commands/index.ts

@@ -52,6 +52,7 @@ export * from './integration';
 export * from './account-deletion-request';
 export * from './service';
 export * from './order-service-line';
+export * from './order-attachment';
 // Session contracts exported individually to avoid webpack TDZ issues with Next.js SSG
 export { SessionLogoutContractCommand } from './session/session-logout.command';
 export { SessionRevokeAllContractCommand } from './session/session-revoke-all.command';

package/commands/order-attachment/create-order-attachment.command.ts

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+import {
+    CreateOrderAttachmentRequestSchema,
+    CreateOrderAttachmentResponseSchema,
+} from '../../schemas/order-attachment/order-attachment.schema';
+
+export namespace CreateOrderAttachmentContractCommand {
+    export const RequestSchema = CreateOrderAttachmentRequestSchema;
+    export type Request = z.infer<typeof RequestSchema>;
+
+    export const ResponseSchema = CreateOrderAttachmentResponseSchema;
+    export type Response = z.infer<typeof ResponseSchema>;
+}

package/commands/order-attachment/delete-order-attachment.command.ts

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+import { DeleteOrderAttachmentResponseSchema } from '../../schemas/order-attachment/order-attachment.schema';
+
+export namespace DeleteOrderAttachmentContractCommand {
+    export const ResponseSchema = DeleteOrderAttachmentResponseSchema;
+    export type Response = z.infer<typeof ResponseSchema>;
+}

package/commands/order-attachment/get-order-attachment-list-for-client.query.ts

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+import { GetOrderAttachmentListForClientResponseSchema } from '../../schemas/order-attachment/order-attachment-for-client.schema';
+
+export namespace GetOrderAttachmentListForClientContractQuery {
+    export const ResponseSchema = GetOrderAttachmentListForClientResponseSchema;
+    export type Response = z.infer<typeof ResponseSchema>;
+}

package/commands/order-attachment/get-order-attachment-list.query.ts

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+import { GetOrderAttachmentListResponseSchema } from '../../schemas/order-attachment/order-attachment.schema';
+
+export namespace GetOrderAttachmentListContractQuery {
+    export const ResponseSchema = GetOrderAttachmentListResponseSchema;
+    export type Response = z.infer<typeof ResponseSchema>;
+}

package/commands/order-attachment/index.ts

@@ -0,0 +1,5 @@
+export * from './create-order-attachment.command';
+export * from './update-order-attachment.command';
+export * from './delete-order-attachment.command';
+export * from './get-order-attachment-list.query';
+export * from './get-order-attachment-list-for-client.query';

package/commands/order-attachment/update-order-attachment.command.ts

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+import {
+    UpdateOrderAttachmentRequestSchema,
+    UpdateOrderAttachmentResponseSchema,
+} from '../../schemas/order-attachment/order-attachment.schema';
+
+export namespace UpdateOrderAttachmentContractCommand {
+    export const RequestSchema = UpdateOrderAttachmentRequestSchema;
+    export type Request = z.infer<typeof RequestSchema>;
+
+    export const ResponseSchema = UpdateOrderAttachmentResponseSchema;
+    export type Response = z.infer<typeof ResponseSchema>;
+}

package/constant/error.ts

@@ -476,6 +476,11 @@ export const ERRORS = {
     ORDER_SERVICE_LINE_NOT_DELETED: { code: 'OSL004', message: 'Service in order not deleted', httpCode: 500 },
     ORDER_SERVICE_LINE_NOT_UPDATED: { code: 'OSL005', message: 'Service in order not updated', httpCode: 500 },
     ORDER_SERVICE_LINE_MODIFY_NOT_ALLOWED: { code: 'OSL006', message: 'Modifying order services is not allowed', httpCode: 409 },
+    ORDER_ATTACHMENT_NOT_CREATED: { code: 'OAT001', message: 'Failed to attach file to order', httpCode: 500 },
+    ORDER_ATTACHMENT_FETCH_FAILED: { code: 'OAT002', message: 'Error when retrieving order attachments', httpCode: 500 },
+    ORDER_ATTACHMENT_NOT_FOUND: { code: 'OAT003', message: 'Order attachment not found', httpCode: 404 },
+    ORDER_ATTACHMENT_NOT_DELETED: { code: 'OAT004', message: 'Order attachment not deleted', httpCode: 500 },
+    ORDER_ATTACHMENT_NOT_UPDATED: { code: 'OAT005', message: 'Order attachment not updated', httpCode: 500 },
 
     //ORDER DELIVERY
     ORDER_DELIVERY_ALREADY_EXIST: { code: 'OD006', message: 'Delivery for the order already exists', httpCode: 409 },

package/enum/action-log-type.enum.ts

@@ -72,6 +72,9 @@ export enum ActionLogTypeEnum {
     DELETE_COLLECTION_ITEMS = 'DELETE_COLLECTION_ITEMS',
     MOVE_COLLECTION_ITEMS = 'MOVE_COLLECTION_ITEMS',
     UPDATE_COLLECTION_ITEM_MULTIPLICITY_OPTIONS = 'UPDATE_COLLECTION_ITEM_MULTIPLICITY_OPTIONS',
+    CREATE_ORDER_ATTACHMENT = 'CREATE_ORDER_ATTACHMENT',
+    UPDATE_ORDER_ATTACHMENT = 'UPDATE_ORDER_ATTACHMENT',
+    DELETE_ORDER_ATTACHMENT = 'DELETE_ORDER_ATTACHMENT',
     UPDATE_CLIENT_MARKING = 'UPDATE_CLIENT_MARKING',
     UPDATE_CLIENT_PROFILE = 'UPDATE_CLIENT_PROFILE',
     COPY_PREORDER_COLLECTION = 'COPY_PREORDER_COLLECTION',

package/enum/index.ts

@@ -5,6 +5,8 @@ export * from './outbound-sync-intent.enum';
 export * from './outbound-sync-status.enum';
 export * from './order-type.enum';
 export * from './order-status.enum';
+export * from './order-attachment-type.enum';
+export * from './order-attachment-updated-field.enum';
 export * from './order-product-verify-source.enum';
 export * from './order-restricted-status-list';
 export * from './order-balance-status-list';

package/enum/order-attachment-type.enum.ts

@@ -0,0 +1,5 @@
+/** Что прикрепили к заказу: загруженный файл или внешняя ссылка. */
+export enum OrderAttachmentTypeEnum {
+    FILE = 'FILE',
+    LINK = 'LINK',
+}

package/enum/order-attachment-updated-field.enum.ts

@@ -0,0 +1,5 @@
+/** Поля вложения заказа, изменение которых попадает в журнал. Ссылку и тип не правят: их меняют пересозданием. */
+export enum OrderAttachmentUpdatedFieldEnum {
+    NAME = 'NAME',
+    IS_VISIBLE_TO_CLIENT = 'IS_VISIBLE_TO_CLIENT',
+}

package/package.json

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

package/schemas/action-log/action-log-payload.schema.ts

@@ -78,6 +78,9 @@ import { CollectionItemsMoveActionLogSchema } from './collection-items-move-acti
 import { CollectionItemMultiplicityOptionsActionLogSchema } from './collection-item-multiplicity-options-action-log.schema';
 import { ClientMarkingActionLogSchema } from './client-marking-action-log.schema';
 import { ClientProfileActionLogSchema } from './client-profile-action-log.schema';
+import { OrderAttachmentCreateActionLogSchema } from './order-attachment-create-action-log.schema';
+import { OrderAttachmentUpdateActionLogSchema } from './order-attachment-update-action-log.schema';
+import { OrderAttachmentDeleteActionLogSchema } from './order-attachment-delete-action-log.schema';
 
 export const ActionLogPayloadSchema = z.union([
     OrderDeleteActionLogPayloadSchema,
@@ -153,5 +156,8 @@ export const ActionLogPayloadSchema = z.union([
     CollectionItemMultiplicityOptionsActionLogSchema,
     ClientMarkingActionLogSchema,
     ClientProfileActionLogSchema,
+    OrderAttachmentCreateActionLogSchema,
+    OrderAttachmentUpdateActionLogSchema,
+    OrderAttachmentDeleteActionLogSchema,
     z.null(),
 ]);

package/schemas/action-log/action-log.schema.ts

@@ -79,6 +79,9 @@ import { PreOrderCollectionCopyActionLogSchema } from './pre-order-collection-co
 
 import { CollectionItemsMoveActionLogSchema } from './collection-items-move-action-log.schema';
 import { CollectionItemMultiplicityOptionsActionLogSchema } from './collection-item-multiplicity-options-action-log.schema';
+import { OrderAttachmentCreateActionLogSchema } from './order-attachment-create-action-log.schema';
+import { OrderAttachmentUpdateActionLogSchema } from './order-attachment-update-action-log.schema';
+import { OrderAttachmentDeleteActionLogSchema } from './order-attachment-delete-action-log.schema';
 import { ClientMarkingActionLogSchema } from './client-marking-action-log.schema';
 import { ClientProfileActionLogSchema } from './client-profile-action-log.schema';
 
@@ -463,6 +466,24 @@ export const ActionLogSchema = z.discriminatedUnion('actionType', [
             payload: CollectionItemMultiplicityOptionsActionLogSchema,
         })
         .merge(BaseActionFields),
+    z
+        .object({
+            actionType: z.literal(ActionLogTypeEnum.CREATE_ORDER_ATTACHMENT),
+            payload: OrderAttachmentCreateActionLogSchema,
+        })
+        .merge(BaseActionFields),
+    z
+        .object({
+            actionType: z.literal(ActionLogTypeEnum.UPDATE_ORDER_ATTACHMENT),
+            payload: OrderAttachmentUpdateActionLogSchema,
+        })
+        .merge(BaseActionFields),
+    z
+        .object({
+            actionType: z.literal(ActionLogTypeEnum.DELETE_ORDER_ATTACHMENT),
+            payload: OrderAttachmentDeleteActionLogSchema,
+        })
+        .merge(BaseActionFields),
     z
         .object({
             actionType: z.literal(ActionLogTypeEnum.UPDATE_CLIENT_MARKING),

package/schemas/action-log/index.ts

@@ -81,3 +81,7 @@ export * from './collection-item-multiplicity-options-action-log.schema';
 export * from './client-marking-action-log.schema';
 export * from './client-profile-action-log.schema';
 export * from './pre-order-collection-copy-action-log.schema';
+export * from './order-attachment-info.schema';
+export * from './order-attachment-create-action-log.schema';
+export * from './order-attachment-update-action-log.schema';
+export * from './order-attachment-delete-action-log.schema';

package/schemas/action-log/order-attachment-create-action-log.schema.ts

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+import { OrderAttachmentInfoSchema } from './order-attachment-info.schema';
+
+/** К заказу прикрепили файл или ссылку. */
+export const OrderAttachmentCreateActionLogSchema = z.object({
+    attachment: OrderAttachmentInfoSchema,
+});

package/schemas/action-log/order-attachment-delete-action-log.schema.ts

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+import { OrderAttachmentInfoSchema } from './order-attachment-info.schema';
+
+/** Вложение сняли с заказа. Снимок берётся до удаления: записи в базе после него уже нет. */
+export const OrderAttachmentDeleteActionLogSchema = z.object({
+    attachment: OrderAttachmentInfoSchema,
+});

package/schemas/action-log/order-attachment-info.schema.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+import { OrderAttachmentTypeEnum } from '../../enum/order-attachment-type.enum';
+
+/** Снимок вложения заказа на момент события: чем прикрепили, как подписано и видит ли клиент. */
+export const OrderAttachmentInfoSchema = z.object({
+    orderUUID: z.string(),
+    attachmentUUID: z.string(),
+    type: z.nativeEnum(OrderAttachmentTypeEnum),
+    name: z.string(),
+    url: z.string(),
+    isVisibleToClient: z.boolean(),
+});

package/schemas/action-log/order-attachment-update-action-log.schema.ts

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+import { OrderAttachmentUpdatedFieldEnum } from '../../enum/order-attachment-updated-field.enum';
+import { OrderAttachmentInfoSchema } from './order-attachment-info.schema';
+
+/**
+ * Правка вложения: снимок до правки и изменённые поля. Переключатель видимости меняет то, что
+ * контрагент видит в своём заказе, поэтому смена этого поля должна быть видна в истории.
+ */
+export const OrderAttachmentUpdateActionLogSchema = z.object({
+    attachment: OrderAttachmentInfoSchema,
+    changes: z
+        .array(
+            z.object({
+                field: z.nativeEnum(OrderAttachmentUpdatedFieldEnum),
+                oldValue: z.string().nullable(),
+                newValue: z.string().nullable(),
+            }),
+        )
+        .min(1),
+});

package/schemas/index.ts

@@ -58,6 +58,8 @@ export * from './discount-rules/discount-rules.schema';
 export * from './package/validate-package.schema';
 export * from './service/service.schema';
 export * from './order-service-line/order-service-line.schema';
+export * from './order-attachment/order-attachment.schema';
+export * from './order-attachment/order-attachment-for-client.schema';
 export * from './distribution/validate-distribution-by-product.schema';
 export * from './consignment/consignment-distribution-validation.schema';
 export * from './product-image-template/product-image-template.schema';

package/schemas/order-attachment/order-attachment-for-client.schema.ts

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+import { OrderAttachmentSchema } from './order-attachment.schema';
+
+/** Вложение глазами клиента: без автора-сотрудника и без флага видимости, который для него всегда включён. */
+export const OrderAttachmentForClientSchema = OrderAttachmentSchema.pick({
+    uuid: true,
+    orderUUID: true,
+    type: true,
+    name: true,
+    url: true,
+    createdAt: true,
+});
+
+export const GetOrderAttachmentListForClientResponseSchema = z.object({
+    data: z.object({
+        attachmentList: z.array(OrderAttachmentForClientSchema),
+    }),
+});

package/schemas/order-attachment/order-attachment.schema.ts

@@ -0,0 +1,63 @@
+import { z } from 'zod';
+import { OrderAttachmentTypeEnum } from '../../enum/order-attachment-type.enum';
+
+/**
+ * Ссылка на файл в бакете (для FILE её отдаёт `PUT /files/upload-file`) или внешний адрес (для LINK).
+ * Схему не сужаем до домена CDN: в LINK кладут ссылки на сторонние сервисы доставки.
+ *
+ * Протокол только http/https: `z.url()` сам по себе принимает и `javascript:`, и `data:text/html`,
+ * а вложение с включённой видимостью витрина отдаёт клиенту и рисует ссылкой — то есть сотрудник
+ * мог бы подложить контрагенту исполняемый адрес.
+ */
+const OrderAttachmentUrlSchema = z.url({ protocol: /^https?$/ }).max(2048);
+
+const OrderAttachmentNameSchema = z.string().trim().min(1).max(255);
+
+export const OrderAttachmentSchema = z.object({
+    uuid: z.uuid(),
+    orderUUID: z.uuid(),
+    type: z.nativeEnum(OrderAttachmentTypeEnum),
+    name: OrderAttachmentNameSchema,
+    url: OrderAttachmentUrlSchema,
+    isVisibleToClient: z.boolean(),
+    createdByUserUUID: z.uuid(),
+    createdAt: z.date(),
+    updatedAt: z.date(),
+});
+
+export const CreateOrderAttachmentRequestSchema = z.object({
+    type: z.nativeEnum(OrderAttachmentTypeEnum),
+    name: OrderAttachmentNameSchema,
+    url: OrderAttachmentUrlSchema,
+    // По умолчанию вложение внутреннее: клиент увидит его, только когда это включат явно.
+    isVisibleToClient: z.boolean().optional().default(false),
+});
+
+export const CreateOrderAttachmentResponseSchema = z.object({
+    data: OrderAttachmentSchema,
+});
+
+export const UpdateOrderAttachmentRequestSchema = z
+    .object({
+        name: OrderAttachmentNameSchema.optional(),
+        isVisibleToClient: z.boolean().optional(),
+    })
+    .refine(data => data.name !== undefined || data.isVisibleToClient !== undefined, {
+        message: 'validation.emptyUpdate',
+    });
+
+export const UpdateOrderAttachmentResponseSchema = z.object({
+    data: OrderAttachmentSchema,
+});
+
+export const GetOrderAttachmentListResponseSchema = z.object({
+    data: z.object({
+        attachmentList: z.array(OrderAttachmentSchema),
+    }),
+});
+
+export const DeleteOrderAttachmentResponseSchema = z.object({
+    data: z.object({
+        success: z.boolean(),
+    }),
+});