pn-new-crm/tests/e2e/realapi/sales-journey-signing.spec.ts

import 'dotenv/config';
import { test, expect } from '@playwright/test';

import { login, apiHeaders } from '../smoke/helpers';
import { seedFullyLoadedDeal, changeStage, readStage } from '../fixtures/sales-journey';

/**
 * End-to-end sales journey — Documenso-dependent half.
 *
 * Covers the signing legs of the pipeline that need a live Documenso
 * instance: generating the EOI through the documenso-template pathway
 * and confirming the document is created remotely + persisted locally,
 * then walking the interest forward through the post-signing stages.
 *
 * Skips cleanly when the Documenso env is absent (same guard as
 * `tests/e2e/realapi/documenso-real-api.spec.ts`), so this spec is a
 * no-op in CI runs that don't opt into the real-API project.
 *
 * The deterministic stage/UI assertions for the journey live in
 * `tests/e2e/exhaustive/10-sales-journey.spec.ts`; this file only adds
 * the legs that genuinely require the external signer.
 */

const DOCUMENSO_BASE = process.env.DOCUMENSO_API_URL;
const DOCUMENSO_API_KEY = process.env.DOCUMENSO_API_KEY;

test.describe('realapi: sales journey — Documenso signing legs', () => {
  test.skip(!DOCUMENSO_BASE || !DOCUMENSO_API_KEY, 'DOCUMENSO_API_URL / DOCUMENSO_API_KEY not set');

  test.beforeEach(async ({ page }) => {
    await login(page, 'super_admin');
  });

  test('generate-and-sign EOI then advance the deal through signing stages', async ({ page }) => {
    const headers = await apiHeaders(page);
    const deal = await seedFullyLoadedDeal(page, 'Documenso Journey');

    // ─── 1. Qualify + move into the EOI stage ─────────────────────────────
    await changeStage(page.request, headers, deal.interestId, 'qualified');
    await changeStage(page.request, headers, deal.interestId, 'eoi');
    expect(await readStage(page.request, headers, deal.interestId)).toBe('eoi');

    // ─── 2. Fire generate-and-sign through the documenso-template pathway ──
    const signRes = await page.request.post(
      '/api/v1/document-templates/documenso-template/generate-and-sign',
      {
        headers,
        data: {
          interestId: deal.interestId,
          clientId: deal.clientId,
          berthId: deal.berthId,
          pathway: 'documenso-template',
          signers: [],
        },
      },
    );
    expect(signRes.ok(), `generate-and-sign: ${signRes.status()} ${await signRes.text()}`).toBe(
      true,
    );

    const body = (await signRes.json()) as {
      data: { document: { id: string; documensoId: string | null; status: string } };
    };
    expect(body.data.document.documensoId, 'documensoId persisted locally').toBeTruthy();
    expect(body.data.document.status).toBe('sent');

    // ─── 3. Confirm the document exists on the Documenso side ─────────────
    const documensoId = body.data.document.documensoId!;
    const documensoRes = await page.request.get(
      `${DOCUMENSO_BASE}/api/v1/documents/${documensoId}`,
      { headers: { Authorization: `Bearer ${DOCUMENSO_API_KEY}` } },
    );
    expect(
      documensoRes.ok(),
      `documenso GET: ${documensoRes.status()} ${await documensoRes.text()}`,
    ).toBe(true);
    const documensoDoc = (await documensoRes.json()) as { id: number; status: string };
    expect(String(documensoDoc.id)).toBe(documensoId);
    expect(['PENDING', 'DRAFT'], `unexpected status ${documensoDoc.status}`).toContain(
      documensoDoc.status,
    );

    // ─── 4. Walk the post-EOI legs of the pipeline ────────────────────────
    // The webhook-driven signed → reservation → contract advances happen
    // on real signing events (which Documenso has no machine-driveable
    // "sign on behalf of recipient" endpoint for). We exercise the same
    // forward path the webhook would, recording the deposit en route so
    // the deposit_paid gate is met realistically.
    await changeStage(page.request, headers, deal.interestId, 'reservation');

    const depositRes = await page.request.post(`/api/v1/interests/${deal.interestId}/payments`, {
      headers,
      data: {
        interestId: deal.interestId,
        paymentType: 'deposit',
        amount: '25000',
        currency: 'EUR',
        receivedAt: new Date().toISOString(),
      },
    });
    expect(depositRes.ok(), `deposit: ${depositRes.status()} ${await depositRes.text()}`).toBe(
      true,
    );

    await changeStage(page.request, headers, deal.interestId, 'deposit_paid');
    await changeStage(page.request, headers, deal.interestId, 'contract');
    expect(await readStage(page.request, headers, deal.interestId)).toBe('contract');

    // ─── 5. Complete: tenancy + berth sold ────────────────────────────────
    const tenancyRes = await page.request.post(`/api/v1/berths/${deal.berthId}/tenancies`, {
      headers,
      data: {
        berthId: deal.berthId,
        clientId: deal.clientId,
        yachtId: deal.yachtId,
        interestId: deal.interestId,
        startDate: new Date().toISOString(),
        tenureType: 'permanent',
      },
    });
    expect(
      tenancyRes.ok(),
      `create tenancy: ${tenancyRes.status()} ${await tenancyRes.text()}`,
    ).toBe(true);

    const statusRes = await page.request.patch(`/api/v1/berths/${deal.berthId}/status`, {
      headers,
      data: { status: 'sold', reason: 'Contract signed', interestId: deal.interestId },
    });
    expect(statusRes.ok(), `berth → sold: ${statusRes.status()}`).toBe(true);
    expect(((await statusRes.json()) as { data: { status: string } }).data.status).toBe('sold');
  });
});