feat: enhance document attachment updates and audit logging

- Implemented detailed handling for document attachment updates in DocumentHistorySheet.
- Updated updateDocument function to log changes only when attachments differ.
- Enhanced ZDocumentSchema to include attachment type validation.
- Refined audit log formatting for document attachment updates to improve clarity.

packages/lib/server-only/document/update-document.ts

@@ -242,7 +242,7 @@ export const updateDocument = async ({
     );
   }
 
-  if (data.attachments) {
+  if (!isAttachmentsSame) {
     auditLogs.push(
       createDocumentAuditLogData({
         type: DOCUMENT_AUDIT_LOG_TYPE.DOCUMENT_ATTACHMENTS_UPDATED,
@@ -250,7 +250,7 @@ export const updateDocument = async ({
         metadata: requestMetadata,
         data: {
           from: document.attachments,
-          to: data.attachments,
+          to: data.attachments ?? [],
         },
       }),
     );

packages/lib/types/document.ts

@@ -64,6 +64,7 @@ export const ZDocumentSchema = DocumentSchema.pick({
     id: true,
     label: true,
     url: true,
+    type: true,
   })
     .array()
     .optional(),

packages/lib/utils/document-audit-logs.ts

@@ -388,9 +388,9 @@ export const formatDocumentAuditLogAction = (
       anonymous: msg`Document completed`,
       identified: msg`Document completed`,
     }))
-    .with({ type: DOCUMENT_AUDIT_LOG_TYPE.DOCUMENT_ATTACHMENTS_UPDATED }, ({ data }) => ({
+    .with({ type: DOCUMENT_AUDIT_LOG_TYPE.DOCUMENT_ATTACHMENTS_UPDATED }, () => ({
       anonymous: msg`Document attachments updated`,
-      identified: msg`${prefix} updated the document attachments ${data.to.map((a) => a.label).join(', ')}`,
+      identified: msg`${prefix} updated the document attachments`,
     }))
     .exhaustive();