pn-new-crm/src/app/api/v1/admin/documenso/sync-template/[templateId]/route.ts

import { NextResponse } from 'next/server';

import { withAuth, withPermission } from '@/lib/api/helpers';
import { errorResponse, NotFoundError, ValidationError } from '@/lib/errors';
import { findTemplateIdByEnvelopeId } from '@/lib/services/documenso-client';
import { syncDocumensoTemplate } from '@/lib/services/documenso-template-sync.service';

/**
 * POST /api/v1/admin/documenso/sync-template/:templateId
 *
 * Calls Documenso's GET /template/{id} via the configured per-port creds,
 * pre-fills the matching documenso_*_recipient_id settings, and caches the
 * field name→ID map at documenso_eoi_field_map for v2 prefillFields usage.
 *
 * Accepts either a numeric template ID (`123`) or a Documenso 2.x envelope
 * ID (`envelope_xxxxxxxx`) — the latter is what the Documenso UI URL shows,
 * so paste-from-URL works out of the box on v2 instances. Envelope IDs get
 * resolved to their numeric template id via `findTemplateIdByEnvelopeId`
 * before the sync runs.
 *
 * Admin-only via `admin.manage_settings`. Audit-logged through the per-field
 * writeSetting calls inside the service.
 */
export const POST = withAuth(
  withPermission('admin', 'manage_settings', async (_req, ctx, params) => {
    try {
      const raw = params.templateId ?? '';
      let templateId: number;

      if (/^envelope_/.test(raw)) {
        const resolved = await findTemplateIdByEnvelopeId(raw, ctx.portId);
        if (!resolved) {
          throw new NotFoundError(`Template "${raw}" — no matching envelopeId found`);
        }
        templateId = resolved;
      } else {
        templateId = Number(raw);
        if (!Number.isInteger(templateId) || templateId <= 0) {
          throw new ValidationError(
            'templateId must be a positive integer or a Documenso envelopeId (envelope_…)',
          );
        }
      }

      const result = await syncDocumensoTemplate(templateId, ctx.portId, {
        userId: ctx.userId,
        portId: ctx.portId,
        ipAddress: ctx.ipAddress,
        userAgent: ctx.userAgent,
      });
      return NextResponse.json({ data: result });
    } catch (error) {
      return errorResponse(error);
    }
  }),
);