/** * DOCUMENT_EXPIRED webhook handling — locks in fix(documenso). The handler * was previously defined but never wired to the route's event switch, so * expired EOIs stayed in `sent` / `partially_signed` forever. */ import { describe, expect, it } from 'vitest'; import { eq } from 'drizzle-orm'; import { db } from '@/lib/db'; import { documents, documentEvents } from '@/lib/db/schema/documents'; import { interests, interestBerths } from '@/lib/db/schema/interests'; import { handleDocumentExpired } from '@/lib/services/documents.service'; import { makeBerth, makeClient, makePort } from '../helpers/factories'; describe('handleDocumentExpired', () => { it('flips a sent EOI to expired and writes a documentEvents row', async () => { const port = await makePort(); const client = await makeClient({ portId: port.id }); const documensoId = `documenso-test-${Date.now()}`; const [doc] = await db .insert(documents) .values({ portId: port.id, clientId: client.id, documentType: 'eoi', title: 'Expiring EOI', status: 'sent', documensoId, createdBy: 'seed', }) .returning(); await handleDocumentExpired({ documentId: documensoId }); const after = await db.query.documents.findFirst({ where: eq(documents.id, doc!.id), }); expect(after?.status).toBe('expired'); const events = await db .select() .from(documentEvents) .where(eq(documentEvents.documentId, doc!.id)); expect(events.map((e) => e.eventType)).toContain('expired'); }); it('also flips the linked interest eoiStatus to expired', async () => { const port = await makePort(); const client = await makeClient({ portId: port.id }); const berth = await makeBerth({ portId: port.id }); const [interest] = await db .insert(interests) .values({ portId: port.id, clientId: client.id, pipelineStage: 'eoi_sent', leadCategory: 'hot_lead', eoiStatus: 'sent', }) .returning(); await db.insert(interestBerths).values({ interestId: interest!.id, berthId: berth.id, isPrimary: true, isSpecificInterest: true, }); const documensoId = `documenso-test-${Date.now()}-i`; await db.insert(documents).values({ portId: port.id, clientId: client.id, interestId: interest!.id, documentType: 'eoi', title: 'Expiring EOI for interest', status: 'sent', documensoId, createdBy: 'seed', }); await handleDocumentExpired({ documentId: documensoId }); const updatedInterest = await db.query.interests.findFirst({ where: eq(interests.id, interest!.id), }); expect(updatedInterest?.eoiStatus).toBe('expired'); }); it('is a no-op when the documensoId does not match any document', async () => { // Should NOT throw — the handler logs a warning and returns. Verify no // exception propagates up to the webhook route. await expect( handleDocumentExpired({ documentId: 'definitely-not-a-real-doc' }), ).resolves.toBeUndefined(); }); it('does not flip a document in port B when port A receives the expired event', async () => { // Two ports holding the same documenso_id (legacy data, or a future // Documenso-instance migration that reuses ids). The handler currently // mutates whichever document `findFirst` returns — locking in the // intended behaviour now means a future port_id-aware handler can // be added without regressing this guard. // // Per the audit, this assertion is expected to FAIL until the // deferred port_id-on-handler fix lands. Once it lands, the test // protects against re-introducing the cross-tenant flip. const portA = await makePort(); const portB = await makePort(); const clientA = await makeClient({ portId: portA.id }); const clientB = await makeClient({ portId: portB.id }); const sharedDocumensoId = `documenso-shared-${Date.now()}`; const [docA] = await db .insert(documents) .values({ portId: portA.id, clientId: clientA.id, documentType: 'eoi', title: 'Port A EOI', status: 'sent', documensoId: sharedDocumensoId, createdBy: 'seed', }) .returning(); const [docB] = await db .insert(documents) .values({ portId: portB.id, clientId: clientB.id, documentType: 'eoi', title: 'Port B EOI', status: 'sent', documensoId: sharedDocumensoId, createdBy: 'seed', }) .returning(); // Simulate port A receiving the expired event (the route caller would // resolve this from the secret → port mapping in the deferred fix). await handleDocumentExpired({ documentId: sharedDocumensoId, portId: portA.id }); // Port-A doc flipped, port-B unchanged. Pre-fix, both flip — this // assertion locks the boundary in once the handler scope lands. const afterA = await db.query.documents.findFirst({ where: eq(documents.id, docA!.id) }); const afterB = await db.query.documents.findFirst({ where: eq(documents.id, docB!.id) }); expect(afterA?.status).toBe('expired'); expect(afterB?.status).toBe('sent'); }); });