calendar/packages/features/routing-forms/lib/handleResponse.ts

import routerGetCrmContactOwnerEmail from "@calcom/app-store/routing-forms/lib/crmRouting/routerGetCrmContactOwnerEmail";
import {
  onSubmissionOfFormResponse,
  type TargetRoutingFormForResponse,
} from "@calcom/app-store/routing-forms/lib/formSubmissionUtils";
import isRouter from "@calcom/app-store/routing-forms/lib/isRouter";
import { RouteActionType } from "@calcom/app-store/routing-forms/zod";
import { RoutingFormResponseRepository } from "@calcom/features/routing-forms/repositories/RoutingFormResponseRepository";
import type { RoutingFormTraceService } from "@calcom/features/routing-trace/domains/RoutingFormTraceService";
import type { RoutingTraceService } from "@calcom/features/routing-trace/services/RoutingTraceService";
import { emailSchema } from "@calcom/lib/emailSchema";
import { HttpError } from "@calcom/lib/http-error";
import logger from "@calcom/lib/logger";
import { safeStringify } from "@calcom/lib/safeStringify";
import { withReporting } from "@calcom/lib/sentryWrapper";
import { prisma } from "@calcom/prisma";
import { Prisma } from "@calcom/prisma/client";
import { z } from "zod";
import { findTeamMembersMatchingAttributeLogic } from "./findTeamMembersMatchingAttributeLogic";

const moduleLogger = logger.getSubLogger({ prefix: ["routing-forms/lib/handleResponse"] });

