pn-new-crm/tests/e2e/realapi/documenso-real-api.spec.ts

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

import { login, apiHeaders } from '../smoke/helpers';

/**
 * Real-API end-to-end test for the Documenso documenso-template pathway.
 *
 * This spec exercises the SEND side of the integration only - it creates a
 * fully-loaded interest, fires generate-and-sign, and asserts both
 *   (a) the CRM persisted a documensoId on the documents row, and
 *   (b) Documenso itself returns 200 for the freshly-created document.
 *
 * The receive side (webhook → state update) is validated separately by
 * triggering a real signing event in the Documenso UI and watching
 * /tmp/dev-server.log; it isn't automated here because Documenso has no
 * machine-friendly "sign on behalf of recipient" endpoint we can drive
 * deterministically from CI.
 *
 * Requires DOCUMENSO_API_URL + DOCUMENSO_API_KEY + DOCUMENSO_TEMPLATE_ID_EOI
 * in the environment (loaded via dotenv).
 */

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

test.describe('Documenso real-API: documenso-template pathway', () => {
  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 creates a real Documenso document', async ({ page }) => {
    const stamp = Date.now();
    const headers = await apiHeaders(page);

    // ─── 1. Seed client (with a contact email so Documenso has a recipient) ──
    const clientRes = await page.request.post('/api/v1/clients', {
      headers,
      data: {
        fullName: `Documenso E2E Client ${stamp}`,
        contacts: [
          { channel: 'email', value: `documenso-e2e-${stamp}@example.test`, isPrimary: true },
        ],
      },
    });
    expect(clientRes.ok(), `client create: ${clientRes.status()} ${await clientRes.text()}`).toBe(
      true,
    );
    const clientId = (await clientRes.json()).data.id as string;

    // ─── 2. Seed yacht owned by that client ──────────────────────────────────
    const yachtRes = await page.request.post('/api/v1/yachts', {
      headers,
      data: {
        name: `E2E Yacht ${stamp}`,
        owner: { type: 'client', id: clientId },
      },
    });
    expect(yachtRes.ok(), `yacht create: ${yachtRes.status()} ${await yachtRes.text()}`).toBe(true);
    const yachtId = (await yachtRes.json()).data.id as string;

    // ─── 3. Seed berth ───────────────────────────────────────────────────────
    const berthRes = await page.request.post('/api/v1/berths', {
      headers,
      data: {
        mooringNumber: `E2E-${stamp}`,
        area: 'Test Area',
      },
    });
    expect(berthRes.ok(), `berth create: ${berthRes.status()} ${await berthRes.text()}`).toBe(true);
    const berthId = (await berthRes.json()).data.id as string;

    // ─── 4. Create the interest linking all three ────────────────────────────
    const interestRes = await page.request.post('/api/v1/interests', {
      headers,
      data: { clientId, yachtId, berthId, pipelineStage: 'open' },
    });
    expect(
      interestRes.ok(),
      `interest create: ${interestRes.status()} ${await interestRes.text()}`,
    ).toBe(true);
    const interestId = (await interestRes.json()).data.id as string;

    // ─── 5. 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,
          clientId,
          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 on response').toBeTruthy();
    expect(body.data.document.status).toBe('sent');

    const documensoId = body.data.document.documensoId!;

    // ─── 6. Verify the document exists on the Documenso side ─────────────────
    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;
      recipients?: Array<{ email: string; signingStatus: string }>;
    };

    expect(String(documensoDoc.id)).toBe(documensoId);
    // Freshly-sent doc should be PENDING (or DRAFT if Documenso queued it).
    expect(['PENDING', 'DRAFT'], `unexpected status ${documensoDoc.status}`).toContain(
      documensoDoc.status,
    );
    // The template is configured with ≥1 recipient role, so we should have
    // at least the client's email populated.
    expect(documensoDoc.recipients?.length ?? 0).toBeGreaterThan(0);
  });
});