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); } }), );