const _handleResponse = async ({
  response,
  identifierKeyedResponse,
  form,
  // Unused but probably should be used
  // formFillerId,
  chosenRouteId,
  isPreview,
  queueFormResponse,
  fetchCrm,
  traceService,
  routingFormTraceService,
}: {
  response: Record<
    string,
    {
      value: string | number | string[];
      label: string;
      identifier?: string;
    }
  >;
  identifierKeyedResponse: Record<string, string | string[]> | null;
  form: TargetRoutingFormForResponse;
  formFillerId: string;
  chosenRouteId: string | null;
  isPreview: boolean;
  queueFormResponse?: boolean;
  fetchCrm?: boolean;
  traceService?: RoutingTraceService;
  routingFormTraceService?: RoutingFormTraceService;
}) => {
  try {
    if (!form.fields) {
      // There is no point in submitting a form that doesn't have fields defined
      throw new HttpError({ statusCode: 400 });
    }

    const formTeamId = form.teamId;
    const formOrgId = form.team?.parentId ?? null;
    const serializableFormWithFields = {
      ...form,
      fields: form.fields,
    };

    const missingFields = serializableFormWithFields.fields
      .filter((field) => !(field.required ? response[field.id]?.value : true))
      .map((f) => f.label);

    if (missingFields.length) {
      throw new HttpError({
        statusCode: 400,
        message: `Missing required fields ${missingFields.join(", ")}`,
      });
    }
    const invalidFields = serializableFormWithFields.fields
      .filter((field) => {
        const fieldValue = response[field.id]?.value;
        // The field isn't required at this point. Validate only if it's set
        if (!fieldValue) {
          return false;
        }
        let schema;
        if (field.type === "email") {
          schema = emailSchema;
        } else if (field.type === "phone") {
          schema = z.any();
        } else {
          schema = z.any();
        }
        return !schema.safeParse(fieldValue).success;
      })
      .map((f) => ({ label: f.label, type: f.type, value: response[f.id]?.value }));

    if (invalidFields.length) {
      throw new HttpError({
        statusCode: 400,
        message: `Invalid value for fields ${invalidFields
          .map((f) => `'${f.label}' with value '${f.value}' should be valid ${f.type}`)
          .join(", ")}`,
      });
    }

    const chosenRoute = serializableFormWithFields.routes?.find((route) => route.id === chosenRouteId);
    let teamMemberIdsMatchingAttributeLogic: number[] | null = null;
    let crmContactOwnerEmail: string | null = null;
    let crmContactOwnerRecordType: string | null = null;
    let crmAppSlug: string | null = null;
    let crmRecordId: string | null = null;
    let timeTaken: Record<string, number | null> = {};
    let checkedFallback = false;
    if (chosenRoute) {
      if (isRouter(chosenRoute)) {
        throw new HttpError({
          statusCode: 400,
          message: "Chosen route is a router",
        });
      }

      const getRoutedMembers = async () =>
        await Promise.all([
          (async () => {
            const contactOwnerQuery =
              identifierKeyedResponse && fetchCrm
                ? await routerGetCrmContactOwnerEmail({
                    attributeRoutingConfig: chosenRoute.attributeRoutingConfig,
                    identifierKeyedResponse,
                    action: chosenRoute.action,
                    routingTraceService: traceService,
                  })
                : null;
            crmContactOwnerEmail = contactOwnerQuery?.email ?? null;
            crmContactOwnerRecordType = contactOwnerQuery?.recordType ?? null;
            crmAppSlug = contactOwnerQuery?.crmAppSlug ?? null;
            crmRecordId = contactOwnerQuery?.recordId ?? null;
          })(),
          (async () => {
            const hasFallbackAction = "fallbackAction" in chosenRoute && chosenRoute.fallbackAction;
            const shouldUseFallbackAttributesQuery =
              !hasFallbackAction || chosenRoute.fallbackAction?.type === RouteActionType.EventTypeRedirectUrl;
            const teamMembersMatchingAttributeLogicWithResult =
              formTeamId && formOrgId
                ? await findTeamMembersMatchingAttributeLogic(
                    {
                      dynamicFieldValueOperands: {
                        response,
                        fields: form.fields || [],
                      },
                      attributesQueryValue: chosenRoute.attributesQueryValue ?? null,
                      fallbackAttributesQueryValue: shouldUseFallbackAttributesQuery
                        ? chosenRoute.fallbackAttributesQueryValue
                        : undefined,
                      teamId: formTeamId,
                      orgId: formOrgId,
                      routeName: chosenRoute.name,
                      routeIsFallback: chosenRoute.isFallback,
                    },
                    {
                      enablePerf: true,
                      routingFormTraceService,
                    }
                  )
                : null;

            moduleLogger.debug(
              "teamMembersMatchingAttributeLogic",
              safeStringify({ teamMembersMatchingAttributeLogicWithResult })
            );

            teamMemberIdsMatchingAttributeLogic =
              teamMembersMatchingAttributeLogicWithResult?.teamMembersMatchingAttributeLogic
                ? teamMembersMatchingAttributeLogicWithResult.teamMembersMatchingAttributeLogic.map(
                    (member) => member.userId
                  )
                : null;

            timeTaken = teamMembersMatchingAttributeLogicWithResult?.timeTaken ?? {};
            checkedFallback = teamMembersMatchingAttributeLogicWithResult?.checkedFallback ?? false;
          })(),
        ]);

      await withReporting(getRoutedMembers, "getRoutedMembers")();
    } else {
      // It currently happens for a Router route. Such a route id isn't present in the form.routes
    }
    const getFallbackAction = () => {
      if (!chosenRoute || !("fallbackAction" in chosenRoute)) {
        return null;
      }

      const hasCrmContactOwner = crmContactOwnerEmail !== null;
      if (hasCrmContactOwner) {
        return null;
      }

      if (checkedFallback) {
        return chosenRoute.fallbackAction;
      }

      const attributesQueryValue =
        "attributesQueryValue" in chosenRoute ? chosenRoute.attributesQueryValue : null;
      const hasAttributeRoutingConfigured =
        attributesQueryValue &&
        typeof attributesQueryValue === "object" &&
        "children1" in attributesQueryValue &&
        attributesQueryValue.children1 &&
        Object.keys(attributesQueryValue.children1 as Record<string, unknown>).length > 0;

      if (hasAttributeRoutingConfigured && teamMemberIdsMatchingAttributeLogic === null) {
        return chosenRoute.fallbackAction;
      }

      return null;
    };

    const fallbackAction = getFallbackAction();

    let dbFormResponse, queuedFormResponse;
    if (!isPreview) {
      const formResponseRepo = new RoutingFormResponseRepository(prisma);
      if (queueFormResponse) {
        queuedFormResponse = await formResponseRepo.recordQueuedFormResponse({
          formId: form.id,
          response,
          chosenRouteId,
          fallbackAction: fallbackAction as Prisma.InputJsonValue | null,
        });
        dbFormResponse = null;
      } else {
        dbFormResponse = await formResponseRepo.recordFormResponse({
          formId: form.id,
          response,
          chosenRouteId,
        });
        queuedFormResponse = null;

        await onSubmissionOfFormResponse({
          form: serializableFormWithFields,
          formResponseInDb: dbFormResponse,
          chosenRouteAction: chosenRoute ? ("action" in chosenRoute ? chosenRoute.action : null) : null,
          fallbackAction,
        });
      }
    } else {
      moduleLogger.debug("Dry run mode - Form response not stored and also webhooks and emails not sent");
      if (queueFormResponse) {
        queuedFormResponse = {
          id: "00000000-0000-0000-0000-000000000000",
          formId: form.id,
          response,
        };
      } else {
        // Create a mock response for dry run
        dbFormResponse = {
          id: 0,
          formId: form.id,
          response,
          chosenRouteId,
          createdAt: new Date(),
          updatedAt: new Date(),
        };
      }
    }

    return {
      isPreview: !!isPreview,
      formResponse: dbFormResponse,
      queuedFormResponse,
      teamMembersMatchingAttributeLogic: teamMemberIdsMatchingAttributeLogic,
      crmContactOwnerEmail,
      crmContactOwnerRecordType,
      crmAppSlug,
      crmRecordId,
      attributeRoutingConfig: chosenRoute
        ? "attributeRoutingConfig" in chosenRoute
          ? chosenRoute.attributeRoutingConfig
          : null
        : null,
      checkedFallback,
      timeTaken,
      fallbackAction,
    };
  } catch (e) {
    if (e instanceof Prisma.PrismaClientKnownRequestError) {
      if (e.code === "P2002") {
        throw new HttpError({
          statusCode: 409,
          message: "Form response already exists",
        });
      }
    }
    throw e;
  }
};

export const handleResponse = withReporting(_handleResponse, "handleResponse");