Queue updates to handle workflow triggering

src-ui/src/app/components/document-detail/document-detail.component.spec.ts

@@ -1236,6 +1236,24 @@ describe('DocumentDetailComponent', () => {
     expect(confirmDialog.messageBold).toContain('Document was updated at')
   })
 
+  it('should queue incoming update while network is active and flush after', () => {
+    initNormally()
+    const loadSpy = jest.spyOn(component as any, 'loadDocument')
+
+    component.networkActive = true
+    ;(component as any).handleIncomingDocumentUpdated({
+      document_id: component.documentId,
+      modified: '2026-02-17T00:00:00Z',
+    })
+
+    expect(loadSpy).not.toHaveBeenCalled()
+
+    component.networkActive = false
+    ;(component as any).flushPendingIncomingUpdate()
+
+    expect(loadSpy).toHaveBeenCalledWith(component.documentId, true)
+  })
+
   it('should change preview element by render type', () => {
     initNormally()
     component.document.archived_file_name = 'file.pdf'

src-ui/src/app/components/document-detail/document-detail.component.ts

@@ -144,6 +144,11 @@ enum ContentRenderType {
   TIFF = 'tiff',
 }
 
+interface IncomingDocumentUpdate {
+  document_id: number
+  modified?: string
+}
+
 @Component({
   selector: 'pngx-document-detail',
   templateUrl: './document-detail.component.html',
@@ -265,6 +270,7 @@ export class DocumentDetailComponent
   unsubscribeNotifier: Subject<any> = new Subject()
   docChangeNotifier: Subject<any> = new Subject()
   private incomingUpdateModal: NgbModalRef
+  private pendingIncomingUpdate: IncomingDocumentUpdate
 
   requiresPassword: boolean = false
   password: string
@@ -483,8 +489,16 @@ export class DocumentDetailComponent
     this.incomingUpdateModal = null
   }
 
+  private flushPendingIncomingUpdate() {
+    if (!this.pendingIncomingUpdate || this.networkActive) return
+    const pendingUpdate = this.pendingIncomingUpdate
+    this.pendingIncomingUpdate = null
+    this.handleIncomingDocumentUpdated(pendingUpdate)
+  }
+
   private loadDocument(documentId: number, forceRemote: boolean = false): void {
     this.closeIncomingUpdateModal()
+    this.pendingIncomingUpdate = null
     this.previewUrl = this.documentsService.getPreviewUrl(documentId)
     this.updatePdfSource()
     this.http
@@ -578,12 +592,17 @@ export class DocumentDetailComponent
       })
   }
 
-  private handleIncomingDocumentUpdated(data: {
+  private handleIncomingDocumentUpdated(data: IncomingDocumentUpdate): void {
-    document_id: number
+    if (
-    modified?: string
+      !this.documentId ||
-  }): void {
+      !this.document ||
-    if (!this.documentId || data.document_id !== this.documentId) return
+      data.document_id !== this.documentId
-    if (!this.document || this.networkActive) return
+    )
+      return
+    if (this.networkActive) {
+      this.pendingIncomingUpdate = data
+      return
+    }
 
     if (this.openDocumentService.isDirty(this.document)) {
       this.showIncomingUpdateModal(data.modified)
@@ -1064,11 +1083,13 @@ export class DocumentDetailComponent
           this.networkActive = false
           this.error = null
           if (close) {
+            this.pendingIncomingUpdate = null
             this.close(() =>
               this.openDocumentService.refreshDocument(this.documentId)
             )
           } else {
             this.openDocumentService.refreshDocument(this.documentId)
+            this.flushPendingIncomingUpdate()
           }
           this.savedViewService.maybeRefreshDocumentCounts()
         },
@@ -1093,6 +1114,7 @@ export class DocumentDetailComponent
               error
             )
           }
+          this.flushPendingIncomingUpdate()
         },
       })
   }
@@ -1132,6 +1154,7 @@ export class DocumentDetailComponent
           this.closeIncomingUpdateModal()
           this.error = null
           this.networkActive = false
+          this.pendingIncomingUpdate = null
           if (closeResult && updateResult && nextDocId) {
             this.router.navigate(['documents', nextDocId])
             this.titleInput?.focus()
@@ -1141,6 +1164,7 @@ export class DocumentDetailComponent
           this.networkActive = false
           this.error = error.error
           this.toastService.showError($localize`Error saving document`, error)
+          this.flushPendingIncomingUpdate()
         },
       })
   }