chore: merge with epic/v5

Replace .sort() with .toSorted() to avoid mutating arrays in-place
during chaining, and remove the redundant CreateFeedbackRecordResult
type alias in favor of HubFeedbackRecordResult.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

.claude/scheduled_tasks.lock

@@ -0,0 +1 @@
+{"sessionId":"f77248e2-8840-41c6-968b-c3b7d8a9e913","pid":49125,"acquiredAt":1776168010367}

.env.example

@@ -32,6 +32,24 @@ CRON_SECRET=
 # Set the minimum log level(debug, info, warn, error, fatal)
 LOG_LEVEL=info
 
+# BullMQ workers require REDIS_URL (for example `redis://localhost:6379`) to be set.
+# BullMQ worker startup is enabled by default outside tests. Set to 0 to disable.
+# BULLMQ_WORKER_ENABLED=1
+# Set to 1 on web/API pods that only enqueue jobs while a separate BullMQ worker deployment consumes them.
+# BULLMQ_EXTERNAL_WORKER_ENABLED=0
+
+# Number of BullMQ worker instances started per Formbricks server process.
+# BULLMQ_WORKER_COUNT=1
+
+# Number of concurrent jobs each BullMQ worker can process.
+# BULLMQ_WORKER_CONCURRENCY=1
+
+# Survey publish/close scheduling is configured with public build-time env vars because the editor UI
+# also needs to render the selected execution time and timezone.
+# NEXT_PUBLIC_SURVEY_SCHEDULING_TIME_ZONE=Europe/Berlin
+# NEXT_PUBLIC_SURVEY_SCHEDULING_LOCAL_HOUR=0
+# NEXT_PUBLIC_SURVEY_SCHEDULING_LOCAL_MINUTE=0
+
 ##############
 #  DATABASE  #
 ##############
@@ -149,16 +167,16 @@ AZUREAD_TENANT_ID=
 
 # Configure Formbricks AI at the instance level
 # Set the provider used for AI features on this instance.
-# Accepted values for AI_PROVIDER: aws, gcp, azure
+# Accepted values for AI_PROVIDER: aws, google, azure
 # Set AI_MODEL to the provider-specific model or deployment name and configure the matching credentials below.
-# AI_PROVIDER=gcp
+# AI_PROVIDER=google
 # AI_MODEL=gemini-2.5-flash
 
-# Google Vertex AI credentials
-# AI_GCP_PROJECT=
-# AI_GCP_LOCATION=
-# AI_GCP_CREDENTIALS_JSON=
-# AI_GCP_APPLICATION_CREDENTIALS=
+# Google Cloud credentials for Gemini models
+# AI_GOOGLE_CLOUD_PROJECT=
+# AI_GOOGLE_CLOUD_LOCATION=
+# AI_GOOGLE_CLOUD_CREDENTIALS_JSON=
+# AI_GOOGLE_CLOUD_APPLICATION_CREDENTIALS=
 
 # Amazon Bedrock credentials
 # AI_AWS_REGION=
@@ -278,5 +296,24 @@ REDIS_URL=redis://localhost:6379
 # AUDIT_LOG_GET_USER_IP=0
 
 
+# Cube.js Analytics (optional — only needed for the analytics/dashboard feature)
+# Required when running the Cube service (docker-compose.dev.yml). Generate with: openssl rand -hex 32
+# Use the same value for CUBEJS_API_TOKEN so the client can authenticate.
+# CUBEJS_API_SECRET=
+# URL where the Cube.js instance is running
+# CUBEJS_API_URL=http://localhost:4000
+# API token sent with each Cube.js request; must match CUBEJS_API_SECRET when CUBEJS_DEV_MODE is off
+# CUBEJS_API_TOKEN=
+#
+# Cube connects to the Hub DB. When using docker-compose.dev.yml with the hub network,
+# use the container name and internal port. Hub credentials: formbricks/formbricks_dev, db: hub
+# CUBEJS_DB_HOST=formbricks_hub_postgres
+# CUBEJS_DB_PORT=5432
+# CUBEJS_DB_NAME=hub
+# CUBEJS_DB_USER=formbricks
+# CUBEJS_DB_PASS=formbricks_dev
+#
+# Alternative (when not on same Docker network): host.docker.internal and port 5433
+
 # Lingo.dev API key for translation generation
 LINGO_API_KEY=your_api_key_here

AGENTS.md

@@ -32,6 +32,7 @@ The `@formbricks/surveys` package is pre-compiled (Vite → UMD + ESM) and the b
 
 TypeScript, React, and Prisma are the primary languages. Use the shared ESLint presets (`@formbricks/eslint-config`) and Prettier preset (110-char width, semicolons, double quotes, sorted import groups). Two-space indentation is standard; prefer `PascalCase` for React components and folders under `modules/`, `camelCase` for functions/variables, and `SCREAMING_SNAKE_CASE` only for constants. When adding mocks, place them inside `__mocks__` so import ordering stays stable.
 We are using SonarQube to identify code smells and security hotspots.
+Always mark React component props as `Readonly<>` (e.g., `({ children }: Readonly<MyProps>)`).
 
 ## Architecture & Patterns
 

apps/storybook/package.json

@@ -23,7 +23,7 @@
     "eslint-plugin-react-refresh": "0.4.26",
     "eslint-plugin-storybook": "10.2.17",
     "storybook": "10.2.17",
-    "vite": "7.3.1",
+    "vite": "7.3.2",
     "@storybook/addon-docs": "10.2.17"
   }
 }

apps/web/app/(app)/(onboarding)/workspaces/[workspaceId]/xm-templates/lib/utils.test.ts

@@ -60,8 +60,8 @@ const mockTemplate: TXMTemplate = {
   ],
   styling: {
     brandColor: { light: "#0000FF" },
-    questionColor: { light: "#00FF00" },
-    inputColor: { light: "#FF0000" },
+    elementHeadlineColor: { light: "#00FF00" },
+    inputBgColor: { light: "#FF0000" },
   },
 };
 

apps/web/app/(app)/environments/page.tsx

@@ -1,7 +0,0 @@
-import { redirect } from "next/navigation";
-
-const Page = () => {
-  return redirect("/");
-};
-
-export default Page;

apps/web/app/(app)/workspaces/[workspaceId]/(analysis)/charts/page.tsx

@@ -0,0 +1,8 @@
+import { ChartsListPage } from "@/modules/ee/analysis/charts/components/charts-list-page";
+
+const ChartsPage = async (props: Readonly<{ params: Promise<{ workspaceId: string }> }>) => {
+  const { workspaceId } = await props.params;
+  return <ChartsListPage workspaceId={workspaceId} />;
+};
+
+export default ChartsPage;

apps/web/app/(app)/workspaces/[workspaceId]/(analysis)/dashboards/[dashboardId]/page.tsx

@@ -0,0 +1,7 @@
+import { DashboardDetailPage } from "@/modules/ee/analysis/dashboards/pages/dashboard-detail-page";
+
+const Page = (props: { params: Promise<{ workspaceId: string; dashboardId: string }> }) => {
+  return <DashboardDetailPage params={props.params} />;
+};
+
+export default Page;

apps/web/app/(app)/workspaces/[workspaceId]/(analysis)/dashboards/page.tsx

@@ -0,0 +1,8 @@
+import { DashboardsListPage } from "@/modules/ee/analysis/dashboards/pages/dashboards-list-page";
+
+const DashboardsPage = async (props: Readonly<{ params: Promise<{ workspaceId: string }> }>) => {
+  const { workspaceId } = await props.params;
+  return <DashboardsListPage workspaceId={workspaceId} />;
+};
+
+export default DashboardsPage;

apps/web/app/(app)/workspaces/[workspaceId]/(analysis)/loading.tsx

@@ -0,0 +1,3 @@
+import { AnalysisListLoading } from "@/modules/ee/analysis/loading";
+
+export default AnalysisListLoading;

apps/web/app/(app)/workspaces/[workspaceId]/(workspace)/feedback-sources/page.tsx

@@ -0,0 +1 @@
+export { WorkspaceFeedbackSourcesPage as default } from "@/modules/workspaces/settings/sources/page";

apps/web/app/(app)/workspaces/[workspaceId]/actions.ts

@@ -23,9 +23,13 @@ import { createWorkspace } from "@/modules/workspaces/settings/lib/workspace";
 import { getOrganizationsByUserId } from "./lib/organization";
 import { getWorkspacesByUserId } from "./lib/workspace";
 
+const ZCreateWorkspaceInput = ZWorkspaceUpdateInput.extend({
+  feedbackRecordDirectoryId: ZId.optional(),
+});
+
 const ZCreateWorkspaceAction = z.object({
   organizationId: ZId,
-  data: ZWorkspaceUpdateInput,
+  data: ZCreateWorkspaceInput,
 });
 
 export const createWorkspaceAction = authenticatedActionClient.inputSchema(ZCreateWorkspaceAction).action(
@@ -40,7 +44,7 @@ export const createWorkspaceAction = authenticatedActionClient.inputSchema(ZCrea
       access: [
         {
           data: parsedInput.data,
-          schema: ZWorkspaceUpdateInput,
+          schema: ZCreateWorkspaceInput,
           type: "organization",
           roles: ["owner", "manager"],
         },

apps/web/app/(app)/workspaces/[workspaceId]/components/MainNavigation.tsx

@@ -2,6 +2,7 @@
 
 import {
   ArrowUpRightIcon,
+  BarChart3Icon,
   Building2Icon,
   ChevronRightIcon,
   Cog,
@@ -9,6 +10,7 @@ import {
   Loader2,
   LogOutIcon,
   MessageCircle,
+  MessageSquareTextIcon,
   PanelLeftCloseIcon,
   PanelLeftOpenIcon,
   PlusIcon,
@@ -144,44 +146,77 @@ export const MainNavigation = ({
     }
   }, [pathname]);
 
-  const mainNavigation = useMemo(
+  const mainNavigationSections = useMemo(
     () => [
       {
-        name: t("common.surveys"),
-        href: `/workspaces/${workspace.id}/surveys`,
-        icon: MessageCircle,
-        isActive: pathname?.includes("/surveys"),
-        isHidden: false,
-        disabled: isMembershipPending || isBilling,
+        id: "ask",
+        name: "Ask",
+        items: [
+          {
+            name: t("common.surveys"),
+            href: `/workspaces/${workspace.id}/surveys`,
+            icon: MessageCircle,
+            isActive: pathname?.includes("/surveys"),
+            isHidden: false,
+            disabled: isMembershipPending || isBilling,
+          },
+          {
+            href: `/workspaces/${workspace.id}/contacts`,
+            name: t("common.contacts"),
+            icon: UserIcon,
+            isActive:
+              pathname?.includes("/contacts") ||
+              pathname?.includes("/segments") ||
+              pathname?.includes("/attributes"),
+            disabled: isMembershipPending || isBilling,
+          },
+        ],
       },
       {
-        href: `/workspaces/${workspace.id}/contacts`,
-        name: t("common.contacts"),
-        icon: UserIcon,
-        isActive:
-          pathname?.includes("/contacts") ||
-          pathname?.includes("/segments") ||
-          pathname?.includes("/attributes"),
-        disabled: isMembershipPending || isBilling,
-      },
-      {
-        name: t("common.configuration"),
-        href: `/workspaces/${workspace.id}/general`,
-        icon: Cog,
-        isActive:
-          pathname?.includes("/general") ||
-          pathname?.includes("/look") ||
-          pathname?.includes("/app-connection") ||
-          pathname?.includes("/integrations") ||
-          pathname?.includes("/teams") ||
-          pathname?.includes("/languages") ||
-          pathname?.includes("/tags"),
-        disabled: isMembershipPending || isBilling,
+        id: "unify-feedback",
+        name: t("workspace.unify.unify_feedback"),
+        items: [
+          {
+            name: t("workspace.unify.feedback_records"),
+            href: `/workspaces/${workspace.id}/unify/feedback-records`,
+            icon: MessageSquareTextIcon,
+            isActive: pathname?.includes("/unify/feedback-records"),
+            isHidden: false,
+            disabled: isMembershipPending || isBilling,
+          },
+          {
+            name: t("common.dashboards"),
+            href: `/workspaces/${workspace.id}/dashboards`,
+            icon: BarChart3Icon,
+            isActive: pathname?.includes("/dashboards") || pathname?.includes("/charts"),
+            isHidden: false,
+            disabled: isMembershipPending || isBilling,
+          },
+        ],
       },
     ],
     [t, workspace.id, pathname, isMembershipPending, isBilling]
   );
 
+  const configurationNavigationItem = useMemo(
+    () => ({
+      name: t("common.configuration"),
+      href: `/workspaces/${workspace.id}/general`,
+      icon: Cog,
+      isActive:
+        pathname?.includes("/general") ||
+        pathname?.includes("/look") ||
+        pathname?.includes("/app-connection") ||
+        pathname?.includes("/feedback-sources") ||
+        pathname?.includes("/integrations") ||
+        pathname?.includes("/teams") ||
+        pathname?.includes("/languages") ||
+        pathname?.includes("/tags"),
+      disabled: isMembershipPending || isBilling,
+    }),
+    [t, workspace.id, pathname, isMembershipPending, isBilling]
+  );
+
   const dropdownNavigation = [
     {
       label: t("common.account"),
@@ -240,6 +275,11 @@ export const MainNavigation = ({
       label: t("common.website_and_app_connection"),
       href: `/workspaces/${workspace.id}/app-connection`,
     },
+    {
+      id: "feedback-sources",
+      label: t("workspace.unify.feedback_sources"),
+      href: `/workspaces/${workspace.id}/feedback-sources`,
+    },
     {
       id: "integrations",
       label: t("common.integrations"),
@@ -297,6 +337,15 @@ export const MainNavigation = ({
       href: `/workspaces/${workspace.id}/settings/enterprise`,
       hidden: isFormbricksCloud || isMember,
     },
+    {
+      id: "feedback-record-directories",
+      label: t("workspace.settings.feedback_record_directories.title"),
+      href: `/workspaces/${workspace.id}/settings/feedback-record-directories`,
+      disabled: isMembershipPending || isMember,
+      disabledMessage: isMembershipPending
+        ? t("common.loading")
+        : t("common.you_are_not_authorized_to_perform_this_action"),
+    },
   ];
 
   const loadWorkspaces = useCallback(async () => {
@@ -413,16 +462,22 @@ export const MainNavigation = ({
     : `/workspaces/${workspace.id}/surveys/`;
 
   const handleWorkspaceChange = (workspaceId: string) => {
-    if (workspaceId === workspace.id) return;
+    const targetPath =
+      workspaceId === workspace.id ? `/workspaces/${workspace.id}/surveys` : `/workspaces/${workspaceId}/`;
     startTransition(() => {
-      router.push(`/workspaces/${workspaceId}/`);
+      setIsWorkspaceDropdownOpen(false);
+      router.push(targetPath);
     });
   };
 
   const handleOrganizationChange = (organizationId: string) => {
-    if (organizationId === organization.id) return;
+    const targetPath =
+      organizationId === organization.id
+        ? `/workspaces/${workspace.id}/settings/general`
+        : `/organizations/${organizationId}/`;
     startTransition(() => {
-      router.push(`/organizations/${organizationId}/`);
+      setIsOrganizationDropdownOpen(false);
+      router.push(targetPath);
     });
   };
 
@@ -479,7 +534,7 @@ export const MainNavigation = ({
   );
 
   const switcherIconClasses =
-    "flex h-9 w-9 items-center justify-center rounded-full bg-slate-100 text-slate-600";
+    "flex h-9 w-9 shrink-0 items-center justify-center rounded-full bg-slate-100 text-slate-600";
   const isInitialWorkspacesLoading =
     isWorkspaceDropdownOpen && !hasInitializedWorkspaces && !workspaceLoadError;
 
@@ -521,23 +576,50 @@ export const MainNavigation = ({
             </div>
 
             {/* Main Nav Switch */}
-            <ul>
-              {mainNavigation.map(
-                (item) =>
-                  !item.isHidden && (
-                    <NavigationLink
-                      key={item.name}
-                      href={item.href}
-                      isActive={item.isActive}
-                      isCollapsed={isCollapsed}
-                      isTextVisible={isTextVisible}
-                      disabled={item.disabled}
-                      disabledMessage={item.disabled ? disabledNavigationMessage : undefined}
-                      linkText={item.name}>
-                      <item.icon strokeWidth={1.5} />
-                    </NavigationLink>
-                  )
-              )}
+            <ul className="space-y-2">
+              {mainNavigationSections.map((section) => (
+                <li key={section.id}>
+                  {!isCollapsed && !isTextVisible && (
+                    <p className="px-4 pb-1 pt-2 text-xs font-semibold uppercase tracking-wide text-slate-400">
+                      {section.name}
+                    </p>
+                  )}
+
+                  <ul>
+                    {section.items.map(
+                      (item) =>
+                        !item.isHidden && (
+                          <NavigationLink
+                            key={item.name}
+                            href={item.href}
+                            isActive={item.isActive}
+                            isCollapsed={isCollapsed}
+                            isTextVisible={isTextVisible}
+                            disabled={item.disabled}
+                            disabledMessage={item.disabled ? disabledNavigationMessage : undefined}
+                            linkText={item.name}>
+                            <item.icon strokeWidth={1.5} />
+                          </NavigationLink>
+                        )
+                    )}
+                  </ul>
+                </li>
+              ))}
+
+              <li className={cn("mt-2 border-t border-slate-100 pt-2", isCollapsed && "border-t-0 pt-0")}>
+                <NavigationLink
+                  href={configurationNavigationItem.href}
+                  isActive={configurationNavigationItem.isActive}
+                  isCollapsed={isCollapsed}
+                  isTextVisible={isTextVisible}
+                  disabled={configurationNavigationItem.disabled}
+                  disabledMessage={
+                    configurationNavigationItem.disabled ? disabledNavigationMessage : undefined
+                  }
+                  linkText={configurationNavigationItem.name}>
+                  <configurationNavigationItem.icon strokeWidth={1.5} />
+                </NavigationLink>
+              </li>
             </ul>
           </div>
 

apps/web/app/(app)/workspaces/[workspaceId]/components/organization-breadcrumb.tsx

@@ -117,8 +117,12 @@ export const OrganizationBreadcrumb = ({
   const workspaceBasePath = `/workspaces/${workspace?.id}`;
 
   const handleOrganizationChange = (organizationId: string) => {
-    if (organizationId === currentOrganizationId) return;
     startTransition(() => {
+      setIsOrganizationDropdownOpen(false);
+      if (organizationId === currentOrganizationId && currentWorkspaceId) {
+        router.push(`/workspaces/${currentWorkspaceId}/settings/general`);
+        return;
+      }
       router.push(`/organizations/${organizationId}/`);
     });
   };
@@ -144,12 +148,6 @@ export const OrganizationBreadcrumb = ({
       label: t("common.members_and_teams"),
       href: `${workspaceBasePath}/settings/teams`,
     },
-    {
-      id: "feedback-record-directories",
-      label: t("workspace.settings.feedback_record_directories.nav_label"),
-      href: `${workspaceBasePath}/settings/feedback-record-directories`,
-      hidden: isMember,
-    },
     {
       id: "api-keys",
       label: t("common.api_keys"),
@@ -181,6 +179,15 @@ export const OrganizationBreadcrumb = ({
         ? t("common.loading")
         : t("common.you_are_not_authorized_to_perform_this_action"),
     },
+    {
+      id: "feedback-record-directories",
+      label: t("workspace.settings.feedback_record_directories.title"),
+      href: `${workspaceBasePath}/settings/feedback-record-directories`,
+      disabled: isMembershipPending || isMember,
+      disabledMessage: isMembershipPending
+        ? t("common.loading")
+        : t("common.you_are_not_authorized_to_perform_this_action"),
+    },
   ];
 
   return (

apps/web/app/(app)/workspaces/[workspaceId]/components/workspace-breadcrumb.tsx

@@ -118,6 +118,11 @@ export const WorkspaceBreadcrumb = ({
       label: t("common.website_and_app_connection"),
       href: `${workspaceBasePath}/app-connection`,
     },
+    {
+      id: "feedback-sources",
+      label: t("workspace.unify.feedback_sources"),
+      href: `${workspaceBasePath}/feedback-sources`,
+    },
     {
       id: "integrations",
       label: t("common.integrations"),
@@ -138,6 +143,11 @@ export const WorkspaceBreadcrumb = ({
       label: t("common.tags"),
       href: `${workspaceBasePath}/tags`,
     },
+    {
+      id: "unify",
+      label: t("common.unify"),
+      href: `${workspaceBasePath}/workspace/unify`,
+    },
   ];
 
   const areWorkspaceSettingsDisabled = isMembershipPending || isBilling;
@@ -153,9 +163,13 @@ export const WorkspaceBreadcrumb = ({
   }
 
   const handleWorkspaceChange = (workspaceId: string) => {
-    if (workspaceId === currentWorkspaceId) return;
+    const targetPath =
+      workspaceId === currentWorkspaceId
+        ? `/workspaces/${currentWorkspaceId}/surveys`
+        : `/workspaces/${workspaceId}/`;
     startTransition(() => {
-      router.push(`/workspaces/${workspaceId}/`);
+      setIsWorkspaceDropdownOpen(false);
+      router.push(targetPath);
     });
   };
 

apps/web/app/(app)/workspaces/[workspaceId]/settings/(organization)/enterprise/components/EnterpriseLicenseFeaturesTable.tsx

@@ -8,7 +8,7 @@ import type { TEnterpriseLicenseFeatures } from "@/modules/ee/license-check/type
 import { Badge } from "@/modules/ui/components/badge";
 import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from "@/modules/ui/components/table";
 
-type TPublicLicenseFeatureKey = Exclude<keyof TEnterpriseLicenseFeatures, "isMultiOrgEnabled" | "ai">;
+type TPublicLicenseFeatureKey = Exclude<keyof TEnterpriseLicenseFeatures, "isMultiOrgEnabled">;
 
 type TFeatureDefinition = {
   key: TPublicLicenseFeatureKey;
@@ -61,6 +61,16 @@ const getFeatureDefinitions = (t: TFunction): TFeatureDefinition[] => {
       labelKey: t("workspace.settings.enterprise.license_feature_spam_protection"),
       docsUrl: "https://formbricks.com/docs/xm-and-surveys/surveys/general-features/spam-protection",
     },
+    {
+      key: "aiSmartTools",
+      labelKey: t("workspace.settings.general.ai_smart_tools_enabled"),
+      docsUrl: "https://formbricks.com/docs/self-hosting/configuration/ai",
+    },
+    {
+      key: "aiDataAnalysis",
+      labelKey: t("workspace.settings.general.ai_data_analysis_enabled"),
+      docsUrl: "https://formbricks.com/docs/self-hosting/configuration/ai",
+    },
     {
       key: "auditLogs",
       labelKey: t("workspace.settings.enterprise.license_feature_audit_logs"),

apps/web/app/(app)/workspaces/[workspaceId]/settings/(organization)/general/components/AISettingsToggle.tsx

@@ -6,24 +6,32 @@ import toast from "react-hot-toast";
 import { useTranslation } from "react-i18next";
 import { TOrganizationRole } from "@formbricks/types/memberships";
 import { TOrganization } from "@formbricks/types/organizations";
+import { useWorkspace } from "@/app/(app)/workspaces/[workspaceId]/context/workspace-context";
 import { updateOrganizationAISettingsAction } from "@/app/(app)/workspaces/[workspaceId]/settings/(organization)/general/actions";
 import { getDisplayedOrganizationAISettingValue, getOrganizationAIEnablementState } from "@/lib/ai/utils";
 import { getAccessFlags } from "@/lib/membership/utils";
 import { getFormattedErrorMessage } from "@/lib/utils/helper";
 import { AdvancedOptionToggle } from "@/modules/ui/components/advanced-option-toggle";
 import { Alert, AlertDescription } from "@/modules/ui/components/alert";
+import { type ModalButton, UpgradePrompt } from "@/modules/ui/components/upgrade-prompt";
 
 interface AISettingsToggleProps {
   organization: TOrganization;
   membershipRole?: TOrganizationRole;
   isInstanceAIConfigured: boolean;
+  hasAIPermission: boolean;
+  isFormbricksCloud: boolean;
 }
 
 export const AISettingsToggle = ({
   organization,
   membershipRole,
   isInstanceAIConfigured,
+  hasAIPermission,
+  isFormbricksCloud,
 }: Readonly<AISettingsToggleProps>) => {
+  const { workspace } = useWorkspace();
+  const workspaceBasePath = `/workspaces/${workspace?.id}`;
   const [loadingField, setLoadingField] = useState<string | null>(null);
   const { t } = useTranslation();
   const router = useRouter();
@@ -78,6 +86,32 @@ export const AISettingsToggle = ({
     }
   };
 
+  const upgradeButtons: [ModalButton, ModalButton] = [
+    {
+      text: isFormbricksCloud ? t("common.upgrade_plan") : t("common.request_trial_license"),
+      href: isFormbricksCloud
+        ? `${workspaceBasePath}/settings/billing`
+        : "https://formbricks.com/upgrade-self-hosting-license",
+    },
+    {
+      text: t("common.learn_more"),
+      href: isFormbricksCloud
+        ? `${workspaceBasePath}/settings/billing`
+        : "https://formbricks.com/learn-more-self-hosting-license",
+    },
+  ];
+
+  if (!hasAIPermission) {
+    return (
+      <UpgradePrompt
+        title={t("workspace.settings.general.unlock_ai_features_with_a_higher_plan")}
+        description={t("workspace.settings.general.unlock_ai_features_description")}
+        buttons={upgradeButtons}
+        feature="ai_features"
+      />
+    );
+  }
+
   return (
     <div className="space-y-4">
       {showInstanceConfigWarning && (

apps/web/app/(app)/workspaces/[workspaceId]/settings/(organization)/general/page.tsx

@@ -3,7 +3,12 @@ import { isInstanceAIConfigured } from "@/lib/ai/service";
 import { FB_LOGO_URL, IS_FORMBRICKS_CLOUD, IS_STORAGE_CONFIGURED } from "@/lib/constants";
 import { getUser } from "@/lib/user/service";
 import { getTranslate } from "@/lingodotdev/server";
-import { getIsMultiOrgEnabled, getWhiteLabelPermission } from "@/modules/ee/license-check/lib/utils";
+import {
+  getIsAIDataAnalysisEnabled,
+  getIsAISmartToolsEnabled,
+  getIsMultiOrgEnabled,
+  getWhiteLabelPermission,
+} from "@/modules/ee/license-check/lib/utils";
 import { EmailCustomizationSettings } from "@/modules/ee/whitelabel/email-customization/components/email-customization-settings";
 import { Alert, AlertDescription } from "@/modules/ui/components/alert";
 import { IdBadge } from "@/modules/ui/components/id-badge";
@@ -27,8 +32,14 @@ const Page = async (props: { params: Promise<{ workspaceId: string }> }) => {
 
   const user = session?.user?.id ? await getUser(session.user.id) : null;
 
-  const isMultiOrgEnabled = await getIsMultiOrgEnabled();
-  const hasWhiteLabelPermission = await getWhiteLabelPermission(organization.id);
+  const [isMultiOrgEnabled, hasWhiteLabelPermission, hasAISmartToolsPermission, hasAIDataAnalysisPermission] =
+    await Promise.all([
+      getIsMultiOrgEnabled(),
+      getWhiteLabelPermission(organization.id),
+      getIsAISmartToolsEnabled(organization.id),
+      getIsAIDataAnalysisEnabled(organization.id),
+    ]);
+  const hasAIPermission = hasAISmartToolsPermission || hasAIDataAnalysisPermission;
 
   const isDeleteDisabled = !isOwner || !isMultiOrgEnabled;
   const currentUserRole = currentUserMembership?.role;
@@ -64,6 +75,8 @@ const Page = async (props: { params: Promise<{ workspaceId: string }> }) => {
           organization={organization}
           membershipRole={currentUserMembership?.role}
           isInstanceAIConfigured={isInstanceAIConfigured()}
+          hasAIPermission={hasAIPermission}
+          isFormbricksCloud={IS_FORMBRICKS_CLOUD}
         />
       </SettingsCard>
       <EmailCustomizationSettings

apps/web/app/(app)/workspaces/[workspaceId]/settings/components/SettingsCard.tsx

@@ -21,6 +21,7 @@ export const SettingsCard = ({
   beta,
   className,
   buttonInfo,
+  cta,
 }: {
   title: string;
   description: string;
@@ -30,6 +31,7 @@ export const SettingsCard = ({
   beta?: boolean;
   className?: string;
   buttonInfo?: ButtonInfo;
+  cta?: React.ReactNode;
 }) => {
   const { t } = useTranslation();
   return (
@@ -52,11 +54,12 @@ export const SettingsCard = ({
             {description}
           </Small>
         </div>
-        {buttonInfo && (
-          <Button type="button" onClick={buttonInfo?.onClick} variant={buttonInfo?.variant ?? "default"}>
-            {buttonInfo?.text}
-          </Button>
-        )}
+        {cta ??
+          (buttonInfo && (
+            <Button type="button" onClick={buttonInfo?.onClick} variant={buttonInfo?.variant ?? "default"}>
+              {buttonInfo?.text}
+            </Button>
+          ))}
       </div>
       <div className={cn(noPadding ? "" : "px-4 pt-4")}>{children}</div>
     </div>

apps/web/app/(app)/workspaces/[workspaceId]/surveys/[surveyId]/(analysis)/summary/components/CESSummary.tsx

@@ -0,0 +1,51 @@
+"use client";
+
+import { CircleSlash2, SmileIcon, StarIcon } from "lucide-react";
+import { useMemo } from "react";
+import { useTranslation } from "react-i18next";
+import { type TI18nString } from "@formbricks/types/i18n";
+import { TSurveyElementTypeEnum } from "@formbricks/types/surveys/elements";
+import { TSurvey, TSurveyElementSummaryCes } from "@formbricks/types/surveys/types";
+import { RatingLikeSummary } from "./RatingLikeSummary";
+
+interface CESSummaryProps {
+  elementSummary: TSurveyElementSummaryCes;
+  survey: TSurvey;
+  setFilter: (
+    elementId: string,
+    label: TI18nString,
+    elementType: TSurveyElementTypeEnum,
+    filterValue: string,
+    filterComboBoxValue?: string | string[]
+  ) => void;
+}
+
+export const CESSummary = ({ elementSummary, survey, setFilter }: CESSummaryProps) => {
+  const { t } = useTranslation();
+
+  const getIconBasedOnScale = useMemo(() => {
+    const scale = elementSummary.element.scale;
+    if (scale === "number") return <CircleSlash2 className="h-4 w-4" />;
+    else if (scale === "star") return <StarIcon fill="rgb(250 204 21)" className="h-4 w-4 text-yellow-400" />;
+    else if (scale === "smiley") return <SmileIcon className="h-4 w-4" />;
+  }, [elementSummary.element.scale]);
+
+  return (
+    <RatingLikeSummary
+      elementSummary={elementSummary}
+      survey={survey}
+      setFilter={setFilter}
+      additionalInfo={
+        <div className="flex items-center space-x-2">
+          <div className="flex items-center space-x-2 rounded-lg bg-slate-100 p-2">
+            {getIconBasedOnScale}
+            <div>
+              {t("workspace.surveys.summary.effort_score")}: {elementSummary.average.toFixed(2)} /{" "}
+              {elementSummary.element.range}
+            </div>
+          </div>
+        </div>
+      }
+    />
+  );
+};

apps/web/app/(app)/workspaces/[workspaceId]/surveys/[surveyId]/(analysis)/summary/components/CSATSummary.tsx

@@ -0,0 +1,72 @@
+"use client";
+
+import { CircleSlash2, SmileIcon, StarIcon } from "lucide-react";
+import { useMemo } from "react";
+import { useTranslation } from "react-i18next";
+import { type TI18nString } from "@formbricks/types/i18n";
+import { TSurveyElementTypeEnum } from "@formbricks/types/surveys/elements";
+import { TSurvey, TSurveyElementSummaryCsat } from "@formbricks/types/surveys/types";
+import { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from "@/modules/ui/components/tooltip";
+import { RatingLikeSummary } from "./RatingLikeSummary";
+import { SatisfactionIndicator } from "./SatisfactionIndicator";
+
+interface CSATSummaryProps {
+  elementSummary: TSurveyElementSummaryCsat;
+  survey: TSurvey;
+  setFilter: (
+    elementId: string,
+    label: TI18nString,
+    elementType: TSurveyElementTypeEnum,
+    filterValue: string,
+    filterComboBoxValue?: string | string[]
+  ) => void;
+}
+
+export const CSATSummary = ({ elementSummary, survey, setFilter }: CSATSummaryProps) => {
+  const { t } = useTranslation();
+
+  const getIconBasedOnScale = useMemo(() => {
+    const scale = elementSummary.element.scale;
+    if (scale === "number") return <CircleSlash2 className="h-4 w-4" />;
+    else if (scale === "star") return <StarIcon fill="rgb(250 204 21)" className="h-4 w-4 text-yellow-400" />;
+    else if (scale === "smiley") return <SmileIcon className="h-4 w-4" />;
+  }, [elementSummary.element.scale]);
+
+  return (
+    <RatingLikeSummary
+      elementSummary={elementSummary}
+      survey={survey}
+      setFilter={setFilter}
+      additionalInfo={
+        <div className="flex items-center space-x-2">
+          <div className="flex items-center space-x-2 rounded-lg bg-slate-100 p-2">
+            {getIconBasedOnScale}
+            <div>
+              {t("workspace.surveys.summary.overall")}: {elementSummary.average.toFixed(2)}
+            </div>
+          </div>
+
+          <TooltipProvider delayDuration={150}>
+            <Tooltip>
+              <TooltipTrigger asChild>
+                <div className="flex items-center space-x-2 rounded-lg bg-slate-100 p-2">
+                  <SatisfactionIndicator percentage={elementSummary.csat.satisfiedPercentage} />
+                  <div>
+                    {t("workspace.surveys.summary.csat_satisfied", {
+                      percentage: elementSummary.csat.satisfiedPercentage,
+                    })}
+                  </div>
+                </div>
+              </TooltipTrigger>
+              <TooltipContent side="bottom">
+                {t("workspace.surveys.summary.csat_satisfied_tooltip", {
+                  percentage: elementSummary.csat.satisfiedPercentage,
+                })}
+              </TooltipContent>
+            </Tooltip>
+          </TooltipProvider>
+        </div>
+      }
+    />
+  );
+};

apps/web/app/(app)/workspaces/[workspaceId]/surveys/[surveyId]/(analysis)/summary/components/NPSSummary.tsx

@@ -8,7 +8,7 @@ import { TSurveyElementTypeEnum } from "@formbricks/types/surveys/elements";
 import { TSurvey, TSurveyElementSummaryNps } from "@formbricks/types/surveys/types";
 import { HalfCircle, ProgressBar } from "@/modules/ui/components/progress-bar";
 import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/modules/ui/components/tabs";
-import { TooltipProvider } from "@/modules/ui/components/tooltip";
+import { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from "@/modules/ui/components/tooltip";
 import { convertFloatToNDecimal } from "../lib/utils";
 import { ClickableBarSegment } from "./ClickableBarSegment";
 import { ElementSummaryHeader } from "./ElementSummaryHeader";
@@ -39,6 +39,7 @@ const calculateNPSOpacity = (rating: number): number => {
 export const NPSSummary = ({ elementSummary, survey, setFilter }: NPSSummaryProps) => {
   const { t } = useTranslation();
   const [activeTab, setActiveTab] = useState<"aggregated" | "individual">("aggregated");
+  const promotersPercentage = convertFloatToNDecimal(elementSummary.promoters.percentage, 2);
 
   const applyFilter = (group: string) => {
     const filters = {
@@ -81,13 +82,23 @@ export const NPSSummary = ({ elementSummary, survey, setFilter }: NPSSummaryProp
         elementSummary={elementSummary}
         survey={survey}
         additionalInfo={
-          <div className="flex items-center space-x-2 rounded-lg bg-slate-100 p-2">
-            <SatisfactionIndicator percentage={elementSummary.promoters.percentage} />
-            <div>
-              {t("workspace.surveys.summary.promoters")}:{" "}
-              {convertFloatToNDecimal(elementSummary.promoters.percentage, 2)}%
-            </div>
-          </div>
+          <TooltipProvider delayDuration={150}>
+            <Tooltip>
+              <TooltipTrigger asChild>
+                <div className="flex items-center space-x-2 rounded-lg bg-slate-100 p-2">
+                  <SatisfactionIndicator percentage={elementSummary.promoters.percentage} />
+                  <div>
+                    {t("workspace.surveys.summary.promoters")}: {promotersPercentage}%
+                  </div>
+                </div>
+              </TooltipTrigger>
+              <TooltipContent side="bottom">
+                {t("workspace.surveys.summary.nps_promoters_tooltip", {
+                  percentage: promotersPercentage,
+                })}
+              </TooltipContent>
+            </Tooltip>
+          </TooltipProvider>
         }
       />
 

apps/web/app/(app)/workspaces/[workspaceId]/surveys/[surveyId]/(analysis)/summary/components/RatingLikeSummary.tsx

@@ -0,0 +1,214 @@
+"use client";
+
+import { BarChart, BarChartHorizontal } from "lucide-react";
+import { type JSX, useState } from "react";
+import { useTranslation } from "react-i18next";
+import { type TI18nString } from "@formbricks/types/i18n";
+import { TSurveyElementTypeEnum } from "@formbricks/types/surveys/elements";
+import {
+  TSurvey,
+  TSurveyElementSummaryCes,
+  TSurveyElementSummaryCsat,
+  TSurveyElementSummaryRating,
+} from "@formbricks/types/surveys/types";
+import { convertFloatToNDecimal } from "@/app/(app)/workspaces/[workspaceId]/surveys/[surveyId]/(analysis)/summary/lib/utils";
+import { EmptyState } from "@/modules/ui/components/empty-state";
+import { ProgressBar } from "@/modules/ui/components/progress-bar";
+import { RatingResponse } from "@/modules/ui/components/rating-response";
+import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/modules/ui/components/tabs";
+import { TooltipProvider } from "@/modules/ui/components/tooltip";
+import { ClickableBarSegment } from "./ClickableBarSegment";
+import { ElementSummaryHeader } from "./ElementSummaryHeader";
+import { RatingScaleLegend } from "./RatingScaleLegend";
+
+type RatingLikeElementSummary =
+  | TSurveyElementSummaryCes
+  | TSurveyElementSummaryCsat
+  | TSurveyElementSummaryRating;
+
+interface RatingLikeSummaryProps {
+  elementSummary: RatingLikeElementSummary;
+  survey: TSurvey;
+  setFilter: (
+    elementId: string,
+    label: TI18nString,
+    elementType: TSurveyElementTypeEnum,
+    filterValue: string,
+    filterComboBoxValue?: string | string[]
+  ) => void;
+  additionalInfo: JSX.Element;
+}
+
+export const RatingLikeSummary = ({
+  elementSummary,
+  survey,
+  setFilter,
+  additionalInfo,
+}: RatingLikeSummaryProps) => {
+  const { t } = useTranslation();
+  const [activeTab, setActiveTab] = useState<"aggregated" | "individual">("aggregated");
+
+  return (
+    <div className="rounded-xl border border-slate-200 bg-white shadow-sm">
+      <ElementSummaryHeader elementSummary={elementSummary} survey={survey} additionalInfo={additionalInfo} />
+
+      <Tabs value={activeTab} onValueChange={(value) => setActiveTab(value as "aggregated" | "individual")}>
+        <div className="flex justify-end px-4 md:px-6">
+          <TabsList>
+            <TabsTrigger value="aggregated" icon={<BarChartHorizontal className="h-4 w-4" />}>
+              {t("workspace.surveys.summary.aggregated")}
+            </TabsTrigger>
+            <TabsTrigger value="individual" icon={<BarChart className="h-4 w-4" />}>
+              {t("workspace.surveys.summary.individual")}
+            </TabsTrigger>
+          </TabsList>
+        </div>
+
+        <TabsContent value="aggregated" className="mt-4">
+          <div className="px-4 pb-6 pt-4 md:px-6">
+            {elementSummary.responseCount === 0 ? (
+              <>
+                <EmptyState text={t("workspace.surveys.summary.no_responses_found")} variant="simple" />
+                <RatingScaleLegend
+                  scale={elementSummary.element.scale}
+                  range={elementSummary.element.range}
+                />
+              </>
+            ) : (
+              <>
+                <TooltipProvider delayDuration={200}>
+                  <div className="flex h-12 w-full overflow-hidden rounded-t-lg border border-slate-200">
+                    {elementSummary.choices.map((result, index) => {
+                      if (result.percentage === 0) return null;
+
+                      const range = elementSummary.element.range;
+                      const opacity = 0.3 + (result.rating / range) * 0.7;
+                      const isFirst = index === 0;
+                      const isLast = index === elementSummary.choices.length - 1;
+
+                      return (
+                        <ClickableBarSegment
+                          key={result.rating}
+                          className="relative h-full cursor-pointer transition-opacity hover:brightness-110"
+                          style={{
+                            width: `${result.percentage}%`,
+                            borderRight: isLast ? "none" : "1px solid rgb(226, 232, 240)",
+                          }}
+                          onClick={() =>
+                            setFilter(
+                              elementSummary.element.id,
+                              elementSummary.element.headline,
+                              elementSummary.element.type,
+                              t("workspace.surveys.summary.is_equal_to"),
+                              result.rating.toString()
+                            )
+                          }>
+                          <div
+                            className={`h-full bg-brand-dark ${isFirst ? "rounded-tl-lg" : ""} ${isLast ? "rounded-tr-lg" : ""}`}
+                            style={{ opacity }}
+                          />
+                        </ClickableBarSegment>
+                      );
+                    })}
+                  </div>
+                </TooltipProvider>
+                <div className="flex w-full overflow-hidden rounded-b-lg border border-t-0 border-slate-200 bg-slate-50">
+                  {elementSummary.choices.map((result, index) => {
+                    if (result.percentage === 0) return null;
+
+                    return (
+                      <div
+                        key={result.rating}
+                        className="flex flex-col items-center justify-center py-2"
+                        style={{
+                          width: `${result.percentage}%`,
+                          borderRight:
+                            index < elementSummary.choices.length - 1
+                              ? "1px solid rgb(226, 232, 240)"
+                              : "none",
+                        }}>
+                        <div className="mb-1 flex items-center justify-center">
+                          <RatingResponse
+                            scale={elementSummary.element.scale}
+                            answer={result.rating}
+                            range={elementSummary.element.range}
+                            addColors={false}
+                            variant="aggregated"
+                          />
+                        </div>
+                        <div className="text-xs font-medium text-slate-600">
+                          {convertFloatToNDecimal(result.percentage, 1)}%
+                        </div>
+                      </div>
+                    );
+                  })}
+                </div>
+                <RatingScaleLegend
+                  scale={elementSummary.element.scale}
+                  range={elementSummary.element.range}
+                />
+              </>
+            )}
+          </div>
+        </TabsContent>
+
+        <TabsContent value="individual" className="mt-4">
+          <div className="px-4 pb-6 pt-4 md:px-6">
+            <div className="space-y-5 text-sm md:text-base">
+              {elementSummary.choices.map((result) => (
+                <div key={result.rating}>
+                  <button
+                    className="w-full cursor-pointer hover:opacity-80"
+                    onClick={() =>
+                      setFilter(
+                        elementSummary.element.id,
+                        elementSummary.element.headline,
+                        elementSummary.element.type,
+                        t("workspace.surveys.summary.is_equal_to"),
+                        result.rating.toString()
+                      )
+                    }>
+                    <div className="text flex justify-between px-2 pb-2">
+                      <div className="mr-8 flex items-center space-x-1">
+                        <div className="font-semibold text-slate-700">
+                          <RatingResponse
+                            scale={elementSummary.element.scale}
+                            answer={result.rating}
+                            range={elementSummary.element.range}
+                            addColors={elementSummary.element.isColorCodingEnabled}
+                            variant="individual"
+                          />
+                        </div>
+                        <div>
+                          <p className="rounded-lg bg-slate-100 px-2 text-slate-700">
+                            {convertFloatToNDecimal(result.percentage, 2)}%
+                          </p>
+                        </div>
+                      </div>
+                      <p className="flex w-32 items-end justify-end text-slate-600">
+                        {t("common.count_responses", { count: result.count })}
+                      </p>
+                    </div>
+                    <ProgressBar barColor="bg-brand-dark" progress={result.percentage / 100} />
+                  </button>
+                </div>
+              ))}
+            </div>
+          </div>
+        </TabsContent>
+      </Tabs>
+      {elementSummary.dismissed && elementSummary.dismissed.count > 0 && (
+        <div className="rounded-b-lg border-t bg-white px-6 py-4">
+          <div key="dismissed">
+            <div className="text flex justify-between px-2">
+              <p className="font-semibold text-slate-700">{t("common.dismissed")}</p>
+              <p className="flex w-32 items-end justify-end text-slate-600">
+                {t("common.count_responses", { count: elementSummary.dismissed.count })}
+              </p>
+            </div>
+          </div>
+        </div>
+      )}
+    </div>
+  );
+};

apps/web/app/(app)/workspaces/[workspaceId]/surveys/[surveyId]/(analysis)/summary/components/RatingSummary.tsx

@@ -1,21 +1,12 @@
 "use client";
 
-import { BarChart, BarChartHorizontal, CircleSlash2, SmileIcon, StarIcon } from "lucide-react";
-import { useMemo, useState } from "react";
+import { CircleSlash2, SmileIcon, StarIcon } from "lucide-react";
+import { useMemo } from "react";
 import { useTranslation } from "react-i18next";
 import { type TI18nString } from "@formbricks/types/i18n";
 import { TSurveyElementTypeEnum } from "@formbricks/types/surveys/elements";
 import { TSurvey, TSurveyElementSummaryRating } from "@formbricks/types/surveys/types";
-import { convertFloatToNDecimal } from "@/app/(app)/workspaces/[workspaceId]/surveys/[surveyId]/(analysis)/summary/lib/utils";
-import { EmptyState } from "@/modules/ui/components/empty-state";
-import { ProgressBar } from "@/modules/ui/components/progress-bar";
-import { RatingResponse } from "@/modules/ui/components/rating-response";
-import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/modules/ui/components/tabs";
-import { TooltipProvider } from "@/modules/ui/components/tooltip";
-import { ClickableBarSegment } from "./ClickableBarSegment";
-import { ElementSummaryHeader } from "./ElementSummaryHeader";
-import { RatingScaleLegend } from "./RatingScaleLegend";
-import { SatisfactionIndicator } from "./SatisfactionIndicator";
+import { RatingLikeSummary } from "./RatingLikeSummary";
 
 interface RatingSummaryProps {
   elementSummary: TSurveyElementSummaryRating;
@@ -31,196 +22,29 @@ interface RatingSummaryProps {
 
 export const RatingSummary = ({ elementSummary, survey, setFilter }: RatingSummaryProps) => {
   const { t } = useTranslation();
-  const [activeTab, setActiveTab] = useState<"aggregated" | "individual">("aggregated");
 
   const getIconBasedOnScale = useMemo(() => {
     const scale = elementSummary.element.scale;
     if (scale === "number") return <CircleSlash2 className="h-4 w-4" />;
     else if (scale === "star") return <StarIcon fill="rgb(250 204 21)" className="h-4 w-4 text-yellow-400" />;
     else if (scale === "smiley") return <SmileIcon className="h-4 w-4" />;
-  }, [elementSummary]);
+  }, [elementSummary.element.scale]);
 
   return (
-    <div className="rounded-xl border border-slate-200 bg-white shadow-sm">
-      <ElementSummaryHeader
-        elementSummary={elementSummary}
-        survey={survey}
-        additionalInfo={
-          <div className="flex items-center space-x-2">
-            <div className="flex items-center space-x-2 rounded-lg bg-slate-100 p-2">
-              {getIconBasedOnScale}
-              <div>
-                {t("workspace.surveys.summary.overall")}: {elementSummary.average.toFixed(2)}
-              </div>
-            </div>
-
-            <div className="flex items-center space-x-2 rounded-lg bg-slate-100 p-2">
-              <SatisfactionIndicator percentage={elementSummary.csat.satisfiedPercentage} />
-              <div>
-                CSAT: {elementSummary.csat.satisfiedPercentage}% {t("workspace.surveys.summary.satisfied")}
-              </div>
-            </div>
-          </div>
-        }
-      />
-
-      <Tabs value={activeTab} onValueChange={(value) => setActiveTab(value as "aggregated" | "individual")}>
-        <div className="flex justify-end px-4 md:px-6">
-          <TabsList>
-            <TabsTrigger value="aggregated" icon={<BarChartHorizontal className="h-4 w-4" />}>
-              {t("workspace.surveys.summary.aggregated")}
-            </TabsTrigger>
-            <TabsTrigger value="individual" icon={<BarChart className="h-4 w-4" />}>
-              {t("workspace.surveys.summary.individual")}
-            </TabsTrigger>
-          </TabsList>
-        </div>
-
-        <TabsContent value="aggregated" className="mt-4">
-          <div className="px-4 pb-6 pt-4 md:px-6">
-            {elementSummary.responseCount === 0 ? (
-              <>
-                <EmptyState text={t("workspace.surveys.summary.no_responses_found")} variant="simple" />
-                <RatingScaleLegend
-                  scale={elementSummary.element.scale}
-                  range={elementSummary.element.range}
-                />
-              </>
-            ) : (
-              <>
-                <TooltipProvider delayDuration={200}>
-                  <div className="flex h-12 w-full overflow-hidden rounded-t-lg border border-slate-200">
-                    {elementSummary.choices.map((result, index) => {
-                      if (result.percentage === 0) return null;
-
-                      const range = elementSummary.element.range;
-                      const opacity = 0.3 + (result.rating / range) * 0.8;
-                      const isFirst = index === 0;
-                      const isLast = index === elementSummary.choices.length - 1;
-
-                      return (
-                        <ClickableBarSegment
-                          key={result.rating}
-                          className="relative h-full cursor-pointer transition-opacity hover:brightness-110"
-                          style={{
-                            width: `${result.percentage}%`,
-                            borderRight: isLast ? "none" : "1px solid rgb(226, 232, 240)",
-                          }}
-                          onClick={() =>
-                            setFilter(
-                              elementSummary.element.id,
-                              elementSummary.element.headline,
-                              elementSummary.element.type,
-                              t("workspace.surveys.summary.is_equal_to"),
-                              result.rating.toString()
-                            )
-                          }>
-                          <div
-                            className={`h-full bg-brand-dark ${isFirst ? "rounded-tl-lg" : ""} ${isLast ? "rounded-tr-lg" : ""}`}
-                            style={{ opacity }}
-                          />
-                        </ClickableBarSegment>
-                      );
-                    })}
-                  </div>
-                </TooltipProvider>
-                <div className="flex w-full overflow-hidden rounded-b-lg border border-t-0 border-slate-200 bg-slate-50">
-                  {elementSummary.choices.map((result, index) => {
-                    if (result.percentage === 0) return null;
-
-                    return (
-                      <div
-                        key={result.rating}
-                        className="flex flex-col items-center justify-center py-2"
-                        style={{
-                          width: `${result.percentage}%`,
-                          borderRight:
-                            index < elementSummary.choices.length - 1
-                              ? "1px solid rgb(226, 232, 240)"
-                              : "none",
-                        }}>
-                        <div className="mb-1 flex items-center justify-center">
-                          <RatingResponse
-                            scale={elementSummary.element.scale}
-                            answer={result.rating}
-                            range={elementSummary.element.range}
-                            addColors={false}
-                            variant="aggregated"
-                          />
-                        </div>
-                        <div className="text-xs font-medium text-slate-600">
-                          {convertFloatToNDecimal(result.percentage, 1)}%
-                        </div>
-                      </div>
-                    );
-                  })}
-                </div>
-                <RatingScaleLegend
-                  scale={elementSummary.element.scale}
-                  range={elementSummary.element.range}
-                />
-              </>
-            )}
-          </div>
-        </TabsContent>
-
-        <TabsContent value="individual" className="mt-4">
-          <div className="px-4 pb-6 pt-4 md:px-6">
-            <div className="space-y-5 text-sm md:text-base">
-              {elementSummary.choices.map((result) => (
-                <div key={result.rating}>
-                  <button
-                    className="w-full cursor-pointer hover:opacity-80"
-                    onClick={() =>
-                      setFilter(
-                        elementSummary.element.id,
-                        elementSummary.element.headline,
-                        elementSummary.element.type,
-                        t("workspace.surveys.summary.is_equal_to"),
-                        result.rating.toString()
-                      )
-                    }>
-                    <div className="text flex justify-between px-2 pb-2">
-                      <div className="mr-8 flex items-center space-x-1">
-                        <div className="font-semibold text-slate-700">
-                          <RatingResponse
-                            scale={elementSummary.element.scale}
-                            answer={result.rating}
-                            range={elementSummary.element.range}
-                            addColors={elementSummary.element.isColorCodingEnabled}
-                            variant="individual"
-                          />
-                        </div>
-                        <div>
-                          <p className="rounded-lg bg-slate-100 px-2 text-slate-700">
-                            {convertFloatToNDecimal(result.percentage, 2)}%
-                          </p>
-                        </div>
-                      </div>
-                      <p className="flex w-32 items-end justify-end text-slate-600">
-                        {t("common.count_responses", { count: result.count })}
-                      </p>
-                    </div>
-                    <ProgressBar barColor="bg-brand-dark" progress={result.percentage / 100} />
-                  </button>
-                </div>
-              ))}
-            </div>
-          </div>
-        </TabsContent>
-      </Tabs>
-      {elementSummary.dismissed && elementSummary.dismissed.count > 0 && (
-        <div className="rounded-b-lg border-t bg-white px-6 py-4">
-          <div key="dismissed">
-            <div className="text flex justify-between px-2">
-              <p className="font-semibold text-slate-700">{t("common.dismissed")}</p>
-              <p className="flex w-32 items-end justify-end text-slate-600">
-                {t("common.count_responses", { count: elementSummary.dismissed.count })}
-              </p>
+    <RatingLikeSummary
+      elementSummary={elementSummary}
+      survey={survey}
+      setFilter={setFilter}
+      additionalInfo={
+        <div className="flex items-center space-x-2">
+          <div className="flex items-center space-x-2 rounded-lg bg-slate-100 p-2">
+            {getIconBasedOnScale}
+            <div>
+              {t("workspace.surveys.summary.overall")}: {elementSummary.average.toFixed(2)}
             </div>
           </div>
         </div>
-      )}
-    </div>
+      }
+    />
   );
 };

apps/web/app/(app)/workspaces/[workspaceId]/surveys/[surveyId]/(analysis)/summary/components/SuccessMessage.tsx

@@ -22,8 +22,23 @@ export const SuccessMessage = ({ survey }: SummaryMetadataProps) => {
   const appSetupCompleted = workspace.appSetupCompleted;
 
   useEffect(() => {
-    const newSurveyParam = searchParams?.get("success");
-    if (newSurveyParam && survey && workspace) {
+    const publishSuccessParam = searchParams.get("success");
+    const scheduledSuccessParam = searchParams.get("scheduled");
+
+    if (scheduledSuccessParam) {
+      toast.success(t("workspace.surveys.summary.survey_scheduled_successfully"), {
+        id: "survey-schedule-success-toast",
+        duration: 5000,
+        position: "bottom-right",
+      });
+
+      const url = new URL(globalThis.location.href);
+      url.searchParams.delete("scheduled");
+      globalThis.history.replaceState({}, "", url.toString());
+      return;
+    }
+
+    if (publishSuccessParam) {
       setConfetti(true);
       toast.success(
         isAppSurvey && !appSetupCompleted
@@ -38,16 +53,16 @@ export const SuccessMessage = ({ survey }: SummaryMetadataProps) => {
       );
 
       // Remove success param from url
-      const url = new URL(window.location.href);
+      const url = new URL(globalThis.location.href);
       url.searchParams.delete("success");
       if (survey.type === "link") {
         // Add share param to url to open share embed modal
         url.searchParams.set("share", "true");
       }
 
-      window.history.replaceState({}, "", url.toString());
+      globalThis.history.replaceState({}, "", url.toString());
     }
-  }, [workspace, isAppSurvey, searchParams, survey, appSetupCompleted, t]);
+  }, [appSetupCompleted, isAppSurvey, searchParams, survey.type, t]);
 
   return <>{confetti && <Confetti />}</>;
 };

apps/web/app/(app)/workspaces/[workspaceId]/surveys/[surveyId]/(analysis)/summary/components/SummaryList.tsx

@@ -13,6 +13,8 @@ import {
   SelectedFilterValue,
   useResponseFilter,
 } from "@/app/(app)/workspaces/[workspaceId]/surveys/[surveyId]/(analysis)/components/response-filter-context";
+import { CESSummary } from "@/app/(app)/workspaces/[workspaceId]/surveys/[surveyId]/(analysis)/summary/components/CESSummary";
+import { CSATSummary } from "@/app/(app)/workspaces/[workspaceId]/surveys/[surveyId]/(analysis)/summary/components/CSATSummary";
 import { CTASummary } from "@/app/(app)/workspaces/[workspaceId]/surveys/[surveyId]/(analysis)/summary/components/CTASummary";
 import { CalSummary } from "@/app/(app)/workspaces/[workspaceId]/surveys/[surveyId]/(analysis)/summary/components/CalSummary";
 import { ConsentSummary } from "@/app/(app)/workspaces/[workspaceId]/surveys/[surveyId]/(analysis)/summary/components/ConsentSummary";
@@ -156,6 +158,26 @@ export const SummaryList = ({ summary, responseCount, survey, locale }: SummaryL
               />
             );
           }
+          if (elementSummary.type === TSurveyElementTypeEnum.CSAT) {
+            return (
+              <CSATSummary
+                key={elementSummary.element.id}
+                elementSummary={elementSummary}
+                survey={survey}
+                setFilter={setFilter}
+              />
+            );
+          }
+          if (elementSummary.type === TSurveyElementTypeEnum.CES) {
+            return (
+              <CESSummary
+                key={elementSummary.element.id}
+                elementSummary={elementSummary}
+                survey={survey}
+                setFilter={setFilter}
+              />
+            );
+          }
           if (elementSummary.type === TSurveyElementTypeEnum.Consent) {
             return (
               <ConsentSummary

apps/web/app/(app)/workspaces/[workspaceId]/surveys/[surveyId]/(analysis)/summary/lib/surveySummary.test.ts

@@ -4578,3 +4578,611 @@ describe("Cal question type tests", () => {
     expect(summary[0].skipped.count).toBe(1); // Counted as skipped
   });
 });
+
+describe("CSAT question type tests", () => {
+  test("getElementSummary correctly processes CSAT question with valid responses", async () => {
+    const question = {
+      id: "csat-q1",
+      type: TSurveyElementTypeEnum.CSAT,
+      headline: { default: "How satisfied are you?" },
+      required: true,
+      scale: "smiley",
+      range: 5,
+      lowerLabel: { default: "Very unsatisfied" },
+      upperLabel: { default: "Very satisfied" },
+    };
+
+    const survey = {
+      id: "survey-1",
+      blocks: [{ id: "block1", name: "Block 1", elements: [question] }],
+      questions: [],
+      languages: [],
+      welcomeCard: { enabled: false },
+    } as unknown as TSurvey;
+
+    const responses = [
+      {
+        id: "response-1",
+        data: { "csat-q1": 5 },
+        updatedAt: new Date(),
+        contact: null,
+        contactAttributes: {},
+        language: null,
+        ttc: {},
+        finished: true,
+      },
+      {
+        id: "response-2",
+        data: { "csat-q1": 4 },
+        updatedAt: new Date(),
+        contact: null,
+        contactAttributes: {},
+        language: null,
+        ttc: {},
+        finished: true,
+      },
+      {
+        id: "response-3",
+        data: { "csat-q1": 2 },
+        updatedAt: new Date(),
+        contact: null,
+        contactAttributes: {},
+        language: null,
+        ttc: {},
+        finished: true,
+      },
+      {
+        id: "response-4",
+        data: { "csat-q1": 1 },
+        updatedAt: new Date(),
+        contact: null,
+        contactAttributes: {},
+        language: null,
+        ttc: {},
+        finished: true,
+      },
+    ];
+
+    const dropOff = [
+      { elementId: "csat-q1", impressions: 4, dropOffCount: 0, dropOffPercentage: 0 },
+    ] as unknown as TSurveySummary["dropOff"];
+
+    const summary: any = await getElementSummary(
+      survey,
+      getElementsFromBlocks(survey.blocks),
+      responses,
+      dropOff
+    );
+
+    expect(summary).toHaveLength(1);
+    expect(summary[0].type).toBe(TSurveyElementTypeEnum.CSAT);
+    expect(summary[0].responseCount).toBe(4);
+
+    // Average = (5 + 4 + 2 + 1) / 4 = 3.0
+    expect(summary[0].average).toBe(3);
+
+    // CSAT: satisfied = ratings 4 + 5 = 2 out of 4
+    expect(summary[0].csat.satisfiedCount).toBe(2);
+    expect(summary[0].csat.satisfiedPercentage).toBe(50);
+
+    // Verify choice distribution
+    const rating5 = summary[0].choices.find((c: any) => c.rating === 5);
+    expect(rating5.count).toBe(1);
+    expect(rating5.percentage).toBe(25);
+
+    const rating4 = summary[0].choices.find((c: any) => c.rating === 4);
+    expect(rating4.count).toBe(1);
+    expect(rating4.percentage).toBe(25);
+
+    const rating2 = summary[0].choices.find((c: any) => c.rating === 2);
+    expect(rating2.count).toBe(1);
+    expect(rating2.percentage).toBe(25);
+
+    const rating1 = summary[0].choices.find((c: any) => c.rating === 1);
+    expect(rating1.count).toBe(1);
+    expect(rating1.percentage).toBe(25);
+
+    expect(summary[0].dismissed.count).toBe(0);
+  });
+
+  test("getElementSummary handles CSAT question with dismissed responses", async () => {
+    const question = {
+      id: "csat-q1",
+      type: TSurveyElementTypeEnum.CSAT,
+      headline: { default: "How satisfied are you?" },
+      required: false,
+      scale: "smiley",
+      range: 5,
+      lowerLabel: { default: "Very unsatisfied" },
+      upperLabel: { default: "Very satisfied" },
+    };
+
+    const survey = {
+      id: "survey-1",
+      blocks: [{ id: "block1", name: "Block 1", elements: [question] }],
+      questions: [],
+      languages: [],
+      welcomeCard: { enabled: false },
+    } as unknown as TSurvey;
+
+    const responses = [
+      {
+        id: "response-1",
+        data: { "csat-q1": 5 },
+        updatedAt: new Date(),
+        contact: null,
+        contactAttributes: {},
+        language: null,
+        ttc: { "csat-q1": 3 },
+        finished: true,
+      },
+      {
+        id: "response-2",
+        data: {},
+        updatedAt: new Date(),
+        contact: null,
+        contactAttributes: {},
+        language: null,
+        ttc: { "csat-q1": 2 },
+        finished: true,
+      },
+      {
+        id: "response-3",
+        data: {},
+        updatedAt: new Date(),
+        contact: null,
+        contactAttributes: {},
+        language: null,
+        ttc: { "csat-q1": 4 },
+        finished: true,
+      },
+    ] as any;
+
+    const dropOff = [
+      { elementId: "csat-q1", impressions: 3, dropOffCount: 0, dropOffPercentage: 0 },
+    ] as unknown as TSurveySummary["dropOff"];
+
+    const summary: any = await getElementSummary(
+      survey,
+      getElementsFromBlocks(survey.blocks),
+      responses,
+      dropOff
+    );
+
+    expect(summary).toHaveLength(1);
+    expect(summary[0].type).toBe(TSurveyElementTypeEnum.CSAT);
+    expect(summary[0].responseCount).toBe(1);
+    expect(summary[0].average).toBe(5);
+    expect(summary[0].dismissed.count).toBe(2);
+    expect(summary[0].csat.satisfiedCount).toBe(1);
+    expect(summary[0].csat.satisfiedPercentage).toBe(100);
+  });
+
+  test("getElementSummary handles CSAT question with no valid responses", async () => {
+    const question = {
+      id: "csat-q1",
+      type: TSurveyElementTypeEnum.CSAT,
+      headline: { default: "How satisfied are you?" },
+      required: true,
+      scale: "smiley",
+      range: 5,
+    };
+
+    const survey = {
+      id: "survey-1",
+      blocks: [{ id: "block1", name: "Block 1", elements: [question] }],
+      questions: [],
+      languages: [],
+      welcomeCard: { enabled: false },
+    } as unknown as TSurvey;
+
+    const responses = [
+      {
+        id: "response-1",
+        data: { "other-q": "value" },
+        updatedAt: new Date(),
+        contact: null,
+        contactAttributes: {},
+        language: null,
+        ttc: {},
+        finished: true,
+      },
+    ];
+
+    const dropOff = [
+      { elementId: "csat-q1", impressions: 1, dropOffCount: 1, dropOffPercentage: 100 },
+    ] as unknown as TSurveySummary["dropOff"];
+
+    const summary: any = await getElementSummary(
+      survey,
+      getElementsFromBlocks(survey.blocks),
+      responses,
+      dropOff
+    );
+
+    expect(summary).toHaveLength(1);
+    expect(summary[0].type).toBe(TSurveyElementTypeEnum.CSAT);
+    expect(summary[0].responseCount).toBe(0);
+    expect(summary[0].average).toBe(0);
+    expect(summary[0].csat.satisfiedCount).toBe(0);
+    expect(summary[0].csat.satisfiedPercentage).toBe(0);
+    expect(summary[0].choices.every((c: any) => c.count === 0)).toBe(true);
+  });
+
+  test("getElementSummary CSAT correctly identifies satisfied ratings (4 and 5 only)", async () => {
+    const question = {
+      id: "csat-q1",
+      type: TSurveyElementTypeEnum.CSAT,
+      headline: { default: "How satisfied are you?" },
+      required: true,
+      scale: "smiley",
+      range: 5,
+    };
+
+    const survey = {
+      id: "survey-1",
+      blocks: [{ id: "block1", name: "Block 1", elements: [question] }],
+      questions: [],
+      languages: [],
+      welcomeCard: { enabled: false },
+    } as unknown as TSurvey;
+
+    // 3 satisfied (4,5,5), 2 not satisfied (1,3)
+    const responses = [
+      {
+        id: "r1",
+        data: { "csat-q1": 5 },
+        updatedAt: new Date(),
+        contact: null,
+        contactAttributes: {},
+        language: null,
+        ttc: {},
+        finished: true,
+      },
+      {
+        id: "r2",
+        data: { "csat-q1": 4 },
+        updatedAt: new Date(),
+        contact: null,
+        contactAttributes: {},
+        language: null,
+        ttc: {},
+        finished: true,
+      },
+      {
+        id: "r3",
+        data: { "csat-q1": 3 },
+        updatedAt: new Date(),
+        contact: null,
+        contactAttributes: {},
+        language: null,
+        ttc: {},
+        finished: true,
+      },
+      {
+        id: "r4",
+        data: { "csat-q1": 1 },
+        updatedAt: new Date(),
+        contact: null,
+        contactAttributes: {},
+        language: null,
+        ttc: {},
+        finished: true,
+      },
+      {
+        id: "r5",
+        data: { "csat-q1": 5 },
+        updatedAt: new Date(),
+        contact: null,
+        contactAttributes: {},
+        language: null,
+        ttc: {},
+        finished: true,
+      },
+    ];
+
+    const dropOff = [
+      { elementId: "csat-q1", impressions: 5, dropOffCount: 0, dropOffPercentage: 0 },
+    ] as unknown as TSurveySummary["dropOff"];
+
+    const summary: any = await getElementSummary(
+      survey,
+      getElementsFromBlocks(survey.blocks),
+      responses,
+      dropOff
+    );
+
+    // satisfied = ratings 4 and 5 = 3 out of 5
+    expect(summary[0].csat.satisfiedCount).toBe(3);
+    expect(summary[0].csat.satisfiedPercentage).toBe(60);
+  });
+});
+
+describe("CES question type tests", () => {
+  test("getElementSummary correctly processes CES question with valid responses (range 5)", async () => {
+    const question = {
+      id: "ces-q1",
+      type: TSurveyElementTypeEnum.CES,
+      headline: { default: "How easy was it?" },
+      required: true,
+      scale: "number",
+      range: 5,
+      lowerLabel: { default: "Very difficult" },
+      upperLabel: { default: "Very easy" },
+    };
+
+    const survey = {
+      id: "survey-1",
+      blocks: [{ id: "block1", name: "Block 1", elements: [question] }],
+      questions: [],
+      languages: [],
+      welcomeCard: { enabled: false },
+    } as unknown as TSurvey;
+
+    const responses = [
+      {
+        id: "response-1",
+        data: { "ces-q1": 5 },
+        updatedAt: new Date(),
+        contact: null,
+        contactAttributes: {},
+        language: null,
+        ttc: {},
+        finished: true,
+      },
+      {
+        id: "response-2",
+        data: { "ces-q1": 4 },
+        updatedAt: new Date(),
+        contact: null,
+        contactAttributes: {},
+        language: null,
+        ttc: {},
+        finished: true,
+      },
+      {
+        id: "response-3",
+        data: { "ces-q1": 2 },
+        updatedAt: new Date(),
+        contact: null,
+        contactAttributes: {},
+        language: null,
+        ttc: {},
+        finished: true,
+      },
+      {
+        id: "response-4",
+        data: { "ces-q1": 3 },
+        updatedAt: new Date(),
+        contact: null,
+        contactAttributes: {},
+        language: null,
+        ttc: {},
+        finished: true,
+      },
+    ];
+
+    const dropOff = [
+      { elementId: "ces-q1", impressions: 4, dropOffCount: 0, dropOffPercentage: 0 },
+    ] as unknown as TSurveySummary["dropOff"];
+
+    const summary: any = await getElementSummary(
+      survey,
+      getElementsFromBlocks(survey.blocks),
+      responses,
+      dropOff
+    );
+
+    expect(summary).toHaveLength(1);
+    expect(summary[0].type).toBe(TSurveyElementTypeEnum.CES);
+    expect(summary[0].responseCount).toBe(4);
+
+    // CES = average = (5 + 4 + 2 + 3) / 4 = 3.5
+    expect(summary[0].average).toBe(3.5);
+
+    // Verify choice distribution
+    const rating5 = summary[0].choices.find((c: any) => c.rating === 5);
+    expect(rating5.count).toBe(1);
+    expect(rating5.percentage).toBe(25);
+
+    const rating4 = summary[0].choices.find((c: any) => c.rating === 4);
+    expect(rating4.count).toBe(1);
+    expect(rating4.percentage).toBe(25);
+
+    const rating3 = summary[0].choices.find((c: any) => c.rating === 3);
+    expect(rating3.count).toBe(1);
+    expect(rating3.percentage).toBe(25);
+
+    const rating2 = summary[0].choices.find((c: any) => c.rating === 2);
+    expect(rating2.count).toBe(1);
+    expect(rating2.percentage).toBe(25);
+
+    expect(summary[0].dismissed.count).toBe(0);
+
+    // CES has no csat field
+    expect(summary[0].csat).toBeUndefined();
+  });
+
+  test("getElementSummary correctly processes CES question with range 7", async () => {
+    const question = {
+      id: "ces-q1",
+      type: TSurveyElementTypeEnum.CES,
+      headline: { default: "How easy was it?" },
+      required: true,
+      scale: "number",
+      range: 7,
+      lowerLabel: { default: "Very difficult" },
+      upperLabel: { default: "Very easy" },
+    };
+
+    const survey = {
+      id: "survey-1",
+      blocks: [{ id: "block1", name: "Block 1", elements: [question] }],
+      questions: [],
+      languages: [],
+      welcomeCard: { enabled: false },
+    } as unknown as TSurvey;
+
+    const responses = [
+      {
+        id: "r1",
+        data: { "ces-q1": 7 },
+        updatedAt: new Date(),
+        contact: null,
+        contactAttributes: {},
+        language: null,
+        ttc: {},
+        finished: true,
+      },
+      {
+        id: "r2",
+        data: { "ces-q1": 6 },
+        updatedAt: new Date(),
+        contact: null,
+        contactAttributes: {},
+        language: null,
+        ttc: {},
+        finished: true,
+      },
+      {
+        id: "r3",
+        data: { "ces-q1": 1 },
+        updatedAt: new Date(),
+        contact: null,
+        contactAttributes: {},
+        language: null,
+        ttc: {},
+        finished: true,
+      },
+    ];
+
+    const dropOff = [
+      { elementId: "ces-q1", impressions: 3, dropOffCount: 0, dropOffPercentage: 0 },
+    ] as unknown as TSurveySummary["dropOff"];
+
+    const summary: any = await getElementSummary(
+      survey,
+      getElementsFromBlocks(survey.blocks),
+      responses,
+      dropOff
+    );
+
+    expect(summary).toHaveLength(1);
+    expect(summary[0].type).toBe(TSurveyElementTypeEnum.CES);
+    expect(summary[0].responseCount).toBe(3);
+
+    // CES average = (7 + 6 + 1) / 3 = 4.67
+    expect(summary[0].average).toBe(4.67);
+
+    // Verify 7 choices exist (range 7)
+    expect(summary[0].choices).toHaveLength(7);
+  });
+
+  test("getElementSummary handles CES question with dismissed responses", async () => {
+    const question = {
+      id: "ces-q1",
+      type: TSurveyElementTypeEnum.CES,
+      headline: { default: "How easy was it?" },
+      required: false,
+      scale: "number",
+      range: 5,
+    };
+
+    const survey = {
+      id: "survey-1",
+      blocks: [{ id: "block1", name: "Block 1", elements: [question] }],
+      questions: [],
+      languages: [],
+      welcomeCard: { enabled: false },
+    } as unknown as TSurvey;
+
+    const responses = [
+      {
+        id: "response-1",
+        data: { "ces-q1": 3 },
+        updatedAt: new Date(),
+        contact: null,
+        contactAttributes: {},
+        language: null,
+        ttc: { "ces-q1": 5 },
+        finished: true,
+      },
+      {
+        id: "response-2",
+        data: {},
+        updatedAt: new Date(),
+        contact: null,
+        contactAttributes: {},
+        language: null,
+        ttc: { "ces-q1": 2 },
+        finished: true,
+      },
+    ] as any;
+
+    const dropOff = [
+      { elementId: "ces-q1", impressions: 2, dropOffCount: 0, dropOffPercentage: 0 },
+    ] as unknown as TSurveySummary["dropOff"];
+
+    const summary: any = await getElementSummary(
+      survey,
+      getElementsFromBlocks(survey.blocks),
+      responses,
+      dropOff
+    );
+
+    expect(summary).toHaveLength(1);
+    expect(summary[0].type).toBe(TSurveyElementTypeEnum.CES);
+    expect(summary[0].responseCount).toBe(1);
+    expect(summary[0].average).toBe(3);
+    expect(summary[0].dismissed.count).toBe(1);
+  });
+
+  test("getElementSummary handles CES question with no valid responses", async () => {
+    const question = {
+      id: "ces-q1",
+      type: TSurveyElementTypeEnum.CES,
+      headline: { default: "How easy was it?" },
+      required: true,
+      scale: "number",
+      range: 5,
+    };
+
+    const survey = {
+      id: "survey-1",
+      blocks: [{ id: "block1", name: "Block 1", elements: [question] }],
+      questions: [],
+      languages: [],
+      welcomeCard: { enabled: false },
+    } as unknown as TSurvey;
+
+    const responses = [
+      {
+        id: "response-1",
+        data: { "other-q": "value" },
+        updatedAt: new Date(),
+        contact: null,
+        contactAttributes: {},
+        language: null,
+        ttc: {},
+        finished: true,
+      },
+    ];
+
+    const dropOff = [
+      { elementId: "ces-q1", impressions: 1, dropOffCount: 1, dropOffPercentage: 100 },
+    ] as unknown as TSurveySummary["dropOff"];
+
+    const summary: any = await getElementSummary(
+      survey,
+      getElementsFromBlocks(survey.blocks),
+      responses,
+      dropOff
+    );
+
+    expect(summary).toHaveLength(1);
+    expect(summary[0].type).toBe(TSurveyElementTypeEnum.CES);
+    expect(summary[0].responseCount).toBe(0);
+    expect(summary[0].average).toBe(0);
+    expect(summary[0].choices.every((c: any) => c.count === 0)).toBe(true);
+  });
+});

apps/web/app/(app)/workspaces/[workspaceId]/surveys/[surveyId]/(analysis)/summary/lib/surveySummary.ts

@@ -25,7 +25,6 @@ import {
   TSurveyElementSummaryOpenText,
   TSurveyElementSummaryPictureSelection,
   TSurveyElementSummaryRanking,
-  TSurveyElementSummaryRating,
   TSurveyLanguage,
   TSurveySummary,
 } from "@formbricks/types/surveys/types";
@@ -272,6 +271,49 @@ const checkForI18n = (
   return responseData[id];
 };
 
+const computeNumericScaleStats = (
+  elementId: string,
+  range: number,
+  responses: TSurveySummaryResponse[]
+): {
+  choices: { rating: number; count: number; percentage: number }[];
+  choiceCountMap: Record<number, number>;
+  totalResponseCount: number;
+  totalRating: number;
+  dismissed: number;
+  average: number;
+} => {
+  const choiceCountMap: Record<number, number> = {};
+  for (let i = 1; i <= range; i++) {
+    choiceCountMap[i] = 0;
+  }
+
+  let totalResponseCount = 0;
+  let totalRating = 0;
+  let dismissed = 0;
+
+  responses.forEach((response) => {
+    const answer = response.data[elementId];
+    if (typeof answer === "number") {
+      totalResponseCount++;
+      choiceCountMap[answer]++;
+      totalRating += answer;
+    } else if (response.ttc && response.ttc[elementId] > 0) {
+      dismissed++;
+    }
+  });
+
+  const choices = Object.entries(choiceCountMap).map(([label, count]) => ({
+    rating: Number.parseInt(label),
+    count,
+    percentage: totalResponseCount > 0 ? convertFloatTo2Decimal((count / totalResponseCount) * 100) : 0,
+  }));
+
+  const average = totalResponseCount > 0 ? convertFloatTo2Decimal(totalRating / totalResponseCount) : 0;
+
+  return { choices, choiceCountMap, totalResponseCount, totalRating, dismissed, average };
+};
+
 export const getElementSummary = async (
   survey: TSurvey,
   elements: TSurveyElement[],
@@ -472,72 +514,16 @@ export const getElementSummary = async (
         break;
       }
       case TSurveyElementTypeEnum.Rating: {
-        let values: TSurveyElementSummaryRating["choices"] = [];
-        const choiceCountMap: Record<number, number> = {};
-        const range = element.range;
-
-        for (let i = 1; i <= range; i++) {
-          choiceCountMap[i] = 0;
-        }
-
-        let totalResponseCount = 0;
-        let totalRating = 0;
-        let dismissed = 0;
-
-        responses.forEach((response) => {
-          const answer = response.data[element.id];
-          if (typeof answer === "number") {
-            totalResponseCount++;
-            choiceCountMap[answer]++;
-            totalRating += answer;
-          } else if (response.ttc && response.ttc[element.id] > 0) {
-            dismissed++;
-          }
-        });
-
-        Object.entries(choiceCountMap).forEach(([label, count]) => {
-          values.push({
-            rating: Number.parseInt(label),
-            count,
-            percentage:
-              totalResponseCount > 0 ? convertFloatTo2Decimal((count / totalResponseCount) * 100) : 0,
-          });
-        });
-
-        // Calculate CSAT based on range
-        let satisfiedCount = 0;
-        if (range === 3) {
-          satisfiedCount = choiceCountMap[3] || 0;
-        } else if (range === 4) {
-          satisfiedCount = (choiceCountMap[3] || 0) + (choiceCountMap[4] || 0);
-        } else if (range === 5) {
-          satisfiedCount = (choiceCountMap[4] || 0) + (choiceCountMap[5] || 0);
-        } else if (range === 6) {
-          satisfiedCount = (choiceCountMap[5] || 0) + (choiceCountMap[6] || 0);
-        } else if (range === 7) {
-          satisfiedCount = (choiceCountMap[6] || 0) + (choiceCountMap[7] || 0);
-        } else if (range === 10) {
-          satisfiedCount = (choiceCountMap[8] || 0) + (choiceCountMap[9] || 0) + (choiceCountMap[10] || 0);
-        }
-        const satisfiedPercentage =
-          totalResponseCount > 0 ? Math.round((satisfiedCount / totalResponseCount) * 100) : 0;
+        const stats = computeNumericScaleStats(element.id, element.range, responses);
 
         summary.push({
           type: element.type,
           element,
-          average: convertFloatTo2Decimal(totalRating / totalResponseCount) || 0,
-          responseCount: totalResponseCount,
-          choices: values,
-          dismissed: {
-            count: dismissed,
-          },
-          csat: {
-            satisfiedCount,
-            satisfiedPercentage,
-          },
+          average: stats.average,
+          responseCount: stats.totalResponseCount,
+          choices: stats.choices,
+          dismissed: { count: stats.dismissed },
         });
-
-        values = [];
         break;
       }
       case TSurveyElementTypeEnum.NPS: {
@@ -612,6 +598,40 @@ export const getElementSummary = async (
         });
         break;
       }
+      case TSurveyElementTypeEnum.CSAT: {
+        const stats = computeNumericScaleStats(element.id, element.range, responses);
+
+        // CSAT: top 2 ratings out of 5 are "satisfied"
+        const satisfiedCount = (stats.choiceCountMap[4] || 0) + (stats.choiceCountMap[5] || 0);
+        const satisfiedPercentage =
+          stats.totalResponseCount > 0
+            ? convertFloatTo2Decimal((satisfiedCount / stats.totalResponseCount) * 100)
+            : 0;
+
+        summary.push({
+          type: element.type,
+          element,
+          average: stats.average,
+          responseCount: stats.totalResponseCount,
+          choices: stats.choices,
+          dismissed: { count: stats.dismissed },
+          csat: { satisfiedCount, satisfiedPercentage },
+        });
+        break;
+      }
+      case TSurveyElementTypeEnum.CES: {
+        const stats = computeNumericScaleStats(element.id, element.range, responses);
+
+        summary.push({
+          type: element.type,
+          element,
+          average: stats.average,
+          responseCount: stats.totalResponseCount,
+          choices: stats.choices,
+          dismissed: { count: stats.dismissed },
+        });
+        break;
+      }
       case TSurveyElementTypeEnum.CTA: {
         // Only calculate summary for CTA elements with external buttons (CTR tracking is only meaningful for external links)
         if (!element.buttonExternal) {

apps/web/app/(app)/workspaces/[workspaceId]/surveys/[surveyId]/components/ElementFilterComboBox.tsx

@@ -287,7 +287,7 @@ export const ElementFilterComboBox = ({
           </div>
 
           {open && (
-            <div className="animate-in absolute top-full z-10 mt-1 w-full overflow-auto rounded-md bg-white shadow-md outline-none">
+            <div className="absolute top-full z-10 mt-1 w-full overflow-auto rounded-md bg-white shadow-md outline-none animate-in">
               <CommandList className="max-h-52">
                 <CommandInput
                   value={searchQuery}

apps/web/app/(app)/workspaces/[workspaceId]/surveys/[surveyId]/components/ElementsComboBox.tsx

@@ -232,7 +232,7 @@ export const ElementsComboBox = ({ options, selected, onChangeValue }: ElementCo
       </div>
 
       {open && (
-        <div className="animate-in absolute top-full z-10 mt-1 w-full overflow-auto rounded-md shadow-md outline-none">
+        <div className="absolute top-full z-10 mt-1 w-full overflow-auto rounded-md shadow-md outline-none animate-in">
           <CommandList className="max-h-[600px]">
             <CommandEmpty>{t("common.no_result_found")}</CommandEmpty>
             {options?.map((data) => (

apps/web/app/(app)/workspaces/[workspaceId]/surveys/[surveyId]/components/SurveyStatusDropdown.tsx

@@ -4,7 +4,6 @@ import { useRouter } from "next/navigation";
 import toast from "react-hot-toast";
 import { useTranslation } from "react-i18next";
 import { TSurvey } from "@formbricks/types/surveys/types";
-import { useWorkspaceContext } from "@/app/(app)/workspaces/[workspaceId]/context/workspace-context";
 import { getFormattedErrorMessage } from "@/lib/utils/helper";
 import { updateSurveyAction } from "@/modules/survey/editor/actions";
 import {
@@ -22,18 +21,19 @@ interface SurveyStatusDropdownProps {
 }
 
 export const SurveyStatusDropdown = ({ updateLocalSurveyStatus, survey }: SurveyStatusDropdownProps) => {
-  const { workspace } = useWorkspaceContext();
   const { t } = useTranslation();
   const router = useRouter();
+  const isScheduled = survey.status === "paused" && survey.publishOn !== null;
 
   const handleStatusChange = async (status: TSurvey["status"]) => {
     const updateSurveyActionResponse = await updateSurveyAction({ ...survey, status });
 
     if (updateSurveyActionResponse?.data) {
-      const resultingStatus = updateSurveyActionResponse.data.status;
+      const { publishOn, status: resultingStatus } = updateSurveyActionResponse.data;
+      const isResultScheduled = resultingStatus === "paused" && publishOn !== null;
       const statusToToastMessage: Partial<Record<TSurvey["status"], string>> = {
         inProgress: t("common.survey_live"),
-        paused: t("common.survey_paused"),
+        paused: isResultScheduled ? t("common.survey_scheduled") : t("common.survey_paused"),
         completed: t("common.survey_completed"),
       };
 
@@ -68,12 +68,10 @@ export const SurveyStatusDropdown = ({ updateLocalSurveyStatus, survey }: Survey
           <SelectTrigger className="w-[170px] bg-white md:w-[200px]">
             <SelectValue>
               <div className="flex items-center">
-                {(survey.type === "link" || workspace.appSetupCompleted) && (
-                  <SurveyStatusIndicator status={survey.status} />
-                )}
+                <SurveyStatusIndicator status={survey.status} isScheduled={isScheduled} />
                 <span className="ml-2 text-sm text-slate-700">
                   {survey.status === "inProgress" && t("common.in_progress")}
-                  {survey.status === "paused" && t("common.paused")}
+                  {survey.status === "paused" && (isScheduled ? t("common.scheduled") : t("common.paused"))}
                   {survey.status === "completed" && t("common.completed")}
                 </span>
               </div>
@@ -88,8 +86,8 @@ export const SurveyStatusDropdown = ({ updateLocalSurveyStatus, survey }: Survey
             </SelectItem>
             <SelectItem className="group font-normal hover:text-slate-900" value="paused">
               <div className="flex w-full items-center justify-center gap-2">
-                <SurveyStatusIndicator status={"paused"} />
-                {t("common.paused")}
+                <SurveyStatusIndicator status={"paused"} isScheduled={isScheduled} />
+                {isScheduled ? t("common.scheduled") : t("common.paused")}
               </div>
             </SelectItem>
             <SelectItem className="group font-normal hover:text-slate-900" value="completed">

apps/web/app/(app)/workspaces/[workspaceId]/surveys/layout.tsx

@@ -0,0 +1,8 @@
+import { type ReactNode } from "react";
+import { SurveysQueryClientProvider } from "./query-client-provider";
+
+const SurveysLayout = ({ children }: { children: ReactNode }) => {
+  return <SurveysQueryClientProvider>{children}</SurveysQueryClientProvider>;
+};
+
+export default SurveysLayout;

apps/web/app/(app)/workspaces/[workspaceId]/surveys/query-client-provider.tsx

@@ -0,0 +1,10 @@
+"use client";
+
+import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
+import { type ReactNode, useState } from "react";
+
+export const SurveysQueryClientProvider = ({ children }: { children: ReactNode }) => {
+  const [queryClient] = useState(() => new QueryClient());
+
+  return <QueryClientProvider client={queryClient}>{children}</QueryClientProvider>;
+};

apps/web/app/(app)/workspaces/[workspaceId]/unify/components/UnifyConfigNavigation.tsx

@@ -0,0 +1,42 @@
+"use client";
+
+import { useTranslation } from "react-i18next";
+import { Badge } from "@/modules/ui/components/badge";
+import { SecondaryNavigation } from "@/modules/ui/components/secondary-navigation";
+
+interface UnifyConfigNavigationProps {
+  workspaceId: string;
+  activeId?: string;
+  loading?: boolean;
+}
+
+export const UnifyConfigNavigation = ({
+  workspaceId,
+  activeId: activeIdProp,
+  loading,
+}: UnifyConfigNavigationProps) => {
+  const { t } = useTranslation();
+  const baseHref = `/workspaces/${workspaceId}/unify`;
+
+  const activeId = activeIdProp ?? "feedback-records";
+
+  const navigation = [
+    {
+      id: "feedback-records",
+      label: t("workspace.unify.feedback_records"),
+      href: `${baseHref}/feedback-records`,
+    },
+    {
+      id: "topics-subtopics",
+      label: (
+        <span className="inline-flex items-center gap-2">
+          {t("workspace.unify.topics_and_subtopics")}
+          <Badge text={t("common.soon")} type="gray" size="tiny" />
+        </span>
+      ),
+      disabled: true,
+    },
+  ];
+
+  return <SecondaryNavigation navigation={navigation} activeId={activeId} loading={loading} />;
+};

apps/web/app/(app)/workspaces/[workspaceId]/unify/feedback-records/actions.ts

@@ -0,0 +1,234 @@
+"use server";
+
+import { z } from "zod";
+import { ZId } from "@formbricks/types/common";
+import { authenticatedActionClient } from "@/lib/utils/action-client";
+import { checkAuthorizationUpdated } from "@/lib/utils/action-client/action-client-middleware";
+import { AuthenticatedActionClientCtx } from "@/lib/utils/action-client/types/context";
+import { getOrganizationIdFromWorkspaceId } from "@/lib/utils/helper";
+import { getFeedbackRecordDirectoriesByWorkspaceId } from "@/modules/ee/feedback-record-directory/lib/feedback-record-directory";
+import { createFeedbackRecord, retrieveFeedbackRecord, updateFeedbackRecord } from "@/modules/hub/service";
+import type { FeedbackRecordCreateParams, FeedbackRecordUpdateParams } from "@/modules/hub/types";
+
+const ZFeedbackRecordId = z.uuid();
+
+const ZFeedbackRecordFieldType = z.enum([
+  "text",
+  "categorical",
+  "nps",
+  "csat",
+  "ces",
+  "rating",
+  "number",
+  "boolean",
+  "date",
+]);
+
+const ZFeedbackRecordMetadata = z.record(z.string(), z.unknown());
+
+const ZFeedbackRecordCreateInput = z.object({
+  submission_id: z.string().min(1),
+  tenant_id: ZId,
+  source_type: z.string().min(1),
+  field_id: z.string().min(1),
+  field_type: ZFeedbackRecordFieldType,
+  collected_at: z.iso.datetime().optional(),
+  source_id: z.string().optional().nullable(),
+  source_name: z.string().optional().nullable(),
+  field_label: z.string().optional().nullable(),
+  field_group_id: z.string().optional(),
+  field_group_label: z.string().optional().nullable(),
+  value_text: z.string().optional().nullable(),
+  value_number: z.number().optional(),
+  value_boolean: z.boolean().optional(),
+  value_date: z.iso.datetime().optional(),
+  metadata: ZFeedbackRecordMetadata.optional(),
+  language: z.string().optional(),
+  user_identifier: z.string().optional(),
+});
+
+const ZFeedbackRecordUpdateInput = z
+  .object({
+    value_text: z.string().optional().nullable(),
+    value_number: z.number().optional().nullable(),
+    value_boolean: z.boolean().optional().nullable(),
+    value_date: z.iso.datetime().optional().nullable(),
+    language: z.string().optional().nullable(),
+    metadata: ZFeedbackRecordMetadata.optional(),
+    user_identifier: z.string().optional().nullable(),
+  })
+  .refine(
+    (value) => Object.values(value).some((entry) => entry !== undefined),
+    "At least one field must be provided for update"
+  );
+
+const ZRetrieveFeedbackRecordAction = z.object({
+  workspaceId: ZId,
+  recordId: ZFeedbackRecordId,
+});
+
+const ZCreateFeedbackRecordAction = z.object({
+  workspaceId: ZId,
+  recordInput: ZFeedbackRecordCreateInput,
+});
+
+const ZUpdateFeedbackRecordAction = z.object({
+  workspaceId: ZId,
+  recordId: ZFeedbackRecordId,
+  updateInput: ZFeedbackRecordUpdateInput,
+});
+
+const ensureAccess = async (
+  userId: string,
+  workspaceId: string,
+  minPermission: "read" | "readWrite"
+): Promise<void> => {
+  const organizationId = await getOrganizationIdFromWorkspaceId(workspaceId);
+  await checkAuthorizationUpdated({
+    userId,
+    organizationId,
+    access: [
+      {
+        type: "organization",
+        roles: ["owner", "manager"],
+      },
+      {
+        type: "workspaceTeam",
+        minPermission,
+        workspaceId,
+      },
+    ],
+  });
+};
+
+const getWorkspaceDirectoryIds = async (workspaceId: string): Promise<Set<string>> => {
+  const directories = await getFeedbackRecordDirectoriesByWorkspaceId(workspaceId);
+  return new Set(directories.map((directory) => directory.id));
+};
+
+const assertRecordBelongsToWorkspace = (directoryIds: Set<string>, tenantId: string): void => {
+  if (!directoryIds.has(tenantId)) {
+    // Throw a generic error indistinguishable from "not found" to prevent IDOR
+    throw new Error("Feedback record not found");
+  }
+};
+
+export const retrieveFeedbackRecordAction = authenticatedActionClient
+  .inputSchema(ZRetrieveFeedbackRecordAction)
+  .action(
+    async ({
+      ctx,
+      parsedInput,
+    }: {
+      ctx: AuthenticatedActionClientCtx;
+      parsedInput: z.infer<typeof ZRetrieveFeedbackRecordAction>;
+    }) => {
+      const [, workspaceDirectoryIds] = await Promise.all([
+        ensureAccess(ctx.user.id, parsedInput.workspaceId, "read"),
+        getWorkspaceDirectoryIds(parsedInput.workspaceId),
+      ]);
+
+      const recordResult = await retrieveFeedbackRecord(parsedInput.recordId);
+      if (!recordResult.data || recordResult.error) {
+        throw new Error("Feedback record not found");
+      }
+
+      assertRecordBelongsToWorkspace(workspaceDirectoryIds, recordResult.data.tenant_id);
+
+      return recordResult.data;
+    }
+  );
+
+export const createFeedbackRecordAction = authenticatedActionClient
+  .inputSchema(ZCreateFeedbackRecordAction)
+  .action(
+    async ({
+      ctx,
+      parsedInput,
+    }: {
+      ctx: AuthenticatedActionClientCtx;
+      parsedInput: z.infer<typeof ZCreateFeedbackRecordAction>;
+    }) => {
+      await ensureAccess(ctx.user.id, parsedInput.workspaceId, "readWrite");
+
+      const workspaceDirectoryIds = await getWorkspaceDirectoryIds(parsedInput.workspaceId);
+      assertRecordBelongsToWorkspace(workspaceDirectoryIds, parsedInput.recordInput.tenant_id);
+
+      const { recordInput } = parsedInput;
+      const createParams: FeedbackRecordCreateParams = {
+        submission_id: recordInput.submission_id,
+        tenant_id: recordInput.tenant_id,
+        source_type: recordInput.source_type,
+        field_id: recordInput.field_id,
+        field_type: recordInput.field_type,
+        collected_at: recordInput.collected_at,
+        source_id: recordInput.source_id,
+        source_name: recordInput.source_name,
+        field_label: recordInput.field_label,
+        field_group_id: recordInput.field_group_id,
+        field_group_label: recordInput.field_group_label,
+        value_text: recordInput.value_text,
+        value_number: recordInput.value_number,
+        value_boolean: recordInput.value_boolean,
+        value_date: recordInput.value_date,
+        metadata: recordInput.metadata,
+        language: recordInput.language,
+        user_identifier: recordInput.user_identifier,
+      };
+
+      const createResult = await createFeedbackRecord(createParams);
+      if (!createResult.data || createResult.error) {
+        throw new Error(createResult.error?.message || "Failed to create feedback record");
+      }
+
+      return createResult.data;
+    }
+  );
+
+export const updateFeedbackRecordAction = authenticatedActionClient
+  .inputSchema(ZUpdateFeedbackRecordAction)
+  .action(
+    async ({
+      ctx,
+      parsedInput,
+    }: {
+      ctx: AuthenticatedActionClientCtx;
+      parsedInput: z.infer<typeof ZUpdateFeedbackRecordAction>;
+    }) => {
+      const [, workspaceDirectoryIds] = await Promise.all([
+        ensureAccess(ctx.user.id, parsedInput.workspaceId, "readWrite"),
+        getWorkspaceDirectoryIds(parsedInput.workspaceId),
+      ]);
+
+      const currentRecordResult = await retrieveFeedbackRecord(parsedInput.recordId);
+      if (!currentRecordResult.data || currentRecordResult.error) {
+        throw new Error("Feedback record not found");
+      }
+
+      assertRecordBelongsToWorkspace(workspaceDirectoryIds, currentRecordResult.data.tenant_id);
+
+      const { updateInput } = parsedInput;
+      const updateParams: FeedbackRecordUpdateParams = {
+        ...(updateInput.value_text !== undefined && { value_text: updateInput.value_text ?? undefined }),
+        ...(updateInput.value_number !== undefined && {
+          value_number: updateInput.value_number ?? undefined,
+        }),
+        ...(updateInput.value_boolean !== undefined && {
+          value_boolean: updateInput.value_boolean ?? undefined,
+        }),
+        ...(updateInput.value_date !== undefined && { value_date: updateInput.value_date ?? undefined }),
+        ...(updateInput.language !== undefined && { language: updateInput.language ?? undefined }),
+        ...(updateInput.metadata !== undefined && { metadata: updateInput.metadata }),
+        ...(updateInput.user_identifier !== undefined && {
+          user_identifier: updateInput.user_identifier ?? undefined,
+        }),
+      };
+
+      const updateResult = await updateFeedbackRecord(parsedInput.recordId, updateParams);
+      if (!updateResult.data || updateResult.error) {
+        throw new Error(updateResult.error?.message || "Failed to update feedback record");
+      }
+
+      return updateResult.data;
+    }
+  );

apps/web/app/(app)/workspaces/[workspaceId]/unify/feedback-records/components/feedback-record-form-drawer.tsx

@@ -0,0 +1,814 @@
+"use client";
+
+import { zodResolver } from "@hookform/resolvers/zod";
+import { PlusIcon } from "lucide-react";
+import { useCallback, useEffect, useMemo, useState } from "react";
+import { useFieldArray, useForm } from "react-hook-form";
+import { toast } from "react-hot-toast";
+import { useTranslation } from "react-i18next";
+import { getFormattedErrorMessage } from "@/lib/utils/helper";
+import type { FeedbackRecordData } from "@/modules/hub/types";
+import { AlertDialog } from "@/modules/ui/components/alert-dialog";
+import { Button } from "@/modules/ui/components/button";
+import {
+  FormControl,
+  FormError,
+  FormField,
+  FormItem,
+  FormLabel,
+  FormProvider,
+} from "@/modules/ui/components/form";
+import { Input } from "@/modules/ui/components/input";
+import {
+  Select,
+  SelectContent,
+  SelectItem,
+  SelectTrigger,
+  SelectValue,
+} from "@/modules/ui/components/select";
+import {
+  Sheet,
+  SheetContent,
+  SheetDescription,
+  SheetFooter,
+  SheetHeader,
+  SheetTitle,
+} from "@/modules/ui/components/sheet";
+import { Switch } from "@/modules/ui/components/switch";
+import {
+  createFeedbackRecordAction,
+  retrieveFeedbackRecordAction,
+  updateFeedbackRecordAction,
+} from "../actions";
+import {
+  FIELD_TYPE_OPTIONS,
+  SOURCE_TYPE_CUSTOM_VALUE,
+  SOURCE_TYPE_PRESET_OPTIONS,
+  type TFeedbackRecordFormValues,
+  ZFeedbackRecordFormValues,
+} from "../lib/types";
+import {
+  formatSourceType,
+  getCreateDefaults,
+  getReadOnlyMetadataEntries,
+  getValueFieldByType,
+  isPresetSourceType,
+  mapRecordToValues,
+  parseNumberValue,
+  toISOOrUndefined,
+} from "../lib/utils";
+
+type FeedbackRecordDrawerMode = "create" | "edit";
+
+interface FeedbackRecordFormDrawerProps {
+  mode: FeedbackRecordDrawerMode;
+  open: boolean;
+  onOpenChange: (open: boolean) => void;
+  workspaceId: string;
+  directories: { id: string; name: string }[];
+  canWrite: boolean;
+  recordId?: string;
+  onSuccess: () => Promise<void> | void;
+}
+
+export const FeedbackRecordFormDrawer = ({
+  mode,
+  open,
+  onOpenChange,
+  workspaceId,
+  directories,
+  canWrite,
+  recordId,
+  onSuccess,
+}: Readonly<FeedbackRecordFormDrawerProps>) => {
+  const { t } = useTranslation();
+  const [record, setRecord] = useState<FeedbackRecordData | null>(null);
+  const [isLoadingRecord, setIsLoadingRecord] = useState(false);
+  const [isSubmitting, setIsSubmitting] = useState(false);
+  const [isDiscardDialogOpen, setIsDiscardDialogOpen] = useState(false);
+
+  const defaultValues = useMemo(() => getCreateDefaults(directories), [directories]);
+
+  const form = useForm<TFeedbackRecordFormValues>({
+    resolver: zodResolver(ZFeedbackRecordFormValues),
+    defaultValues,
+  });
+
+  const { fields, append, remove } = useFieldArray({
+    control: form.control,
+    name: "metadataEntries",
+  });
+
+  const fieldType = form.watch("field_type");
+  const selectedValueField = getValueFieldByType(fieldType);
+  const isEditMode = mode === "edit";
+  const isReadOnly = isEditMode && !canWrite;
+
+  const [sourceTypeMode, setSourceTypeMode] = useState<string>("survey");
+  const [customSourceType, setCustomSourceType] = useState("");
+
+  const readOnlyMetadataEntries = useMemo(() => (record ? getReadOnlyMetadataEntries(record) : []), [record]);
+
+  const resetForCreate = useCallback(() => {
+    const nextDefaults = getCreateDefaults(directories);
+    form.reset(nextDefaults);
+    setRecord(null);
+    setSourceTypeMode(nextDefaults.source_type);
+    setCustomSourceType("");
+  }, [directories, form]);
+
+  useEffect(() => {
+    if (!open) return;
+
+    if (mode === "create") {
+      resetForCreate();
+      return;
+    }
+
+    if (!recordId) return;
+
+    const loadRecord = async () => {
+      setIsLoadingRecord(true);
+      const result = await retrieveFeedbackRecordAction({ workspaceId, recordId });
+
+      if (!result?.data) {
+        toast.error(getFormattedErrorMessage(result) || t("workspace.unify.failed_to_load_feedback_records"));
+        setIsLoadingRecord(false);
+        return;
+      }
+
+      setRecord(result.data);
+      form.reset(mapRecordToValues(result.data));
+      const isPreset = isPresetSourceType(result.data.source_type);
+      setSourceTypeMode(isPreset ? result.data.source_type : SOURCE_TYPE_CUSTOM_VALUE);
+      setCustomSourceType(isPreset ? "" : result.data.source_type);
+      setIsLoadingRecord(false);
+    };
+
+    void loadRecord();
+  }, [form, mode, open, recordId, resetForCreate, t, workspaceId]);
+
+  const requestClose = useCallback(() => {
+    if (form.formState.isDirty && !isSubmitting) {
+      setIsDiscardDialogOpen(true);
+      return;
+    }
+
+    onOpenChange(false);
+  }, [form.formState.isDirty, isSubmitting, onOpenChange]);
+
+  const handleDrawerOpenChange = useCallback(
+    (nextOpen: boolean) => {
+      if (nextOpen) {
+        onOpenChange(true);
+        return;
+      }
+
+      requestClose();
+    },
+    [onOpenChange, requestClose]
+  );
+
+  const handleDiscardChanges = () => {
+    setIsDiscardDialogOpen(false);
+    onOpenChange(false);
+  };
+
+  const setStrictValueValidationError = (message: string) => {
+    form.setError(selectedValueField, { type: "manual", message });
+  };
+
+  const handleSubmit = form.handleSubmit(async (values) => {
+    form.clearErrors();
+
+    if (mode === "create") {
+      const requiredValueError = t("workspace.unify.feedback_record_value_required");
+      if (selectedValueField === "value_text" && !values.value_text?.trim()) {
+        setStrictValueValidationError(requiredValueError);
+        return;
+      }
+      if (selectedValueField === "value_number" && parseNumberValue(values.value_number ?? "") == null) {
+        setStrictValueValidationError(requiredValueError);
+        return;
+      }
+      if (selectedValueField === "value_boolean" && values.value_boolean === undefined) {
+        setStrictValueValidationError(requiredValueError);
+        return;
+      }
+      if (selectedValueField === "value_date" && !toISOOrUndefined(values.value_date)) {
+        setStrictValueValidationError(requiredValueError);
+        return;
+      }
+    }
+
+    const metadata = Object.fromEntries(
+      values.metadataEntries
+        .map((entry) => ({
+          key: entry.key.trim(),
+          value: entry.value,
+        }))
+        .filter((entry) => entry.key.length > 0)
+        .map((entry) => [entry.key, entry.value])
+    );
+
+    setIsSubmitting(true);
+
+    try {
+      if (mode === "create") {
+        const sourceTypeValue =
+          sourceTypeMode === SOURCE_TYPE_CUSTOM_VALUE ? customSourceType.trim() : values.source_type;
+
+        const createResult = await createFeedbackRecordAction({
+          workspaceId,
+          recordInput: {
+            submission_id: values.submission_id.trim(),
+            tenant_id: values.tenant_id,
+            source_type: sourceTypeValue,
+            source_id: values.source_id?.trim() ? values.source_id.trim() : null,
+            source_name: values.source_name?.trim() ? values.source_name.trim() : null,
+            field_id: values.field_id.trim(),
+            field_label: values.field_label?.trim() ? values.field_label.trim() : null,
+            field_type: values.field_type,
+            field_group_id: values.field_group_id?.trim() || undefined,
+            field_group_label: values.field_group_label?.trim() ? values.field_group_label.trim() : null,
+            collected_at: toISOOrUndefined(values.collected_at),
+            value_text: selectedValueField === "value_text" ? (values.value_text ?? "") : null,
+            value_number:
+              selectedValueField === "value_number"
+                ? (parseNumberValue(values.value_number ?? "") ?? undefined)
+                : undefined,
+            value_boolean: selectedValueField === "value_boolean" ? values.value_boolean : undefined,
+            value_date: selectedValueField === "value_date" ? toISOOrUndefined(values.value_date) : undefined,
+            metadata: Object.keys(metadata).length > 0 ? metadata : undefined,
+            language: values.language?.trim() || undefined,
+            user_identifier: values.user_identifier?.trim() || undefined,
+          },
+        });
+
+        if (!createResult?.data) {
+          toast.error(getFormattedErrorMessage(createResult));
+          setIsSubmitting(false);
+          return;
+        }
+      } else {
+        if (!recordId) {
+          setIsSubmitting(false);
+          return;
+        }
+
+        const preservedMetadata = Object.fromEntries(
+          Object.entries(record?.metadata ?? {}).filter(([, value]) => typeof value !== "string")
+        );
+
+        const updatePayload: {
+          language: string | null;
+          user_identifier: string | null;
+          metadata: Record<string, unknown>;
+          value_text?: string;
+          value_number?: number | null;
+          value_boolean?: boolean | null;
+          value_date?: string | null;
+        } = {
+          language: values.language?.trim() || null,
+          user_identifier: values.user_identifier?.trim() || null,
+          metadata: { ...preservedMetadata, ...metadata },
+        };
+
+        if (selectedValueField === "value_text") {
+          updatePayload.value_text = values.value_text?.trim() ?? "";
+        } else if (selectedValueField === "value_number") {
+          updatePayload.value_number = parseNumberValue(values.value_number ?? "");
+        } else if (selectedValueField === "value_boolean") {
+          updatePayload.value_boolean = values.value_boolean ?? null;
+        } else if (selectedValueField === "value_date") {
+          updatePayload.value_date = toISOOrUndefined(values.value_date) ?? null;
+        }
+
+        const updateResult = await updateFeedbackRecordAction({
+          workspaceId,
+          recordId,
+          updateInput: updatePayload,
+        });
+
+        if (!updateResult?.data) {
+          toast.error(getFormattedErrorMessage(updateResult));
+          setIsSubmitting(false);
+          return;
+        }
+      }
+
+      toast.success(
+        mode === "create"
+          ? t("workspace.unify.feedback_record_created_successfully")
+          : t("workspace.unify.feedback_record_updated_successfully")
+      );
+      await onSuccess();
+      onOpenChange(false);
+    } finally {
+      setIsSubmitting(false);
+    }
+  });
+
+  const drawerTitle =
+    mode === "create"
+      ? t("workspace.unify.add_feedback_record")
+      : t("workspace.unify.feedback_record_details");
+
+  const drawerDescription =
+    mode === "create"
+      ? t("workspace.unify.add_feedback_record_description")
+      : t("workspace.unify.feedback_record_details_description");
+
+  const valueBooleanStatus = form.watch("value_boolean");
+  let valueBooleanLabel = t("common.not_set");
+  if (valueBooleanStatus === true) {
+    valueBooleanLabel = t("common.yes");
+  } else if (valueBooleanStatus === false) {
+    valueBooleanLabel = t("common.no");
+  }
+
+  return (
+    <>
+      <Sheet open={open} onOpenChange={handleDrawerOpenChange}>
+        <SheetContent className="w-full overflow-y-auto bg-white px-5 sm:max-w-2xl">
+          <SheetHeader>
+            <SheetTitle>{drawerTitle}</SheetTitle>
+            <SheetDescription>{drawerDescription}</SheetDescription>
+          </SheetHeader>
+
+          {isLoadingRecord ? (
+            <div className="py-8 text-sm text-slate-500">{t("common.loading")}</div>
+          ) : (
+            <FormProvider {...form}>
+              <form className="space-y-4 py-4" onSubmit={handleSubmit}>
+                <div className="grid grid-cols-2 gap-3">
+                  <FormField
+                    control={form.control}
+                    name="id"
+                    render={({ field }) => (
+                      <FormItem>
+                        <FormLabel>{t("common.id")}</FormLabel>
+                        <FormControl>
+                          <Input {...field} disabled placeholder={t("workspace.unify.auto_generated")} />
+                        </FormControl>
+                      </FormItem>
+                    )}
+                  />
+                  <FormField
+                    control={form.control}
+                    name="tenant_id"
+                    render={({ field }) => (
+                      <FormItem>
+                        <FormLabel>{t("workspace.unify.feedback_record_directory")}</FormLabel>
+                        <FormControl>
+                          <Select value={field.value} onValueChange={field.onChange} disabled>
+                            <SelectTrigger>
+                              <SelectValue
+                                placeholder={t("workspace.unify.select_feedback_record_directory")}
+                              />
+                            </SelectTrigger>
+                            <SelectContent>
+                              {directories.map((directory) => (
+                                <SelectItem key={directory.id} value={directory.id}>
+                                  {directory.name}
+                                </SelectItem>
+                              ))}
+                            </SelectContent>
+                          </Select>
+                        </FormControl>
+                        <FormError />
+                      </FormItem>
+                    )}
+                  />
+                </div>
+
+                <div className="grid grid-cols-2 gap-3">
+                  <FormField
+                    control={form.control}
+                    name="submission_id"
+                    render={({ field }) => (
+                      <FormItem>
+                        <FormLabel>{t("workspace.unify.submission_id")}</FormLabel>
+                        <FormControl>
+                          <Input {...field} disabled={isEditMode || !canWrite} />
+                        </FormControl>
+                        <FormError />
+                      </FormItem>
+                    )}
+                  />
+                  <FormField
+                    control={form.control}
+                    name="collected_at"
+                    render={({ field }) => (
+                      <FormItem>
+                        <FormLabel>{t("workspace.unify.collected_at")}</FormLabel>
+                        <FormControl>
+                          <Input {...field} type="datetime-local" disabled={isEditMode || !canWrite} />
+                        </FormControl>
+                        <FormError />
+                      </FormItem>
+                    )}
+                  />
+                </div>
+
+                <div className="grid grid-cols-2 gap-3">
+                  <FormField
+                    control={form.control}
+                    name="created_at"
+                    render={({ field }) => (
+                      <FormItem>
+                        <FormLabel>{t("common.created_at")}</FormLabel>
+                        <FormControl>
+                          <Input {...field} disabled placeholder={t("workspace.unify.auto_generated")} />
+                        </FormControl>
+                      </FormItem>
+                    )}
+                  />
+                  <FormField
+                    control={form.control}
+                    name="updated_at"
+                    render={({ field }) => (
+                      <FormItem>
+                        <FormLabel>{t("workspace.unify.updated_at")}</FormLabel>
+                        <FormControl>
+                          <Input {...field} disabled placeholder={t("workspace.unify.auto_generated")} />
+                        </FormControl>
+                      </FormItem>
+                    )}
+                  />
+                </div>
+
+                {isEditMode ? (
+                  <FormField
+                    control={form.control}
+                    name="source_type"
+                    render={({ field }) => (
+                      <FormItem>
+                        <FormLabel>{t("workspace.unify.source_type")}</FormLabel>
+                        <FormControl>
+                          <Input {...field} value={formatSourceType(field.value, t)} disabled />
+                        </FormControl>
+                      </FormItem>
+                    )}
+                  />
+                ) : (
+                  <div className="space-y-2">
+                    <FormLabel>{t("workspace.unify.source_type")}</FormLabel>
+                    <Select
+                      value={sourceTypeMode}
+                      onValueChange={(value) => {
+                        setSourceTypeMode(value);
+                        if (value !== SOURCE_TYPE_CUSTOM_VALUE) {
+                          form.setValue("source_type", value, { shouldDirty: true });
+                        }
+                      }}
+                      disabled={!canWrite}>
+                      <SelectTrigger>
+                        <SelectValue placeholder={t("workspace.unify.select_feedback_record_source_type")} />
+                      </SelectTrigger>
+                      <SelectContent>
+                        {SOURCE_TYPE_PRESET_OPTIONS.map((option) => (
+                          <SelectItem key={option} value={option}>
+                            {option}
+                          </SelectItem>
+                        ))}
+                        <SelectItem value={SOURCE_TYPE_CUSTOM_VALUE}>
+                          {t("workspace.unify.custom_source_type")}
+                        </SelectItem>
+                      </SelectContent>
+                    </Select>
+                    {sourceTypeMode === SOURCE_TYPE_CUSTOM_VALUE && (
+                      <Input
+                        value={customSourceType}
+                        onChange={(event) => {
+                          setCustomSourceType(event.target.value);
+                          form.setValue("source_type", event.target.value, { shouldDirty: true });
+                        }}
+                        placeholder={t("workspace.unify.custom_source_type_placeholder")}
+                        disabled={!canWrite}
+                      />
+                    )}
+                    <FormError>{form.formState.errors.source_type?.message}</FormError>
+                  </div>
+                )}
+
+                <div className="grid grid-cols-2 gap-3">
+                  <FormField
+                    control={form.control}
+                    name="source_id"
+                    render={({ field }) => (
+                      <FormItem>
+                        <FormLabel>{t("workspace.unify.source_id")}</FormLabel>
+                        <FormControl>
+                          <Input {...field} disabled={isEditMode || !canWrite} />
+                        </FormControl>
+                      </FormItem>
+                    )}
+                  />
+                  <FormField
+                    control={form.control}
+                    name="source_name"
+                    render={({ field }) => (
+                      <FormItem>
+                        <FormLabel>{t("workspace.unify.source_name")}</FormLabel>
+                        <FormControl>
+                          <Input {...field} disabled={isEditMode || !canWrite} />
+                        </FormControl>
+                      </FormItem>
+                    )}
+                  />
+                </div>
+
+                <div className="grid grid-cols-2 gap-3">
+                  <FormField
+                    control={form.control}
+                    name="field_id"
+                    render={({ field }) => (
+                      <FormItem>
+                        <FormLabel>{t("workspace.unify.field_id")}</FormLabel>
+                        <FormControl>
+                          <Input {...field} disabled={isEditMode || !canWrite} />
+                        </FormControl>
+                        <FormError />
+                      </FormItem>
+                    )}
+                  />
+                  <FormField
+                    control={form.control}
+                    name="field_label"
+                    render={({ field }) => (
+                      <FormItem>
+                        <FormLabel>{t("workspace.unify.field_label")}</FormLabel>
+                        <FormControl>
+                          <Input {...field} disabled={isEditMode || !canWrite} />
+                        </FormControl>
+                      </FormItem>
+                    )}
+                  />
+                </div>
+
+                <div className="grid grid-cols-2 gap-3">
+                  <FormField
+                    control={form.control}
+                    name="field_type"
+                    render={({ field }) => (
+                      <FormItem>
+                        <FormLabel>{t("workspace.unify.field_type")}</FormLabel>
+                        <FormControl>
+                          <Select
+                            value={field.value}
+                            onValueChange={(value) =>
+                              field.onChange(value as TFeedbackRecordFormValues["field_type"])
+                            }
+                            disabled={isEditMode || !canWrite}>
+                            <SelectTrigger>
+                              <SelectValue />
+                            </SelectTrigger>
+                            <SelectContent>
+                              {FIELD_TYPE_OPTIONS.map((option) => (
+                                <SelectItem key={option} value={option}>
+                                  {option}
+                                </SelectItem>
+                              ))}
+                            </SelectContent>
+                          </Select>
+                        </FormControl>
+                      </FormItem>
+                    )}
+                  />
+                  <FormField
+                    control={form.control}
+                    name="field_group_id"
+                    render={({ field }) => (
+                      <FormItem>
+                        <FormLabel>{t("workspace.unify.field_group_id")}</FormLabel>
+                        <FormControl>
+                          <Input {...field} disabled={isEditMode || !canWrite} />
+                        </FormControl>
+                      </FormItem>
+                    )}
+                  />
+                </div>
+
+                <FormField
+                  control={form.control}
+                  name="field_group_label"
+                  render={({ field }) => (
+                    <FormItem>
+                      <FormLabel>{t("workspace.unify.field_group_label")}</FormLabel>
+                      <FormControl>
+                        <Input {...field} disabled={isEditMode || !canWrite} />
+                      </FormControl>
+                    </FormItem>
+                  )}
+                />
+
+                <FormField
+                  control={form.control}
+                  name="value_text"
+                  render={({ field }) => (
+                    <FormItem>
+                      <FormLabel>{t("workspace.unify.value_text")}</FormLabel>
+                      <FormControl>
+                        <Input
+                          {...field}
+                          value={field.value ?? ""}
+                          disabled={selectedValueField !== "value_text" || isReadOnly || !canWrite}
+                        />
+                      </FormControl>
+                    </FormItem>
+                  )}
+                />
+
+                <div className="grid grid-cols-2 gap-3">
+                  <FormField
+                    control={form.control}
+                    name="value_number"
+                    render={({ field }) => (
+                      <FormItem>
+                        <FormLabel>{t("workspace.unify.value_number")}</FormLabel>
+                        <FormControl>
+                          <Input
+                            {...field}
+                            value={field.value ?? ""}
+                            type="number"
+                            step="any"
+                            disabled={selectedValueField !== "value_number" || isReadOnly || !canWrite}
+                          />
+                        </FormControl>
+                      </FormItem>
+                    )}
+                  />
+                  <FormField
+                    control={form.control}
+                    name="value_date"
+                    render={({ field }) => (
+                      <FormItem>
+                        <FormLabel>{t("workspace.unify.value_date")}</FormLabel>
+                        <FormControl>
+                          <Input
+                            {...field}
+                            value={field.value ?? ""}
+                            type="datetime-local"
+                            disabled={selectedValueField !== "value_date" || isReadOnly || !canWrite}
+                          />
+                        </FormControl>
+                      </FormItem>
+                    )}
+                  />
+                </div>
+
+                <FormField
+                  control={form.control}
+                  name="value_boolean"
+                  render={({ field }) => (
+                    <FormItem>
+                      <FormLabel>{t("workspace.unify.value_boolean")}</FormLabel>
+                      <FormControl>
+                        <div className="flex items-center gap-3 rounded-md border border-slate-200 px-3 py-2">
+                          <Switch
+                            checked={field.value ?? false}
+                            onCheckedChange={(checked) => field.onChange(checked)}
+                            disabled={selectedValueField !== "value_boolean" || isReadOnly || !canWrite}
+                          />
+                          <span className="text-sm text-slate-600">{valueBooleanLabel}</span>
+                        </div>
+                      </FormControl>
+                    </FormItem>
+                  )}
+                />
+                <FormError>{form.formState.errors[selectedValueField]?.message}</FormError>
+
+                <div className="grid grid-cols-2 gap-3">
+                  <FormField
+                    control={form.control}
+                    name="language"
+                    render={({ field }) => (
+                      <FormItem>
+                        <FormLabel>{t("common.language")}</FormLabel>
+                        <FormControl>
+                          <Input {...field} disabled={!canWrite || isReadOnly} />
+                        </FormControl>
+                      </FormItem>
+                    )}
+                  />
+                  <FormField
+                    control={form.control}
+                    name="user_identifier"
+                    render={({ field }) => (
+                      <FormItem>
+                        <FormLabel>{t("workspace.unify.user_identifier")}</FormLabel>
+                        <FormControl>
+                          <Input {...field} disabled={!canWrite || isReadOnly} />
+                        </FormControl>
+                      </FormItem>
+                    )}
+                  />
+                </div>
+
+                <div className="space-y-2">
+                  <div className="flex items-center justify-between">
+                    <FormLabel>{t("workspace.unify.metadata")}</FormLabel>
+                    {canWrite && !isReadOnly && (
+                      <Button
+                        type="button"
+                        variant="ghost"
+                        size="sm"
+                        onClick={() => append({ key: "", value: "" })}>
+                        <PlusIcon className="h-4 w-4" />
+                        {t("common.add")}
+                      </Button>
+                    )}
+                  </div>
+
+                  <div className="space-y-2">
+                    {fields.map((field, index) => (
+                      <div key={field.id} className="grid grid-cols-[1fr_1fr_auto] gap-2">
+                        <FormField
+                          control={form.control}
+                          name={`metadataEntries.${index}.key`}
+                          render={({ field: entryField }) => (
+                            <FormItem>
+                              <FormControl>
+                                <Input
+                                  {...entryField}
+                                  placeholder={t("workspace.unify.metadata_key")}
+                                  disabled={isReadOnly || !canWrite}
+                                />
+                              </FormControl>
+                            </FormItem>
+                          )}
+                        />
+                        <FormField
+                          control={form.control}
+                          name={`metadataEntries.${index}.value`}
+                          render={({ field: entryField }) => (
+                            <FormItem>
+                              <FormControl>
+                                <Input
+                                  {...entryField}
+                                  placeholder={t("workspace.unify.metadata_value")}
+                                  disabled={isReadOnly || !canWrite}
+                                />
+                              </FormControl>
+                            </FormItem>
+                          )}
+                        />
+                        {canWrite && !isReadOnly && (
+                          <Button type="button" variant="outline" onClick={() => remove(index)}>
+                            {t("common.delete")}
+                          </Button>
+                        )}
+                      </div>
+                    ))}
+                  </div>
+
+                  {readOnlyMetadataEntries.length > 0 && (
+                    <div className="space-y-2">
+                      <p className="text-xs text-slate-500">
+                        {t("workspace.unify.metadata_read_only_entries")}
+                      </p>
+                      {readOnlyMetadataEntries.map((entry) => (
+                        <div
+                          key={entry.key}
+                          className="grid grid-cols-2 gap-2 rounded-md bg-slate-50 p-2 text-xs">
+                          <span className="font-medium text-slate-700">{entry.key}</span>
+                          <span className="truncate text-slate-600" title={entry.value}>
+                            {entry.value}
+                          </span>
+                        </div>
+                      ))}
+                    </div>
+                  )}
+                </div>
+              </form>
+            </FormProvider>
+          )}
+
+          <SheetFooter className="mt-2">
+            <Button variant="outline" onClick={requestClose} disabled={isSubmitting}>
+              {t("common.cancel")}
+            </Button>
+            {canWrite && (
+              <Button onClick={handleSubmit} loading={isSubmitting} disabled={isLoadingRecord}>
+                {mode === "create" ? t("workspace.unify.add_feedback_record") : t("common.save")}
+              </Button>
+            )}
+          </SheetFooter>
+        </SheetContent>
+      </Sheet>
+
+      <AlertDialog
+        open={isDiscardDialogOpen}
+        setOpen={setIsDiscardDialogOpen}
+        headerText={t("workspace.unify.discard_feedback_record_changes_title")}
+        mainText={t("workspace.unify.discard_feedback_record_changes_description")}
+        confirmBtnLabel={t("common.discard")}
+        declineBtnLabel={t("common.cancel")}
+        declineBtnVariant="outline"
+        onDecline={() => setIsDiscardDialogOpen(false)}
+        onConfirm={handleDiscardChanges}
+      />
+    </>
+  );
+};

apps/web/app/(app)/workspaces/[workspaceId]/unify/feedback-records/components/feedback-records-page-client.tsx

@@ -0,0 +1,42 @@
+"use client";
+
+import { useTranslation } from "react-i18next";
+import type { FeedbackRecordData } from "@/modules/hub/types";
+import { PageContentWrapper } from "@/modules/ui/components/page-content-wrapper";
+import { PageHeader } from "@/modules/ui/components/page-header";
+import { UnifyConfigNavigation } from "../../components/UnifyConfigNavigation";
+import { FeedbackRecordsTable } from "./feedback-records-table";
+
+interface FeedbackRecordsPageClientProps {
+  workspaceId: string;
+  initialRecords: FeedbackRecordData[];
+  frdMap: Record<string, string>;
+  csvSources: { id: string; name: string }[];
+  canWrite: boolean;
+}
+
+export function FeedbackRecordsPageClient({
+  workspaceId,
+  initialRecords,
+  frdMap,
+  csvSources,
+  canWrite,
+}: Readonly<FeedbackRecordsPageClientProps>) {
+  const { t } = useTranslation();
+
+  return (
+    <PageContentWrapper>
+      <PageHeader pageTitle={t("workspace.unify.feedback_records")}>
+        <UnifyConfigNavigation workspaceId={workspaceId} activeId="feedback-records" />
+      </PageHeader>
+
+      <FeedbackRecordsTable
+        workspaceId={workspaceId}
+        initialRecords={initialRecords}
+        frdMap={frdMap}
+        csvSources={csvSources}
+        canWrite={canWrite}
+      />
+    </PageContentWrapper>
+  );
+}

apps/web/app/(app)/workspaces/[workspaceId]/unify/feedback-records/components/feedback-records-table.tsx

@@ -0,0 +1,364 @@
+"use client";
+
+import { TFunction } from "i18next";
+import {
+  CalendarIcon,
+  ChevronDownIcon,
+  HashIcon,
+  MessageSquareTextIcon,
+  PlusIcon,
+  RefreshCwIcon,
+  ToggleLeftIcon,
+  TypeIcon,
+} from "lucide-react";
+import Link from "next/link";
+import { useMemo, useState } from "react";
+import toast from "react-hot-toast";
+import { useTranslation } from "react-i18next";
+import { listFeedbackRecordsAction } from "@/lib/connector/actions";
+import { formatDateForDisplay, formatDateTimeForDisplay } from "@/lib/utils/datetime";
+import { getFormattedErrorMessage } from "@/lib/utils/helper";
+import type { FeedbackRecordData } from "@/modules/hub/types";
+import { Badge } from "@/modules/ui/components/badge";
+import { Button } from "@/modules/ui/components/button";
+import {
+  DropdownMenu,
+  DropdownMenuContent,
+  DropdownMenuItem,
+  DropdownMenuSeparator,
+  DropdownMenuTrigger,
+} from "@/modules/ui/components/dropdown-menu";
+import { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from "@/modules/ui/components/tooltip";
+import { CsvImportModal } from "../../sources/components/csv-import-modal";
+import { formatSourceType } from "../lib/utils";
+import { FeedbackRecordFormDrawer } from "./feedback-record-form-drawer";
+
+const RECORDS_PER_PAGE = 50;
+
+const FIELD_TYPE_ICONS: Record<string, React.ReactNode> = {
+  text: <TypeIcon className="h-3.5 w-3.5" />,
+  categorical: <HashIcon className="h-3.5 w-3.5" />,
+  nps: <HashIcon className="h-3.5 w-3.5" />,
+  csat: <HashIcon className="h-3.5 w-3.5" />,
+  ces: <HashIcon className="h-3.5 w-3.5" />,
+  rating: <HashIcon className="h-3.5 w-3.5" />,
+  number: <HashIcon className="h-3.5 w-3.5" />,
+  boolean: <ToggleLeftIcon className="h-3.5 w-3.5" />,
+  date: <CalendarIcon className="h-3.5 w-3.5" />,
+};
+
+const formatValue = (record: FeedbackRecordData, t: TFunction, locale: string): string => {
+  if (record.value_text != null) return record.value_text;
+  if (record.value_number != null) return String(record.value_number);
+  if (record.value_boolean != null) return record.value_boolean ? t("common.yes") : t("common.no");
+  if (record.value_date != null) return formatDateForDisplay(new Date(record.value_date), locale);
+  return "—";
+};
+
+function truncate(str: string, maxLen: number): string {
+  if (str.length <= maxLen) return str;
+  return str.slice(0, maxLen) + "…";
+}
+
+interface FeedbackRecordsTableProps {
+  workspaceId: string;
+  initialRecords: FeedbackRecordData[];
+  frdMap: Record<string, string>;
+  csvSources: { id: string; name: string }[];
+  canWrite: boolean;
+}
+
+export const FeedbackRecordsTable = ({
+  workspaceId,
+  initialRecords,
+  frdMap,
+  csvSources,
+  canWrite,
+}: Readonly<FeedbackRecordsTableProps>) => {
+  const { t, i18n } = useTranslation();
+  const [records, setRecords] = useState<FeedbackRecordData[]>(initialRecords);
+  const [isRefreshing, setIsRefreshing] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+  const [drawerMode, setDrawerMode] = useState<"create" | "edit">("edit");
+  const [drawerRecordId, setDrawerRecordId] = useState<string | undefined>();
+  const [isDrawerOpen, setIsDrawerOpen] = useState(false);
+  const [csvImportSource, setCsvImportSource] = useState<{ id: string; name: string } | null>(null);
+
+  const directories = useMemo(
+    () =>
+      Object.entries(frdMap)
+        .map(([id, name]) => ({ id, name }))
+        .sort((a, b) => a.name.localeCompare(b.name)),
+    [frdMap]
+  );
+  const handleRefresh = async () => {
+    if (isRefreshing) return;
+    setIsRefreshing(true);
+    setError(null);
+
+    const toastId = toast.loading(t("workspace.unify.refreshing_feedback_records"));
+    const directoryIds = Object.keys(frdMap);
+    const results = await Promise.all(
+      directoryIds.map((frdId) =>
+        listFeedbackRecordsAction({
+          workspaceId,
+          frdId,
+          limit: RECORDS_PER_PAGE,
+        })
+      )
+    );
+
+    const successfulRecords = results.flatMap((result) => result?.data?.data ?? []);
+
+    if (directoryIds.length > 0 && successfulRecords.length === 0) {
+      const firstErrorResult = results.find((result) => !result?.data);
+      const errorMessage = firstErrorResult ? getFormattedErrorMessage(firstErrorResult) : undefined;
+      toast.error(errorMessage ?? t("workspace.unify.failed_to_load_feedback_records"), {
+        id: toastId,
+      });
+      setIsRefreshing(false);
+      return;
+    }
+
+    const mergedRecords = successfulRecords
+      .toSorted((a, b) => (a.collected_at < b.collected_at ? 1 : -1))
+      .slice(0, RECORDS_PER_PAGE);
+    setRecords(mergedRecords);
+    setIsRefreshing(false);
+    toast.success(t("workspace.unify.feedback_records_refreshed"), { id: toastId });
+  };
+
+  if (error) {
+    return (
+      <div className="rounded-xl border border-slate-200 bg-white shadow-sm">
+        <div className="flex h-48 flex-col items-center justify-center gap-3 px-4 text-center">
+          <MessageSquareTextIcon className="h-8 w-8 text-slate-400" />
+          <p className="text-sm text-slate-500">{error}</p>
+          <Button variant="secondary" size="sm" onClick={handleRefresh}>
+            {t("common.retry")}
+          </Button>
+        </div>
+      </div>
+    );
+  }
+
+  const isEmpty = records.length === 0 && !isRefreshing;
+
+  const openEditDrawer = (recordId: string) => {
+    setDrawerMode("edit");
+    setDrawerRecordId(recordId);
+    setIsDrawerOpen(true);
+  };
+
+  const openCreateDrawer = () => {
+    setDrawerMode("create");
+    setDrawerRecordId(undefined);
+    setIsDrawerOpen(true);
+  };
+
+  const hasCsvSources = csvSources.length > 0;
+
+  return (
+    <>
+      <div className="space-y-3">
+        <div className="flex items-center justify-between">
+          {isEmpty ? (
+            <span />
+          ) : (
+            <p className="text-sm text-slate-500">
+              {t("workspace.unify.showing_count_loaded", {
+                count: records.length,
+              })}
+            </p>
+          )}
+          <div className="flex items-center gap-2">
+            {canWrite &&
+              (hasCsvSources ? (
+                <DropdownMenu>
+                  <DropdownMenuTrigger asChild>
+                    <Button size="sm" variant="secondary">
+                      <PlusIcon className="h-4 w-4" />
+                      {t("workspace.unify.add_feedback_record")}
+                      <ChevronDownIcon className="h-4 w-4" />
+                    </Button>
+                  </DropdownMenuTrigger>
+                  <DropdownMenuContent align="end">
+                    <DropdownMenuItem onClick={openCreateDrawer}>
+                      {t("workspace.unify.add_feedback_record")}
+                    </DropdownMenuItem>
+                    <DropdownMenuSeparator />
+                    {csvSources.map((source) => (
+                      <DropdownMenuItem
+                        key={source.id}
+                        onClick={() => {
+                          setCsvImportSource(source);
+                        }}>
+                        {t("workspace.unify.import_via_source_name", { sourceName: source.name })}
+                      </DropdownMenuItem>
+                    ))}
+                  </DropdownMenuContent>
+                </DropdownMenu>
+              ) : (
+                <Button size="sm" variant="secondary" onClick={openCreateDrawer}>
+                  <PlusIcon className="h-4 w-4" />
+                  {t("workspace.unify.add_feedback_record")}
+                </Button>
+              ))}
+            <Button size="sm" asChild>
+              <Link href={`/workspaces/${workspaceId}/feedback-sources`}>
+                {t("workspace.unify.manage_feedback_sources")}
+              </Link>
+            </Button>
+            <Button
+              variant="secondary"
+              size="sm"
+              onClick={handleRefresh}
+              disabled={isRefreshing}
+              aria-label={t("workspace.unify.refresh_feedback_records")}>
+              <RefreshCwIcon className="h-3.5 w-3.5" aria-hidden="true" />
+            </Button>
+          </div>
+        </div>
+
+        <div className="overflow-hidden rounded-xl border border-slate-200 bg-white shadow-sm">
+          <div className="overflow-x-auto">
+            <table className="w-full min-w-[900px]">
+              <thead>
+                <tr className="border-b border-slate-200 text-left text-sm text-slate-900 [&>th]:font-semibold">
+                  <th className="whitespace-nowrap px-4 py-3">{t("workspace.unify.collected_at")}</th>
+                  <th className="whitespace-nowrap px-4 py-3">{t("workspace.unify.source_type")}</th>
+                  <th className="whitespace-nowrap px-4 py-3">{t("workspace.unify.source_name")}</th>
+                  <th className="whitespace-nowrap px-4 py-3">{t("workspace.unify.field_label")}</th>
+                  <th className="whitespace-nowrap px-4 py-3">{t("workspace.unify.field_type")}</th>
+                  <th className="whitespace-nowrap px-4 py-3">{t("workspace.unify.value")}</th>
+                  <th className="whitespace-nowrap px-4 py-3">{t("workspace.unify.user_identifier")}</th>
+                </tr>
+              </thead>
+              {isEmpty ? (
+                <tbody>
+                  <tr>
+                    <td colSpan={7}>
+                      <div className="flex h-32 items-center justify-center">
+                        <p className="text-sm text-slate-500">{t("workspace.unify.no_feedback_records")}</p>
+                      </div>
+                    </td>
+                  </tr>
+                </tbody>
+              ) : (
+                <tbody className="divide-y divide-slate-100">
+                  {records.map((record) => (
+                    <FeedbackRecordRow
+                      key={record.id}
+                      record={record}
+                      workspaceId={workspaceId}
+                      locale={i18n.resolvedLanguage ?? i18n.language ?? "en-US"}
+                      t={t}
+                      onClick={() => openEditDrawer(record.id)}
+                    />
+                  ))}
+                </tbody>
+              )}
+            </table>
+          </div>
+        </div>
+      </div>
+
+      <FeedbackRecordFormDrawer
+        mode={drawerMode}
+        open={isDrawerOpen}
+        onOpenChange={setIsDrawerOpen}
+        workspaceId={workspaceId}
+        directories={directories}
+        canWrite={canWrite}
+        recordId={drawerMode === "edit" ? drawerRecordId : undefined}
+        onSuccess={handleRefresh}
+      />
+
+      {csvImportSource && (
+        <CsvImportModal
+          open={csvImportSource !== null}
+          onOpenChange={(open) => {
+            if (!open) {
+              setCsvImportSource(null);
+            }
+          }}
+          connectorId={csvImportSource.id}
+          workspaceId={workspaceId}
+        />
+      )}
+    </>
+  );
+};
+
+const FeedbackRecordRow = ({
+  record,
+  workspaceId,
+  locale,
+  t,
+  onClick,
+}: {
+  record: FeedbackRecordData;
+  workspaceId: string;
+  locale: string;
+  t: TFunction;
+  onClick: () => void;
+}) => {
+  const value = formatValue(record, t, locale);
+  const isLongValue = value.length > 60;
+  const isFormbricksSurveySource =
+    (record.source_type === "formbricks" || record.source_type === "formbricks_survey") && !!record.source_id;
+  const surveySummaryHref = `/workspaces/${workspaceId}/surveys/${record.source_id}/summary`;
+
+  return (
+    <tr
+      className="cursor-pointer text-sm text-slate-700 transition-colors hover:bg-slate-50"
+      onClick={onClick}>
+      <td className="whitespace-nowrap px-4 py-3 text-slate-500">
+        {formatDateTimeForDisplay(new Date(record.collected_at), locale)}
+      </td>
+      <td className="whitespace-nowrap px-4 py-3">
+        <Badge text={formatSourceType(record.source_type, t)} type="gray" size="tiny" />
+      </td>
+      <td className="max-w-[150px] truncate px-4 py-3" title={record.source_name ?? undefined}>
+        {isFormbricksSurveySource ? (
+          <Link
+            href={surveySummaryHref}
+            className="text-slate-700 underline underline-offset-2 hover:text-slate-900"
+            onClick={(event) => event.stopPropagation()}>
+            {record.source_name ?? "—"}
+          </Link>
+        ) : (
+          <span>{record.source_name ?? "—"}</span>
+        )}
+      </td>
+      <td className="max-w-[200px] truncate px-4 py-3" title={record.field_label ?? undefined}>
+        {record.field_label ?? record.field_id}
+      </td>
+      <td className="whitespace-nowrap px-4 py-3">
+        <span className="inline-flex items-center gap-1 text-slate-600">
+          {FIELD_TYPE_ICONS[record.field_type] ?? <HashIcon className="h-3.5 w-3.5" />}
+          {record.field_type}
+        </span>
+      </td>
+      <td className="max-w-[250px] px-4 py-3">
+        {isLongValue ? (
+          <TooltipProvider>
+            <Tooltip>
+              <TooltipTrigger asChild>
+                <span className="cursor-default truncate">{truncate(value, 60)}</span>
+              </TooltipTrigger>
+              <TooltipContent side="top" className="max-w-sm whitespace-pre-wrap">
+                {value}
+              </TooltipContent>
+            </Tooltip>
+          </TooltipProvider>
+        ) : (
+          <span>{value}</span>
+        )}
+      </td>
+      <td className="max-w-[120px] truncate px-4 py-3 text-slate-500" title={record.user_identifier}>
+        {record.user_identifier ?? "—"}
+      </td>
+    </tr>
+  );
+};

apps/web/app/(app)/workspaces/[workspaceId]/unify/feedback-records/lib/types.ts

@@ -0,0 +1,57 @@
+import { z } from "zod";
+
+export const FIELD_TYPE_OPTIONS = [
+  "text",
+  "categorical",
+  "nps",
+  "csat",
+  "ces",
+  "rating",
+  "number",
+  "boolean",
+  "date",
+] as const;
+
+export const SOURCE_TYPE_PRESET_OPTIONS = [
+  "survey",
+  "review",
+  "feedback_form",
+  "support",
+  "social",
+  "interview",
+  "usability_test",
+  "nps_campaign",
+] as const;
+
+export const SOURCE_TYPE_CUSTOM_VALUE = "__custom__";
+
+const ZMetadataEntry = z.object({
+  key: z.string().trim().min(1),
+  value: z.string(),
+});
+
+export const ZFeedbackRecordFormValues = z.object({
+  id: z.string().optional(),
+  tenant_id: z.string().min(1),
+  submission_id: z.string().min(1),
+  collected_at: z.string().min(1),
+  created_at: z.string().optional(),
+  updated_at: z.string().optional(),
+  source_type: z.string().min(1),
+  source_id: z.string().optional(),
+  source_name: z.string().optional(),
+  field_id: z.string().min(1),
+  field_label: z.string().optional(),
+  field_type: z.enum(FIELD_TYPE_OPTIONS),
+  field_group_id: z.string().optional(),
+  field_group_label: z.string().optional(),
+  value_text: z.string().optional(),
+  value_number: z.string().optional(),
+  value_boolean: z.boolean().optional(),
+  value_date: z.string().optional(),
+  language: z.string().optional(),
+  user_identifier: z.string().optional(),
+  metadataEntries: z.array(ZMetadataEntry),
+});
+
+export type TFeedbackRecordFormValues = z.infer<typeof ZFeedbackRecordFormValues>;

apps/web/app/(app)/workspaces/[workspaceId]/unify/feedback-records/lib/utils.test.ts

@@ -0,0 +1,169 @@
+import { describe, expect, test, vi } from "vitest";
+import type { FeedbackRecordData } from "@/modules/hub/types";
+import {
+  formatSourceType,
+  getCreateDefaults,
+  getReadOnlyMetadataEntries,
+  getValueFieldByType,
+  isPresetSourceType,
+  mapRecordToValues,
+  parseNumberValue,
+  toISOOrUndefined,
+  toLocalDateTimeInput,
+} from "./utils";
+
+vi.mock("uuid", () => ({ v7: () => "mock-uuid-v7" }));
+
+const makeRecord = (overrides: Partial<FeedbackRecordData> = {}): FeedbackRecordData => ({
+  id: "rec-1",
+  tenant_id: "tenant-1",
+  submission_id: "sub-1",
+  collected_at: "2026-03-15T12:00:00.000Z",
+  created_at: "2026-03-15T12:00:00.000Z",
+  updated_at: "2026-03-15T12:00:00.000Z",
+  source_type: "survey",
+  field_id: "f1",
+  field_type: "text",
+  ...overrides,
+});
+
+describe("getValueFieldByType", () => {
+  test.each([
+    ["boolean", "value_boolean"],
+    ["date", "value_date"],
+    ["nps", "value_number"],
+    ["csat", "value_number"],
+    ["ces", "value_number"],
+    ["rating", "value_number"],
+    ["number", "value_number"],
+    ["text", "value_text"],
+    ["categorical", "value_text"],
+  ] as const)("returns %s → %s", (input, expected) => {
+    expect(getValueFieldByType(input)).toBe(expected);
+  });
+});
+
+describe("toLocalDateTimeInput", () => {
+  test("formats valid ISO date", () => {
+    const result = toLocalDateTimeInput("2026-03-15T14:30:00.000Z");
+    expect(result).toMatch(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}$/);
+  });
+
+  test("returns empty string for invalid date", () => {
+    expect(toLocalDateTimeInput("not-a-date")).toBe("");
+  });
+});
+
+describe("toISOOrUndefined", () => {
+  test("returns ISO string for valid input", () => {
+    expect(toISOOrUndefined("2026-03-15T14:30")).toMatch(/2026-03-15/);
+  });
+
+  test("returns undefined for empty string", () => {
+    expect(toISOOrUndefined("")).toBeUndefined();
+  });
+
+  test("returns undefined for undefined", () => {
+    expect(toISOOrUndefined(undefined)).toBeUndefined();
+  });
+
+  test("returns undefined for invalid date", () => {
+    expect(toISOOrUndefined("not-a-date")).toBeUndefined();
+  });
+});
+
+describe("getCreateDefaults", () => {
+  test("uses first directory as tenant_id", () => {
+    const dirs = [{ id: "dir-1", name: "Dir 1" }];
+    const result = getCreateDefaults(dirs);
+    expect(result.tenant_id).toBe("dir-1");
+    expect(result.submission_id).toBe("mock-uuid-v7");
+    expect(result.field_type).toBe("text");
+    expect(result.metadataEntries).toEqual([]);
+  });
+
+  test("handles empty directories", () => {
+    const result = getCreateDefaults([]);
+    expect(result.tenant_id).toBe("");
+  });
+});
+
+describe("mapRecordToValues", () => {
+  test("maps a full record", () => {
+    const record = makeRecord({
+      value_text: "hello",
+      value_number: 42,
+      source_id: "s1",
+      source_name: "Survey",
+      metadata: { tag: "vip", nested: { a: 1 } },
+    });
+    const result = mapRecordToValues(record);
+    expect(result.id).toBe("rec-1");
+    expect(result.value_text).toBe("hello");
+    expect(result.value_number).toBe("42");
+    expect(result.source_id).toBe("s1");
+    expect(result.metadataEntries).toEqual([{ key: "tag", value: "vip" }]);
+  });
+
+  test("handles nullish optional fields", () => {
+    const record = makeRecord({ value_number: undefined, source_id: undefined });
+    const result = mapRecordToValues(record);
+    expect(result.value_number).toBe("");
+    expect(result.source_id).toBe("");
+  });
+});
+
+describe("getReadOnlyMetadataEntries", () => {
+  test("returns only non-string metadata values", () => {
+    const record = makeRecord({ metadata: { tag: "vip", count: 5, nested: { a: 1 } } });
+    const result = getReadOnlyMetadataEntries(record);
+    expect(result).toEqual([
+      { key: "count", value: "5" },
+      { key: "nested", value: '{"a":1}' },
+    ]);
+  });
+
+  test("returns empty array when no metadata", () => {
+    expect(getReadOnlyMetadataEntries(makeRecord())).toEqual([]);
+  });
+});
+
+describe("parseNumberValue", () => {
+  test.each([
+    ["42", 42],
+    ["3.14", 3.14],
+    ["-1", -1],
+    ["", null],
+    ["  ", null],
+    ["abc", null],
+    ["Infinity", null],
+  ])("parseNumberValue(%s) → %s", (input, expected) => {
+    expect(parseNumberValue(input)).toBe(expected);
+  });
+});
+
+describe("isPresetSourceType", () => {
+  test("returns true for preset values", () => {
+    expect(isPresetSourceType("survey")).toBe(true);
+    expect(isPresetSourceType("nps_campaign")).toBe(true);
+  });
+
+  test("returns false for custom values", () => {
+    expect(isPresetSourceType("custom_type")).toBe(false);
+    expect(isPresetSourceType("")).toBe(false);
+  });
+});
+
+describe("formatSourceType", () => {
+  const t = ((key: string) => key) as any;
+
+  test("maps known source types", () => {
+    expect(formatSourceType("formbricks", t)).toBe("workspace.unify.formbricks_surveys");
+    expect(formatSourceType("formbricks_survey", t)).toBe("workspace.unify.formbricks_surveys");
+    expect(formatSourceType("csv", t)).toBe("workspace.unify.csv_import");
+  });
+
+  test("returns raw value for unknown types", () => {
+    expect(formatSourceType("custom", t)).toBe("custom");
+  });
+});

apps/web/app/(app)/workspaces/[workspaceId]/unify/feedback-records/lib/utils.ts

@@ -0,0 +1,143 @@
+import { TFunction } from "i18next";
+import { v7 as uuidv7 } from "uuid";
+import type { FeedbackRecordData } from "@/modules/hub/types";
+import { SOURCE_TYPE_PRESET_OPTIONS, type TFeedbackRecordFormValues } from "./types";
+
+export const getValueFieldByType = (
+  fieldType: TFeedbackRecordFormValues["field_type"]
+): "value_text" | "value_number" | "value_boolean" | "value_date" => {
+  switch (fieldType) {
+    case "boolean":
+      return "value_boolean";
+    case "date":
+      return "value_date";
+    case "nps":
+    case "csat":
+    case "ces":
+    case "rating":
+    case "number":
+      return "value_number";
+    default:
+      return "value_text";
+  }
+};
+
+export const toLocalDateTimeInput = (isoDate: string): string => {
+  const date = new Date(isoDate);
+  if (!Number.isFinite(date.getTime())) {
+    return "";
+  }
+
+  const year = date.getFullYear();
+  const month = String(date.getMonth() + 1).padStart(2, "0");
+  const day = String(date.getDate()).padStart(2, "0");
+  const hours = String(date.getHours()).padStart(2, "0");
+  const minutes = String(date.getMinutes()).padStart(2, "0");
+
+  return `${year}-${month}-${day}T${hours}:${minutes}`;
+};
+
+export const toISOOrUndefined = (dateTimeValue: string | undefined): string | undefined => {
+  if (!dateTimeValue) {
+    return undefined;
+  }
+
+  const parsed = new Date(dateTimeValue);
+  if (!Number.isFinite(parsed.getTime())) {
+    return undefined;
+  }
+
+  return parsed.toISOString();
+};
+
+export const getCreateDefaults = (directories: { id: string; name: string }[]): TFeedbackRecordFormValues => {
+  const now = new Date();
+  const defaultDirectoryId = directories[0]?.id ?? "";
+
+  return {
+    id: "",
+    tenant_id: defaultDirectoryId,
+    submission_id: uuidv7(),
+    collected_at: toLocalDateTimeInput(now.toISOString()),
+    created_at: "",
+    updated_at: "",
+    source_type: "survey",
+    source_id: "",
+    source_name: "",
+    field_id: "",
+    field_label: "",
+    field_type: "text",
+    field_group_id: "",
+    field_group_label: "",
+    value_text: "",
+    value_number: "",
+    value_boolean: undefined,
+    value_date: "",
+    language: "",
+    user_identifier: "",
+    metadataEntries: [],
+  };
+};
+
+export const mapRecordToValues = (record: FeedbackRecordData): TFeedbackRecordFormValues => {
+  const metadataEntries = Object.entries(record.metadata ?? {})
+    .filter(([, value]) => typeof value === "string")
+    .map(([key, value]) => ({
+      key,
+      value: value as string,
+    }));
+
+  return {
+    id: record.id,
+    tenant_id: record.tenant_id,
+    submission_id: record.submission_id,
+    collected_at: toLocalDateTimeInput(record.collected_at),
+    created_at: record.created_at ? toLocalDateTimeInput(record.created_at) : "",
+    updated_at: record.updated_at ? toLocalDateTimeInput(record.updated_at) : "",
+    source_type: record.source_type,
+    source_id: record.source_id ?? "",
+    source_name: record.source_name ?? "",
+    field_id: record.field_id,
+    field_label: record.field_label ?? "",
+    field_type: record.field_type,
+    field_group_id: record.field_group_id ?? "",
+    field_group_label: record.field_group_label ?? "",
+    value_text: record.value_text ?? "",
+    value_number: record.value_number == null ? "" : String(record.value_number),
+    value_boolean: record.value_boolean,
+    value_date: record.value_date ? toLocalDateTimeInput(record.value_date) : "",
+    language: record.language ?? "",
+    user_identifier: record.user_identifier ?? "",
+    metadataEntries,
+  };
+};
+
+export const getReadOnlyMetadataEntries = (record: FeedbackRecordData): { key: string; value: string }[] => {
+  return Object.entries(record.metadata ?? {})
+    .filter(([, value]) => typeof value !== "string")
+    .map(([key, value]) => ({
+      key,
+      value: JSON.stringify(value),
+    }));
+};
+
+export const parseNumberValue = (value: string): number | null => {
+  if (value.trim() === "") return null;
+  const parsed = Number(value);
+  return Number.isFinite(parsed) ? parsed : null;
+};
+
+export const isPresetSourceType = (value: string): value is (typeof SOURCE_TYPE_PRESET_OPTIONS)[number] =>
+  (SOURCE_TYPE_PRESET_OPTIONS as readonly string[]).includes(value);
+
+export const formatSourceType = (sourceType: string, t: TFunction): string => {
+  switch (sourceType) {
+    case "formbricks":
+    case "formbricks_survey":
+      return t("workspace.unify.formbricks_surveys");
+    case "csv":
+      return t("workspace.unify.csv_import");
+    default:
+      return sourceType;
+  }
+};

apps/web/app/(app)/workspaces/[workspaceId]/unify/feedback-records/page.tsx

@@ -0,0 +1,61 @@
+import { notFound } from "next/navigation";
+import { getConnectorsWithMappings } from "@/lib/connector/service";
+import { getTranslate } from "@/lingodotdev/server";
+import { getFeedbackRecordDirectoriesByWorkspaceId } from "@/modules/ee/feedback-record-directory/lib/feedback-record-directory";
+import { listFeedbackRecords } from "@/modules/hub/service";
+import { getWorkspaceAuth } from "@/modules/workspaces/lib/utils";
+import { FeedbackRecordsPageClient } from "./components/feedback-records-page-client";
+
+const INITIAL_PAGE_SIZE = 50;
+
+export default async function UnifyFeedbackRecordsPage(
+  props: Readonly<{ params: Promise<{ workspaceId: string }> }>
+) {
+  const t = await getTranslate();
+  const params = await props.params;
+
+  const { isOwner, isManager, hasReadAccess, hasReadWriteAccess, hasManageAccess, session } =
+    await getWorkspaceAuth(params.workspaceId);
+
+  if (!session) {
+    throw new Error(t("common.session_not_found"));
+  }
+
+  const hasAccess = isOwner || isManager || hasReadAccess || hasReadWriteAccess || hasManageAccess;
+  const canWrite = isOwner || isManager || hasReadWriteAccess || hasManageAccess;
+  if (!hasAccess) {
+    return notFound();
+  }
+
+  const [frds, connectors] = await Promise.all([
+    getFeedbackRecordDirectoriesByWorkspaceId(params.workspaceId),
+    getConnectorsWithMappings(params.workspaceId),
+  ]);
+
+  const results = await Promise.all(
+    frds.map((frd) => listFeedbackRecords({ tenant_id: frd.id, limit: INITIAL_PAGE_SIZE }))
+  );
+
+  // Don't crash if Hub is unreachable — show empty state
+  const successfulResults = results.filter((r) => !r.error);
+
+  const merged = successfulResults
+    .flatMap((r) => r.data?.data ?? [])
+    .toSorted((a, b) => (a.collected_at < b.collected_at ? 1 : -1))
+    .slice(0, INITIAL_PAGE_SIZE);
+
+  const frdMap = Object.fromEntries(frds.map((f) => [f.id, f.name]));
+  const csvSources = connectors
+    .filter((connector) => connector.type === "csv")
+    .map((connector) => ({ id: connector.id, name: connector.name }));
+
+  return (
+    <FeedbackRecordsPageClient
+      workspaceId={params.workspaceId}
+      initialRecords={merged}
+      frdMap={frdMap}
+      csvSources={csvSources}
+      canWrite={canWrite}
+    />
+  );
+}

apps/web/app/(app)/workspaces/[workspaceId]/unify/page.tsx

@@ -0,0 +1,6 @@
+import { redirect } from "next/navigation";
+
+export default async function UnifyPage(props: { params: Promise<{ workspaceId: string }> }) {
+  const params = await props.params;
+  redirect(`/workspaces/${params.workspaceId}/unify/feedback-records`);
+}

apps/web/app/(app)/workspaces/[workspaceId]/unify/sources/actions.ts

@@ -0,0 +1,38 @@
+"use server";
+
+import { z } from "zod";
+import { ZId } from "@formbricks/types/common";
+import { getSurveys } from "@/lib/survey/service";
+import { authenticatedActionClient } from "@/lib/utils/action-client";
+import { checkAuthorizationUpdated } from "@/lib/utils/action-client/action-client-middleware";
+import { getOrganizationIdFromWorkspaceId } from "@/lib/utils/helper";
+import { transformToUnifySurvey } from "./lib";
+import { TUnifySurvey } from "./types";
+
+const ZGetSurveysForUnifyAction = z.object({
+  workspaceId: ZId,
+});
+
+export const getSurveysForUnifyAction = authenticatedActionClient
+  .schema(ZGetSurveysForUnifyAction)
+  .action(async ({ ctx, parsedInput }): Promise<TUnifySurvey[]> => {
+    const organizationId = await getOrganizationIdFromWorkspaceId(parsedInput.workspaceId);
+    await checkAuthorizationUpdated({
+      userId: ctx.user.id,
+      organizationId,
+      access: [
+        {
+          type: "organization",
+          roles: ["owner", "manager", "member"],
+        },
+        {
+          type: "workspaceTeam",
+          minPermission: "read",
+          workspaceId: parsedInput.workspaceId,
+        },
+      ],
+    });
+
+    const surveys = await getSurveys(parsedInput.workspaceId);
+    return surveys.map((survey) => transformToUnifySurvey(survey));
+  });

apps/web/app/(app)/workspaces/[workspaceId]/unify/sources/components/connector-display.tsx

@@ -0,0 +1,26 @@
+"use client";
+
+import { FileSpreadsheetIcon, FormIcon } from "lucide-react";
+import { TConnectorType } from "@formbricks/types/connector";
+
+export const getConnectorIcon = (type: TConnectorType, className: string) => {
+  switch (type) {
+    case "formbricks_survey":
+      return <FormIcon className={className} />;
+    case "csv":
+      return <FileSpreadsheetIcon className={className} />;
+    default:
+      return <FormIcon className={className} />;
+  }
+};
+
+export const getConnectorTypeLabelKey = (type: TConnectorType): string => {
+  switch (type) {
+    case "formbricks_survey":
+      return "workspace.unify.formbricks_surveys";
+    case "csv":
+      return "workspace.unify.csv_import";
+    default:
+      return type;
+  }
+};

apps/web/app/(app)/workspaces/[workspaceId]/unify/sources/components/connector-form-utils.ts

@@ -0,0 +1,21 @@
+import { FEEDBACK_RECORD_FIELDS, TFieldMapping } from "../types";
+
+export const isConnectorNameValid = (name: string): boolean => name.trim().length > 0;
+
+export const areAllRequiredFieldsMapped = (mappings: TFieldMapping[]): boolean => {
+  const requiredFieldIds = new Set(
+    FEEDBACK_RECORD_FIELDS.filter((field) => field.required).map((field) => field.id)
+  );
+
+  for (const mapping of mappings) {
+    if (!requiredFieldIds.has(mapping.targetFieldId)) {
+      continue;
+    }
+
+    if (mapping.sourceFieldId || mapping.staticValue) {
+      requiredFieldIds.delete(mapping.targetFieldId);
+    }
+  }
+
+  return requiredFieldIds.size === 0;
+};

apps/web/app/(app)/workspaces/[workspaceId]/unify/sources/components/connector-row-dropdown.tsx

@@ -0,0 +1,184 @@
+"use client";
+
+import {
+  CopyIcon,
+  EyeIcon,
+  FileSpreadsheetIcon,
+  MoreVertical,
+  PauseIcon,
+  PlayIcon,
+  SquarePenIcon,
+  TrashIcon,
+} from "lucide-react";
+import { useRouter } from "next/navigation";
+import { useState } from "react";
+import { useTranslation } from "react-i18next";
+import { TConnectorWithMappings } from "@formbricks/types/connector";
+import { DeleteDialog } from "@/modules/ui/components/delete-dialog";
+import {
+  DropdownMenu,
+  DropdownMenuContent,
+  DropdownMenuGroup,
+  DropdownMenuItem,
+  DropdownMenuSeparator,
+  DropdownMenuTrigger,
+} from "@/modules/ui/components/dropdown-menu";
+
+interface ConnectorRowDropdownProps {
+  connector: TConnectorWithMappings;
+  onEdit: () => void;
+  onCsvImport?: () => void;
+  onDuplicate: () => Promise<void>;
+  onToggleStatus: () => Promise<void>;
+  onDelete: () => Promise<void>;
+}
+
+export function ConnectorRowDropdown({
+  connector,
+  onEdit,
+  onCsvImport,
+  onDuplicate,
+  onToggleStatus,
+  onDelete,
+}: ConnectorRowDropdownProps) {
+  const router = useRouter();
+  const { t } = useTranslation();
+  const [isDeleteDialogOpen, setIsDeleteDialogOpen] = useState(false);
+  const [isDropDownOpen, setIsDropDownOpen] = useState(false);
+  const [isDeleting, setIsDeleting] = useState(false);
+
+  const isActive = connector.status === "active";
+  const linkedSurveyId =
+    connector.type === "formbricks_survey" ? connector.formbricksMappings[0]?.surveyId : undefined;
+
+  const handleDelete = async () => {
+    setIsDeleting(true);
+    try {
+      await onDelete();
+    } finally {
+      setIsDeleting(false);
+      setIsDeleteDialogOpen(false);
+    }
+  };
+
+  return (
+    <div // eslint-disable-next-line jsx-a11y/no-static-element-interactions
+      onClick={(e) => e.stopPropagation()}
+      onKeyDown={(e) => e.stopPropagation()}
+      data-testid="connector-row-dropdown">
+      <DropdownMenu open={isDropDownOpen} onOpenChange={setIsDropDownOpen}>
+        <DropdownMenuTrigger className="z-10" asChild>
+          <div className="cursor-pointer rounded-lg border bg-white p-2 hover:bg-slate-50">
+            <span className="sr-only">{t("workspace.surveys.open_options")}</span>
+            <MoreVertical className="h-4 w-4" aria-hidden="true" />
+          </div>
+        </DropdownMenuTrigger>
+        <DropdownMenuContent className="inline-block w-auto min-w-max">
+          <DropdownMenuGroup>
+            {connector.type === "csv" && onCsvImport && (
+              <>
+                <DropdownMenuItem>
+                  <button
+                    type="button"
+                    className="flex w-full items-center"
+                    onClick={(e) => {
+                      e.preventDefault();
+                      setIsDropDownOpen(false);
+                      onCsvImport();
+                    }}>
+                    <FileSpreadsheetIcon className="mr-2 h-4 w-4" />
+                    {t("workspace.unify.import_csv_data")}
+                  </button>
+                </DropdownMenuItem>
+                <DropdownMenuSeparator />
+              </>
+            )}
+
+            {linkedSurveyId && (
+              <>
+                <DropdownMenuItem>
+                  <button
+                    type="button"
+                    className="flex w-full items-center"
+                    onClick={(e) => {
+                      e.preventDefault();
+                      setIsDropDownOpen(false);
+                      router.push(`/workspaces/${connector.workspaceId}/surveys/${linkedSurveyId}/summary`);
+                    }}>
+                    <EyeIcon className="mr-2 h-4 w-4" />
+                    {`${t("common.view")} ${t("common.survey")}`}
+                  </button>
+                </DropdownMenuItem>
+                <DropdownMenuSeparator />
+              </>
+            )}
+
+            <DropdownMenuItem>
+              <button
+                type="button"
+                className="flex w-full items-center"
+                onClick={(e) => {
+                  e.preventDefault();
+                  setIsDropDownOpen(false);
+                  onEdit();
+                }}>
+                <SquarePenIcon className="mr-2 h-4 w-4" />
+                {t("common.edit")}
+              </button>
+            </DropdownMenuItem>
+
+            <DropdownMenuItem>
+              <button
+                type="button"
+                className="flex w-full items-center"
+                onClick={async (e) => {
+                  e.preventDefault();
+                  setIsDropDownOpen(false);
+                  await onDuplicate();
+                }}>
+                <CopyIcon className="mr-2 h-4 w-4" />
+                {t("common.duplicate")}
+              </button>
+            </DropdownMenuItem>
+
+            <DropdownMenuItem>
+              <button
+                type="button"
+                className="flex w-full items-center"
+                onClick={async (e) => {
+                  e.preventDefault();
+                  setIsDropDownOpen(false);
+                  await onToggleStatus();
+                }}>
+                {isActive ? <PauseIcon className="mr-2 h-4 w-4" /> : <PlayIcon className="mr-2 h-4 w-4" />}
+                {isActive ? t("common.disable") : t("common.enable")}
+              </button>
+            </DropdownMenuItem>
+
+            <DropdownMenuItem>
+              <button
+                type="button"
+                className="flex w-full items-center"
+                onClick={(e) => {
+                  e.preventDefault();
+                  setIsDropDownOpen(false);
+                  setIsDeleteDialogOpen(true);
+                }}>
+                <TrashIcon className="mr-2 h-4 w-4" />
+                {t("common.delete")}
+              </button>
+            </DropdownMenuItem>
+          </DropdownMenuGroup>
+        </DropdownMenuContent>
+      </DropdownMenu>
+
+      <DeleteDialog
+        deleteWhat={t("workspace.unify.source")}
+        open={isDeleteDialogOpen}
+        setOpen={setIsDeleteDialogOpen}
+        onDelete={handleDelete}
+        isDeleting={isDeleting}
+      />
+    </div>
+  );
+}

apps/web/app/(app)/workspaces/[workspaceId]/unify/sources/components/connector-type-selector.tsx

@@ -0,0 +1,82 @@
+"use client";
+
+import Link from "next/link";
+import { useTranslation } from "react-i18next";
+import { Alert, AlertButton, AlertTitle } from "@/modules/ui/components/alert";
+import { Badge } from "@/modules/ui/components/badge";
+import { TConnectorOptionId, getConnectorOptions } from "../utils";
+
+interface ConnectorTypeSelectorProps {
+  selectedType: TConnectorOptionId | null;
+  onSelectType: (type: TConnectorOptionId) => void;
+}
+
+const getOptionClassName = (
+  selectedType: TConnectorOptionId | null,
+  optionId: TConnectorOptionId,
+  disabled: boolean
+): string => {
+  if (selectedType === optionId) {
+    return "border-brand-dark bg-slate-50";
+  }
+
+  if (disabled) {
+    return "cursor-not-allowed border-slate-200 bg-slate-50 opacity-60";
+  }
+
+  return "border-slate-200 hover:border-slate-300 hover:bg-slate-50";
+};
+
+export function ConnectorTypeSelector({ selectedType, onSelectType }: Readonly<ConnectorTypeSelectorProps>) {
+  const { t } = useTranslation();
+  const connectorOptions = getConnectorOptions(t);
+
+  return (
+    <div className="space-y-3">
+      <div className="space-y-2">
+        {connectorOptions.map((option) => (
+          <button
+            key={option.id}
+            type="button"
+            disabled={option.disabled}
+            onClick={() => onSelectType(option.id)}
+            className={`flex w-full items-center justify-between rounded-lg border p-3.5 text-left text-sm transition-colors ${getOptionClassName(
+              selectedType,
+              option.id,
+              option.disabled
+            )}`}>
+            <div className="flex-1">
+              <div className="flex items-center gap-2">
+                <span className="font-medium leading-5 text-slate-900">{option.name}</span>
+                {option.badge && <Badge text={option.badge.text} type={option.badge.type} size="tiny" />}
+              </div>
+              <p className="mt-0.5 text-xs text-slate-500">{option.description}</p>
+            </div>
+            <div
+              className={`ml-3 h-4 w-4 rounded-full border-2 ${
+                selectedType === option.id ? "border-brand-dark bg-brand-dark" : "border-slate-300"
+              }`}>
+              {selectedType === option.id && (
+                <div className="flex h-full w-full items-center justify-center">
+                  <div className="h-1.5 w-1.5 rounded-full bg-white" />
+                </div>
+              )}
+            </div>
+          </button>
+        ))}
+      </div>
+      <Alert variant="outbound" size="small">
+        <AlertTitle>{t("workspace.unify.missing_feedback_source_title")}</AlertTitle>
+        <AlertButton asChild>
+          <Link
+            href="https://app.formbricks.com/s/cmob8tub9s2ndu5010ei4it0g"
+            target="_blank"
+            rel="noopener noreferrer"
+            className="text-slate-900 hover:underline">
+            {t("workspace.unify.request_feedback_source")}
+          </Link>
+        </AlertButton>
+      </Alert>
+    </div>
+  );
+}

apps/web/app/(app)/workspaces/[workspaceId]/unify/sources/components/connectors-page-client.tsx

@@ -0,0 +1,238 @@
+"use client";
+
+import Link from "next/link";
+import { useRouter } from "next/navigation";
+import { useState } from "react";
+import { toast } from "react-hot-toast";
+import { useTranslation } from "react-i18next";
+import { TConnectorType, TConnectorWithMappings, THubTargetField } from "@formbricks/types/connector";
+import { SettingsCard } from "@/app/(app)/workspaces/[workspaceId]/settings/components/SettingsCard";
+import {
+  createConnectorWithMappingsAction,
+  deleteConnectorAction,
+  duplicateConnectorAction,
+  updateConnectorWithMappingsAction,
+} from "@/lib/connector/actions";
+import { getFormattedErrorMessage } from "@/lib/utils/helper";
+import { Alert, AlertButton, AlertDescription } from "@/modules/ui/components/alert";
+import { PageContentWrapper } from "@/modules/ui/components/page-content-wrapper";
+import { PageHeader } from "@/modules/ui/components/page-header";
+import { WorkspaceConfigNavigation } from "@/modules/workspaces/settings/components/workspace-config-navigation";
+import { TFieldMapping, TUnifySurvey } from "../types";
+import { ConnectorsTable } from "./connectors-table";
+import { CreateConnectorModal } from "./create-connector-modal";
+import { CsvImportModal } from "./csv-import-modal";
+import { EditConnectorModal } from "./edit-connector-modal";
+
+interface ConnectorsSectionProps {
+  workspaceId: string;
+  initialConnectors: TConnectorWithMappings[];
+  initialSurveys: TUnifySurvey[];
+  directories: { id: string; name: string }[];
+}
+
+export function ConnectorsSection({
+  workspaceId,
+  initialConnectors,
+  initialSurveys,
+  directories,
+}: Readonly<ConnectorsSectionProps>) {
+  const { t } = useTranslation();
+  const router = useRouter();
+  const [isCreateModalOpen, setIsCreateModalOpen] = useState(false);
+  const [editingConnector, setEditingConnector] = useState<TConnectorWithMappings | null>(null);
+  const [csvImportConnector, setCsvImportConnector] = useState<TConnectorWithMappings | null>(null);
+  const directoryNames = directories.map((directory) => directory.name).join(", ");
+  const feedbackDirectoryAccessText =
+    directories.length === 1
+      ? t("workspace.unify.feedback_sources_directory_access_single", {
+          directoryNames,
+        })
+      : t("workspace.unify.feedback_sources_directory_access_multiple", {
+          directoryNames,
+        });
+
+  const handleCreateConnector = async (data: {
+    name: string;
+    type: TConnectorType;
+    feedbackRecordDirectoryId: string;
+    surveyMappings?: { surveyId: string; elementIds: string[] }[];
+    fieldMappings?: TFieldMapping[];
+  }): Promise<string | undefined> => {
+    const result = await createConnectorWithMappingsAction({
+      workspaceId: workspaceId,
+      connectorInput: {
+        name: data.name,
+        type: data.type,
+        feedbackRecordDirectoryId: data.feedbackRecordDirectoryId,
+      },
+      formbricksMappings:
+        data.type === "formbricks_survey" && data.surveyMappings?.length ? data.surveyMappings : undefined,
+      fieldMappings:
+        data.type !== "formbricks_survey" && data.fieldMappings?.length
+          ? data.fieldMappings.map((m) => ({
+              sourceFieldId: m.sourceFieldId || "",
+              targetFieldId: m.targetFieldId as THubTargetField,
+              staticValue: m.staticValue,
+            }))
+          : undefined,
+    });
+
+    if (!result?.data) {
+      toast.error(getFormattedErrorMessage(result));
+      return undefined;
+    }
+
+    toast.success(t("workspace.unify.connector_created_successfully"));
+    router.refresh();
+    return result.data.id;
+  };
+
+  const handleUpdateConnector = async (data: {
+    connectorId: string;
+    workspaceId: string;
+    name: string;
+    surveyMappings?: { surveyId: string; elementIds: string[] }[];
+    fieldMappings?: TFieldMapping[];
+  }) => {
+    const result = await updateConnectorWithMappingsAction({
+      connectorId: data.connectorId,
+      workspaceId: workspaceId,
+      connectorInput: {
+        name: data.name,
+      },
+      formbricksMappings: data.surveyMappings?.length ? data.surveyMappings : undefined,
+      fieldMappings: data.fieldMappings?.length
+        ? data.fieldMappings.map((m) => ({
+            sourceFieldId: m.sourceFieldId || "",
+            targetFieldId: m.targetFieldId as THubTargetField,
+            staticValue: m.staticValue,
+          }))
+        : undefined,
+    });
+
+    if (!result?.data) {
+      toast.error(getFormattedErrorMessage(result));
+      return;
+    }
+
+    toast.success(t("workspace.unify.connector_updated_successfully"));
+    router.refresh();
+  };
+
+  const handleDeleteConnector = async (connectorId: string): Promise<void> => {
+    const result = await deleteConnectorAction({ connectorId, workspaceId: workspaceId });
+
+    if (!result?.data) {
+      toast.error(getFormattedErrorMessage(result));
+      return;
+    }
+
+    toast.success(t("workspace.unify.connector_deleted_successfully"));
+    router.refresh();
+  };
+
+  const handleDuplicateConnector = async (connector: TConnectorWithMappings): Promise<void> => {
+    const result = await duplicateConnectorAction({
+      connectorId: connector.id,
+      workspaceId: workspaceId,
+    });
+
+    if (!result?.data) {
+      toast.error(getFormattedErrorMessage(result));
+      return;
+    }
+
+    toast.success(t("workspace.unify.connector_duplicated_successfully"));
+    router.refresh();
+  };
+
+  const handleToggleStatus = async (connector: TConnectorWithMappings): Promise<void> => {
+    const newStatus = connector.status === "active" ? "paused" : "active";
+    const result = await updateConnectorWithMappingsAction({
+      connectorId: connector.id,
+      workspaceId: workspaceId,
+      connectorInput: { status: newStatus },
+    });
+
+    if (!result?.data) {
+      toast.error(getFormattedErrorMessage(result));
+      return;
+    }
+
+    toast.success(t("workspace.unify.connector_status_updated_successfully"));
+    router.refresh();
+  };
+
+  return (
+    <PageContentWrapper>
+      <PageHeader pageTitle={t("common.workspace_configuration")}>
+        <WorkspaceConfigNavigation activeId="feedback-sources" />
+      </PageHeader>
+
+      <SettingsCard
+        title={t("workspace.unify.feedback_sources")}
+        description={t("workspace.unify.feedback_sources_settings_description")}
+        buttonInfo={{
+          text: t("workspace.unify.add_source"),
+          onClick: () => setIsCreateModalOpen(true),
+          variant: "default",
+        }}>
+        <ConnectorsTable
+          connectors={initialConnectors}
+          onConnectorClick={setEditingConnector}
+          onCsvImport={setCsvImportConnector}
+          onDuplicate={handleDuplicateConnector}
+          onToggleStatus={handleToggleStatus}
+          onDelete={handleDeleteConnector}
+          isLoading={false}
+        />
+        {directories.length > 0 && (
+          <Alert size="small" className="mt-4">
+            <AlertDescription>{feedbackDirectoryAccessText}</AlertDescription>
+            <AlertButton asChild>
+              <Link href={`/workspaces/${workspaceId}/settings/feedback-record-directories`}>
+                {t("workspace.unify.manage_directories")}
+              </Link>
+            </AlertButton>
+          </Alert>
+        )}
+      </SettingsCard>
+
+      <CreateConnectorModal
+        open={isCreateModalOpen}
+        onOpenChange={setIsCreateModalOpen}
+        onCreateConnector={handleCreateConnector}
+        surveys={initialSurveys}
+        workspaceId={workspaceId}
+        directories={directories}
+        showTrigger={false}
+      />
+
+      <EditConnectorModal
+        connector={editingConnector}
+        open={editingConnector !== null}
+        onOpenChange={(open) => !open && setEditingConnector(null)}
+        onUpdateConnector={handleUpdateConnector}
+        surveys={initialSurveys}
+        onOpenCsvImport={() => {
+          if (editingConnector) {
+            setCsvImportConnector(editingConnector);
+          }
+        }}
+      />
+
+      {csvImportConnector && (
+        <CsvImportModal
+          open={csvImportConnector !== null}
+          onOpenChange={(open) => !open && setCsvImportConnector(null)}
+          connectorId={csvImportConnector.id}
+          workspaceId={csvImportConnector.workspaceId}
+          onOpenEditConnector={() => {
+            setEditingConnector(csvImportConnector);
+          }}
+        />
+      )}
+    </PageContentWrapper>
+  );
+}

apps/web/app/(app)/workspaces/[workspaceId]/unify/sources/components/connectors-table-data-row.tsx

@@ -0,0 +1,124 @@
+"use client";
+
+import { useTranslation } from "react-i18next";
+import { TConnectorStatus, TConnectorType, TConnectorWithMappings } from "@formbricks/types/connector";
+import { Badge } from "@/modules/ui/components/badge";
+import { getConnectorIcon, getConnectorTypeLabelKey } from "./connector-display";
+import { ConnectorRowDropdown } from "./connector-row-dropdown";
+
+const RELATIVE_TIME_DIVISIONS: { amount: number; unit: Intl.RelativeTimeFormatUnit }[] = [
+  { amount: 60, unit: "seconds" },
+  { amount: 60, unit: "minutes" },
+  { amount: 24, unit: "hours" },
+  { amount: 7, unit: "days" },
+  { amount: 4.345, unit: "weeks" },
+  { amount: 12, unit: "months" },
+  { amount: Number.POSITIVE_INFINITY, unit: "years" },
+];
+
+function getRelativeTime(date: Date, locale: string) {
+  const formatter = new Intl.RelativeTimeFormat(locale, { numeric: "auto" });
+  let duration = (date.getTime() - Date.now()) / 1000;
+
+  for (const division of RELATIVE_TIME_DIVISIONS) {
+    if (Math.abs(duration) < division.amount) {
+      return formatter.format(Math.round(duration), division.unit);
+    }
+    duration /= division.amount;
+  }
+
+  return formatter.format(Math.round(duration), "years");
+}
+
+interface ConnectorsTableDataRowProps {
+  connector: TConnectorWithMappings;
+  onEdit: () => void;
+  onCsvImport?: () => void;
+  onDuplicate: () => Promise<void>;
+  onToggleStatus: () => Promise<void>;
+  onDelete: () => Promise<void>;
+}
+
+const STATUS_BADGE_TYPE: Record<TConnectorStatus, "success" | "warning" | "error"> = {
+  active: "success",
+  paused: "warning",
+  error: "error",
+};
+
+export function ConnectorsTableDataRow({
+  connector,
+  onEdit,
+  onCsvImport,
+  onDuplicate,
+  onToggleStatus,
+  onDelete,
+}: Readonly<ConnectorsTableDataRowProps>) {
+  const { t, i18n } = useTranslation();
+  const handleRowClick = () => {
+    if (connector.type === "csv" && onCsvImport) {
+      onCsvImport();
+      return;
+    }
+
+    onEdit();
+  };
+
+  const getStatusLabel = (s: TConnectorStatus, connectorType: TConnectorType) => {
+    switch (s) {
+      case "active":
+        if (connectorType === "csv") {
+          return t("workspace.unify.status_ready");
+        }
+        return t("workspace.unify.status_live_sync");
+      case "paused":
+        return t("common.disabled");
+      case "error":
+        return t("workspace.unify.status_error");
+    }
+  };
+
+  return (
+    <div
+      role="button"
+      tabIndex={0}
+      className="grid h-12 min-h-12 cursor-pointer grid-cols-12 content-center p-2 text-left transition-colors ease-in-out hover:bg-slate-50"
+      onClick={handleRowClick}
+      onKeyDown={(e) => {
+        if (e.key === "Enter" || e.key === " ") {
+          handleRowClick();
+        }
+      }}>
+      <div
+        className="col-span-1 flex items-center gap-2 pl-4"
+        title={t(getConnectorTypeLabelKey(connector.type))}>
+        {getConnectorIcon(connector.type, "h-4 w-4 text-slate-500")}
+      </div>
+      <div className="col-span-5 flex items-center">
+        <span className="truncate text-sm font-medium text-slate-900">{connector.name}</span>
+      </div>
+      <div className="col-span-1 hidden items-center justify-center sm:flex">
+        <Badge
+          text={getStatusLabel(connector.status, connector.type)}
+          type={STATUS_BADGE_TYPE[connector.status]}
+          size="tiny"
+        />
+      </div>
+      <div className="col-span-2 hidden items-center justify-center text-sm text-slate-500 sm:flex">
+        {getRelativeTime(connector.updatedAt, i18n.language)}
+      </div>
+      <div className="col-span-2 hidden items-center justify-center text-sm text-slate-500 sm:flex">
+        <span className="truncate">{connector.creatorName ?? "—"}</span>
+      </div>
+      <div className="col-span-1 flex items-center justify-end pr-2">
+        <ConnectorRowDropdown
+          connector={connector}
+          onEdit={onEdit}
+          onCsvImport={onCsvImport}
+          onDuplicate={onDuplicate}
+          onToggleStatus={onToggleStatus}
+          onDelete={onDelete}
+        />
+      </div>
+    </div>
+  );
+}

apps/web/app/(app)/workspaces/[workspaceId]/unify/sources/components/connectors-table-rows-container.tsx

@@ -0,0 +1,47 @@
+import { useTranslation } from "react-i18next";
+import { TConnectorWithMappings } from "@formbricks/types/connector";
+import { ConnectorsTableDataRow } from "./connectors-table-data-row";
+
+interface ConnectorsTableRowsContainerProps {
+  connectors: TConnectorWithMappings[];
+  onConnectorClick: (connector: TConnectorWithMappings) => void;
+  onCsvImport: (connector: TConnectorWithMappings) => void;
+  onDuplicate: (connector: TConnectorWithMappings) => Promise<void>;
+  onToggleStatus: (connector: TConnectorWithMappings) => Promise<void>;
+  onDelete: (connectorId: string) => Promise<void>;
+}
+
+export const ConnectorsTableRowsContainer = ({
+  connectors,
+  onConnectorClick,
+  onCsvImport,
+  onDuplicate,
+  onToggleStatus,
+  onDelete,
+}: ConnectorsTableRowsContainerProps) => {
+  const { t } = useTranslation();
+
+  if (connectors.length === 0) {
+    return (
+      <div className="flex h-32 items-center justify-center">
+        <p className="text-sm text-slate-500">{t("workspace.unify.no_sources_connected")}</p>
+      </div>
+    );
+  }
+
+  return (
+    <div className="divide-y divide-slate-100">
+      {connectors.map((connector) => (
+        <ConnectorsTableDataRow
+          key={connector.id}
+          connector={connector}
+          onEdit={() => onConnectorClick(connector)}
+          onCsvImport={connector.type === "csv" ? () => onCsvImport(connector) : undefined}
+          onDuplicate={() => onDuplicate(connector)}
+          onToggleStatus={() => onToggleStatus(connector)}
+          onDelete={() => onDelete(connector.id)}
+        />
+      ))}
+    </div>
+  );
+};

apps/web/app/(app)/workspaces/[workspaceId]/unify/sources/components/connectors-table.tsx

@@ -0,0 +1,55 @@
+"use client";
+
+import { Loader2Icon } from "lucide-react";
+import { useTranslation } from "react-i18next";
+import { TConnectorWithMappings } from "@formbricks/types/connector";
+import { ConnectorsTableRowsContainer } from "./connectors-table-rows-container";
+
+interface ConnectorsTableProps {
+  connectors: TConnectorWithMappings[];
+  onConnectorClick: (connector: TConnectorWithMappings) => void;
+  onCsvImport: (connector: TConnectorWithMappings) => void;
+  onDuplicate: (connector: TConnectorWithMappings) => Promise<void>;
+  onToggleStatus: (connector: TConnectorWithMappings) => Promise<void>;
+  onDelete: (connectorId: string) => Promise<void>;
+  isLoading?: boolean;
+}
+
+export function ConnectorsTable({
+  connectors,
+  onConnectorClick,
+  onCsvImport,
+  onDuplicate,
+  onToggleStatus,
+  onDelete,
+  isLoading = false,
+}: Readonly<ConnectorsTableProps>) {
+  const { t } = useTranslation();
+
+  return (
+    <div className="overflow-hidden rounded-xl border border-slate-200 bg-white shadow-sm">
+      <div className="grid h-12 grid-cols-12 content-center border-b border-slate-200 text-left text-sm font-semibold text-slate-900">
+        <div className="col-span-1 pl-6">{t("common.type")}</div>
+        <div className="col-span-5">{t("common.name")}</div>
+        <div className="col-span-1 hidden text-center sm:block">{t("common.status")}</div>
+        <div className="col-span-2 hidden text-center sm:block">{t("workspace.unify.updated_at")}</div>
+        <div className="col-span-2 hidden text-center sm:block">{t("workspace.unify.created_by")}</div>
+        <div className="col-span-1" />
+      </div>
+      {isLoading ? (
+        <div className="flex h-32 items-center justify-center">
+          <Loader2Icon className="h-6 w-6 animate-spin text-slate-500" />
+        </div>
+      ) : (
+        <ConnectorsTableRowsContainer
+          connectors={connectors}
+          onConnectorClick={onConnectorClick}
+          onCsvImport={onCsvImport}
+          onDuplicate={onDuplicate}
+          onToggleStatus={onToggleStatus}
+          onDelete={onDelete}
+        />
+      )}
+    </div>
+  );
+}

apps/web/app/(app)/workspaces/[workspaceId]/unify/sources/components/create-connector-modal.tsx

@@ -0,0 +1,636 @@
+"use client";
+
+import { zodResolver } from "@hookform/resolvers/zod";
+import { Loader2Icon, PlusIcon } from "lucide-react";
+import { useRouter } from "next/navigation";
+import { useCallback, useEffect, useMemo, useState } from "react";
+import { useForm } from "react-hook-form";
+import toast from "react-hot-toast";
+import { useTranslation } from "react-i18next";
+import { z } from "zod";
+import { TConnectorType, UNSUPPORTED_CONNECTOR_ELEMENT_TYPES } from "@formbricks/types/connector";
+import {
+  getResponseCountAction,
+  importCsvDataAction,
+  importHistoricalResponsesAction,
+} from "@/lib/connector/actions";
+import { getFormattedErrorMessage } from "@/lib/utils/helper";
+import { Alert } from "@/modules/ui/components/alert";
+import { Button } from "@/modules/ui/components/button";
+import {
+  Dialog,
+  DialogContent,
+  DialogDescription,
+  DialogFooter,
+  DialogHeader,
+  DialogTitle,
+} from "@/modules/ui/components/dialog";
+import {
+  FormControl,
+  FormError,
+  FormField,
+  FormItem,
+  FormLabel,
+  FormProvider,
+} from "@/modules/ui/components/form";
+import { Input } from "@/modules/ui/components/input";
+import {
+  Select,
+  SelectContent,
+  SelectItem,
+  SelectTrigger,
+  SelectValue,
+} from "@/modules/ui/components/select";
+import { Switch } from "@/modules/ui/components/switch";
+import {
+  TCreateConnectorStep,
+  TFieldMapping,
+  TFormbricksConnectorForm,
+  TSourceField,
+  TUnifySurvey,
+  ZFormbricksConnectorForm,
+} from "../types";
+import {
+  TConnectorOptionId,
+  TEnumValidationError,
+  areAllRequiredFieldsMapped,
+  isConnectorNameValid,
+  parseCSVColumnsToFields,
+  toggleQuestionId,
+  validateEnumMappings,
+} from "../utils";
+import { ConnectorTypeSelector } from "./connector-type-selector";
+import { CsvConnectorUI } from "./csv-connector-ui";
+import { FormbricksQuestionList } from "./formbricks-question-list";
+
+interface CreateConnectorModalProps {
+  open: boolean;
+  onOpenChange: (open: boolean) => void;
+  showTrigger?: boolean;
+  onCreateConnector: (data: {
+    name: string;
+    type: TConnectorType;
+    feedbackRecordDirectoryId: string;
+    surveyMappings?: { surveyId: string; elementIds: string[] }[];
+    fieldMappings?: TFieldMapping[];
+  }) => Promise<string | undefined>;
+  surveys: TUnifySurvey[];
+  workspaceId: string;
+  directories: { id: string; name: string }[];
+}
+
+const getDialogTitle = (
+  step: TCreateConnectorStep,
+  type: TConnectorOptionId | null,
+  t: (key: string) => string
+): string => {
+  if (step === "selectType") return t("workspace.unify.add_feedback_source");
+  if (type === "formbricks_survey") return t("workspace.unify.select_survey_and_questions");
+  if (type === "csv") return t("workspace.unify.import_csv_data");
+  return t("workspace.unify.configure_mapping");
+};
+
+const getDialogDescription = (
+  step: TCreateConnectorStep,
+  type: TConnectorOptionId | null,
+  t: (key: string) => string
+): string => {
+  if (step === "selectType") return t("workspace.unify.select_source_type_description");
+  if (type === "formbricks_survey") return t("workspace.unify.select_survey_questions_description");
+  if (type === "csv") return t("workspace.unify.upload_csv_data_description");
+  return t("workspace.unify.configure_mapping");
+};
+
+const getNextStepButtonLabel = (type: TConnectorOptionId | null, t: (key: string) => string): string => {
+  if (type === "formbricks_survey") return t("workspace.unify.select_questions");
+  if (type === "csv") return t("workspace.unify.configure_import");
+  if (type === "api_ingestion") return t("workspace.unify.api_ingestion_manage_api_keys");
+  if (type === "feedback_record_mcp") return t("common.learn_more");
+  return t("workspace.unify.create_mapping");
+};
+
+const getSelectableQuestionIds = (survey: TUnifySurvey): string[] =>
+  survey.elements
+    .filter((element) => !(UNSUPPORTED_CONNECTOR_ELEMENT_TYPES as readonly string[]).includes(element.type))
+    .map((element) => element.id);
+
+export const CreateConnectorModal = ({
+  open,
+  onOpenChange,
+  showTrigger = true,
+  onCreateConnector,
+  surveys,
+  workspaceId,
+  directories,
+}: CreateConnectorModalProps) => {
+  const { t } = useTranslation();
+  const router = useRouter();
+
+  const defaultConnectorName = useMemo<Record<TConnectorType, string>>(
+    () => ({
+      formbricks_survey: t("workspace.unify.default_connector_name_formbricks"),
+      csv: t("workspace.unify.default_connector_name_csv"),
+    }),
+    [t]
+  );
+
+  const formbricksForm = useForm<TFormbricksConnectorForm>({
+    resolver: zodResolver(ZFormbricksConnectorForm),
+    defaultValues: {
+      sourceName: defaultConnectorName.formbricks_survey,
+      surveyId: "",
+      selectedQuestionIds: [],
+      importHistorical: true,
+    },
+    mode: "onChange",
+  });
+
+  const [currentStep, setCurrentStep] = useState<TCreateConnectorStep>("selectType");
+  const [selectedType, setSelectedType] = useState<TConnectorOptionId | null>(null);
+  const [mappings, setMappings] = useState<TFieldMapping[]>([]);
+  const [sourceFields, setSourceFields] = useState<TSourceField[]>([]);
+  const [csvParsedData, setCsvParsedData] = useState<Record<string, string>[]>([]);
+  const [enumValidationErrors, setEnumValidationErrors] = useState<TEnumValidationError[]>([]);
+  const [csvConnectorName, setCsvConnectorName] = useState("");
+  const [responseCountBySurvey, setResponseCountBySurvey] = useState<Record<string, number | null>>({});
+  const [isImporting, setIsImporting] = useState(false);
+  const [isCreating, setIsCreating] = useState(false);
+  const [selectedDirectoryId, setSelectedDirectoryId] = useState<string | null>(directories[0]?.id ?? null);
+
+  const formbricksValues = formbricksForm.watch();
+  const selectedSurveyId = formbricksValues.surveyId;
+  const selectedQuestionIds = formbricksValues.selectedQuestionIds ?? [];
+
+  const selectedSurvey = useMemo(
+    () => surveys.find((survey) => survey.id === selectedSurveyId) ?? null,
+    [surveys, selectedSurveyId]
+  );
+
+  const selectedSurveyResponseCount =
+    selectedSurveyId && responseCountBySurvey[selectedSurveyId] !== undefined
+      ? responseCountBySurvey[selectedSurveyId]
+      : null;
+
+  const fetchResponseCount = useCallback(
+    async (surveyId: string) => {
+      if (responseCountBySurvey[surveyId] !== undefined) return;
+      try {
+        const result = await getResponseCountAction({ surveyId, workspaceId });
+        if (result?.data !== undefined) {
+          setResponseCountBySurvey((prev) => ({ ...prev, [surveyId]: result.data ?? null }));
+        }
+      } catch {
+        setResponseCountBySurvey((prev) => ({ ...prev, [surveyId]: null }));
+      }
+    },
+    [responseCountBySurvey, workspaceId]
+  );
+
+  useEffect(() => {
+    if (selectedSurveyId && currentStep === "mapping" && selectedType === "formbricks_survey") {
+      fetchResponseCount(selectedSurveyId);
+    }
+  }, [currentStep, fetchResponseCount, selectedSurveyId, selectedType]);
+
+  useEffect(() => {
+    if (currentStep !== "mapping" || selectedType !== "formbricks_survey" || !selectedSurveyId) {
+      return;
+    }
+
+    const survey = surveys.find((item) => item.id === selectedSurveyId);
+    const supportedElementIds = survey ? getSelectableQuestionIds(survey) : [];
+
+    formbricksForm.setValue("selectedQuestionIds", supportedElementIds, {
+      shouldDirty: true,
+      shouldValidate: true,
+    });
+    formbricksForm.setValue("importHistorical", true, {
+      shouldDirty: true,
+    });
+  }, [currentStep, formbricksForm, selectedSurveyId, selectedType, surveys]);
+
+  const resetForm = () => {
+    setCurrentStep("selectType");
+    setSelectedType(null);
+    formbricksForm.reset({
+      sourceName: defaultConnectorName.formbricks_survey,
+      surveyId: "",
+      selectedQuestionIds: [],
+      importHistorical: true,
+    });
+    setMappings([]);
+    setSourceFields([]);
+    setCsvParsedData([]);
+    setEnumValidationErrors([]);
+    setResponseCountBySurvey({});
+    setCsvConnectorName("");
+    setIsImporting(false);
+    setIsCreating(false);
+    setSelectedDirectoryId(directories[0]?.id ?? null);
+  };
+
+  const handleOpenChange = (newOpen: boolean) => {
+    if (isImporting) return;
+    if (!newOpen) resetForm();
+    onOpenChange(newOpen);
+  };
+
+  const handleNextStep = () => {
+    if (currentStep !== "selectType" || !selectedType) return;
+
+    if (selectedType === "api_ingestion") {
+      handleOpenChange(false);
+      router.push(`/workspaces/${workspaceId}/settings/api-keys`);
+      return;
+    }
+
+    if (selectedType === "feedback_record_mcp") {
+      window.open("https://formbricks.com/docs", "_blank", "noopener,noreferrer");
+      return;
+    }
+
+    if (selectedType === "formbricks_survey") {
+      formbricksForm.reset({
+        sourceName: defaultConnectorName.formbricks_survey,
+        surveyId: "",
+        selectedQuestionIds: [],
+        importHistorical: true,
+      });
+    }
+
+    if (selectedType === "csv") {
+      setCsvConnectorName(defaultConnectorName.csv);
+    }
+
+    setCurrentStep("mapping");
+  };
+
+  const handleBack = () => {
+    if (currentStep === "mapping") {
+      setCurrentStep("selectType");
+      setMappings([]);
+      setSourceFields([]);
+      setEnumValidationErrors([]);
+    }
+  };
+
+  const handleHistoricalImport = async (connectorId: string, surveyId: string) => {
+    const responseCount = responseCountBySurvey[surveyId] ?? 0;
+    if (responseCount <= 0) return;
+    setIsImporting(true);
+    const importResult = await importHistoricalResponsesAction({
+      connectorId,
+      workspaceId,
+      surveyId,
+    });
+    setIsImporting(false);
+
+    if (importResult?.data) {
+      toast.success(
+        t("workspace.unify.historical_import_complete", {
+          successes: importResult.data.successes,
+          failures: importResult.data.failures,
+          skipped: importResult.data.skipped,
+        })
+      );
+    } else {
+      toast.error(getFormattedErrorMessage(importResult));
+    }
+  };
+
+  const handleCsvImport = async (connectorId: string) => {
+    setIsImporting(true);
+    const importResult = await importCsvDataAction({
+      connectorId,
+      workspaceId,
+      csvData: csvParsedData,
+    });
+    setIsImporting(false);
+
+    if (importResult?.data) {
+      toast.success(
+        t("workspace.unify.csv_import_complete", {
+          successes: importResult.data.successes,
+          failures: importResult.data.failures,
+          skipped: importResult.data.skipped,
+        })
+      );
+    } else {
+      toast.error(getFormattedErrorMessage(importResult));
+    }
+  };
+
+  const handleFormbricksQuestionToggle = (questionId: string) => {
+    const nextSelection = toggleQuestionId(formbricksForm.getValues("selectedQuestionIds"), questionId);
+    formbricksForm.setValue("selectedQuestionIds", nextSelection, {
+      shouldDirty: true,
+      shouldValidate: true,
+    });
+  };
+
+  const handleCreateFormbricksConnector = async (values: TFormbricksConnectorForm) => {
+    if (!selectedDirectoryId) return;
+    setIsCreating(true);
+
+    const connectorId = await onCreateConnector({
+      name: values.sourceName.trim(),
+      type: "formbricks_survey",
+      feedbackRecordDirectoryId: selectedDirectoryId,
+      surveyMappings: [{ surveyId: values.surveyId, elementIds: values.selectedQuestionIds }],
+    });
+
+    if (connectorId && values.importHistorical) {
+      await handleHistoricalImport(connectorId, values.surveyId);
+    }
+
+    setIsCreating(false);
+    resetForm();
+    onOpenChange(false);
+  };
+
+  const handleCreateCsvConnector = async () => {
+    if (!selectedDirectoryId || !isConnectorNameValid(csvConnectorName)) return;
+    if (csvParsedData.length > 0) {
+      const errors = validateEnumMappings(mappings, csvParsedData);
+      if (errors.length > 0) {
+        setEnumValidationErrors(errors);
+        return;
+      }
+      setEnumValidationErrors([]);
+    }
+
+    setIsCreating(true);
+
+    const connectorId = await onCreateConnector({
+      name: csvConnectorName.trim(),
+      type: "csv",
+      feedbackRecordDirectoryId: selectedDirectoryId,
+      fieldMappings: mappings.length > 0 ? mappings : undefined,
+    });
+
+    if (connectorId && csvParsedData.length > 0) {
+      await handleCsvImport(connectorId);
+    }
+
+    setIsCreating(false);
+    resetForm();
+    onOpenChange(false);
+  };
+
+  const isCsvValid = selectedType === "csv" && sourceFields.length > 0;
+  const areCsvRequiredFieldsMapped = areAllRequiredFieldsMapped(mappings);
+
+  const handleLoadSourceFields = () => {
+    if (selectedType === "csv") {
+      const fields = parseCSVColumnsToFields("timestamp,customer_id,rating,feedback_text,category");
+      setSourceFields(fields);
+    }
+  };
+
+  return (
+    <>
+      {showTrigger && (
+        <Button onClick={() => onOpenChange(true)} size="sm">
+          {t("workspace.unify.add_source")}
+          <PlusIcon className="ml-2 h-4 w-4" />
+        </Button>
+      )}
+
+      <Dialog open={open} onOpenChange={handleOpenChange}>
+        <DialogContent className="max-w-3xl">
+          {isImporting && (
+            <div className="absolute inset-0 z-50 flex items-center justify-center rounded-lg bg-white/80">
+              <div className="flex flex-col items-center gap-3">
+                <Loader2Icon className="h-8 w-8 animate-spin text-slate-500" />
+                <p className="text-sm font-medium text-slate-700">
+                  {t("workspace.unify.importing_historical_data")}
+                </p>
+              </div>
+            </div>
+          )}
+
+          <DialogHeader>
+            <DialogTitle>{getDialogTitle(currentStep, selectedType, t)}</DialogTitle>
+            <DialogDescription>{getDialogDescription(currentStep, selectedType, t)}</DialogDescription>
+          </DialogHeader>
+
+          <div className="py-4">
+            {currentStep === "selectType" && (
+              <ConnectorTypeSelector selectedType={selectedType} onSelectType={setSelectedType} />
+            )}
+
+            {currentStep === "mapping" && selectedType === "formbricks_survey" && (
+              <FormProvider {...formbricksForm}>
+                <form className="space-y-4">
+                  <FormField
+                    control={formbricksForm.control}
+                    name="sourceName"
+                    render={({ field }) => (
+                      <FormItem>
+                        <FormLabel>{t("workspace.unify.source_name")}</FormLabel>
+                        <FormControl>
+                          <Input
+                            value={field.value}
+                            onChange={field.onChange}
+                            placeholder={t("workspace.unify.enter_name_for_source")}
+                          />
+                        </FormControl>
+                        <FormError />
+                      </FormItem>
+                    )}
+                  />
+
+                  {directories.length === 0 && (
+                    <NoFeedbackRecordDirectoryAlert workspaceId={workspaceId} t={t} />
+                  )}
+
+                  <FormField
+                    control={formbricksForm.control}
+                    name="surveyId"
+                    render={({ field }) => (
+                      <FormItem>
+                        <FormLabel>{t("workspace.unify.select_survey")}</FormLabel>
+                        <FormControl>
+                          <Select value={field.value} onValueChange={field.onChange}>
+                            <SelectTrigger>
+                              <SelectValue placeholder={t("workspace.unify.select_survey")} />
+                            </SelectTrigger>
+                            <SelectContent>
+                              {surveys.map((survey) => (
+                                <SelectItem key={survey.id} value={survey.id}>
+                                  {survey.name}
+                                </SelectItem>
+                              ))}
+                            </SelectContent>
+                          </Select>
+                        </FormControl>
+                        <FormError />
+                      </FormItem>
+                    )}
+                  />
+
+                  <FormField
+                    control={formbricksForm.control}
+                    name="selectedQuestionIds"
+                    render={() => (
+                      <FormItem>
+                        <FormLabel>{t("workspace.unify.select_questions")}</FormLabel>
+                        <FormControl>
+                          <div>
+                            <FormbricksQuestionList
+                              survey={selectedSurvey}
+                              selectedQuestionIds={selectedQuestionIds}
+                              onQuestionToggle={handleFormbricksQuestionToggle}
+                            />
+                          </div>
+                        </FormControl>
+                        <FormError />
+                      </FormItem>
+                    )}
+                  />
+
+                  {selectedSurveyResponseCount !== null && selectedSurveyResponseCount > 0 && (
+                    <FormField
+                      control={formbricksForm.control}
+                      name="importHistorical"
+                      render={({ field }) => (
+                        <FormItem className="rounded-md border border-slate-200 p-3">
+                          <div className="flex items-start justify-between gap-3">
+                            <div className="space-y-1">
+                              <FormLabel>{t("workspace.unify.import_historical_responses")}</FormLabel>
+                              <p className="text-sm text-slate-500">
+                                {t("workspace.unify.import_historical_responses_description")}
+                              </p>
+                            </div>
+                            <Switch checked={field.value} onCheckedChange={field.onChange} />
+                          </div>
+                        </FormItem>
+                      )}
+                    />
+                  )}
+                </form>
+              </FormProvider>
+            )}
+
+            {currentStep === "mapping" && selectedType === "csv" && (
+              <div className="space-y-4">
+                <div className="space-y-2">
+                  <label htmlFor="connectorName" className="text-sm font-medium text-slate-700">
+                    {t("workspace.unify.source_name")}
+                  </label>
+                  <Input
+                    id="connectorName"
+                    value={csvConnectorName}
+                    onChange={(event) => setCsvConnectorName(event.target.value)}
+                    placeholder={t("workspace.unify.enter_name_for_source")}
+                  />
+                </div>
+
+                {directories.length === 0 && (
+                  <NoFeedbackRecordDirectoryAlert workspaceId={workspaceId} t={t} />
+                )}
+
+                <div className="max-h-[55vh] overflow-y-auto rounded-lg border border-slate-200 p-4">
+                  <CsvConnectorUI
+                    sourceFields={sourceFields}
+                    mappings={mappings}
+                    onMappingsChange={(m) => {
+                      setMappings(m);
+                      setEnumValidationErrors([]);
+                    }}
+                    onSourceFieldsChange={setSourceFields}
+                    onLoadSampleCSV={handleLoadSourceFields}
+                    onParsedDataChange={setCsvParsedData}
+                  />
+                </div>
+
+                {enumValidationErrors.length > 0 && (
+                  <Alert variant="error" size="small">
+                    {enumValidationErrors.map((err) => {
+                      const uniqueValues = [...new Set(err.invalidEntries.map((e) => e.value))];
+                      const rowNumbers = err.invalidEntries.slice(0, 5).map((e) => e.row);
+                      return (
+                        <div key={err.targetFieldName} className="text-xs">
+                          <p className="font-medium">
+                            {t("workspace.unify.invalid_enum_values", {
+                              field: err.targetFieldName,
+                            })}
+                          </p>
+                          <p>
+                            {t("workspace.unify.invalid_values_found", {
+                              values: uniqueValues.join(", "),
+                              rows: rowNumbers.join(", "),
+                              extra: err.invalidEntries.length > 5 ? `+${err.invalidEntries.length - 5}` : "",
+                            })}
+                          </p>
+                          <p className="mt-1 text-slate-500">
+                            {t("workspace.unify.allowed_values", {
+                              values: err.allowedValues.join(", "),
+                            })}
+                          </p>
+                        </div>
+                      );
+                    })}
+                  </Alert>
+                )}
+              </div>
+            )}
+          </div>
+
+          <DialogFooter>
+            {currentStep === "mapping" && (
+              <Button variant="outline" onClick={handleBack} disabled={isCreating || isImporting}>
+                {t("common.back")}
+              </Button>
+            )}
+            {currentStep === "selectType" ? (
+              <Button onClick={handleNextStep} disabled={!selectedType}>
+                {getNextStepButtonLabel(selectedType, t)}
+              </Button>
+            ) : (
+              <Button
+                onClick={
+                  selectedType === "formbricks_survey"
+                    ? () => void formbricksForm.handleSubmit(handleCreateFormbricksConnector)()
+                    : handleCreateCsvConnector
+                }
+                disabled={
+                  isCreating ||
+                  isImporting ||
+                  !selectedDirectoryId ||
+                  (selectedType === "formbricks_survey"
+                    ? !isConnectorNameValid(formbricksValues.sourceName ?? "") ||
+                      !formbricksValues.surveyId ||
+                      !formbricksValues.selectedQuestionIds?.length
+                    : !isConnectorNameValid(csvConnectorName) || !isCsvValid || !areCsvRequiredFieldsMapped)
+                }>
+                {isCreating && <Loader2Icon className="mr-2 h-4 w-4 animate-spin" />}
+                {t("workspace.unify.setup_connection")}
+              </Button>
+            )}
+          </DialogFooter>
+        </DialogContent>
+      </Dialog>
+    </>
+  );
+};
+
+interface NoFeedbackRecordDirectoryAlertProps {
+  workspaceId: string;
+  t: (key: string) => string;
+}
+
+const NoFeedbackRecordDirectoryAlert = ({ workspaceId, t }: NoFeedbackRecordDirectoryAlertProps) => {
+  return (
+    <Alert variant="error" size="small">
+      <div>
+        <p>{t("workspace.unify.no_feedback_record_directory_available")}</p>
+        <a
+          className="mt-1 inline-block font-medium underline"
+          href={`/workspaces/${workspaceId}/settings/feedback-record-directories`}>
+          {t("workspace.unify.go_to_feedback_record_directories")}
+        </a>
+      </div>
+    </Alert>
+  );
+};

apps/web/app/(app)/workspaces/[workspaceId]/unify/sources/components/csv-connector-ui.tsx

@@ -0,0 +1,220 @@
+"use client";
+
+import { parse } from "csv-parse/sync";
+import { ArrowUpFromLineIcon } from "lucide-react";
+import { useState } from "react";
+import { useTranslation } from "react-i18next";
+import { Alert } from "@/modules/ui/components/alert";
+import { Badge } from "@/modules/ui/components/badge";
+import { Button } from "@/modules/ui/components/button";
+import { TFieldMapping, TSourceField, createFeedbackCSVDataSchema } from "../types";
+import { validateCsvFile } from "../utils";
+import { MappingUI } from "./mapping-ui";
+
+interface CsvConnectorUIProps {
+  sourceFields: TSourceField[];
+  mappings: TFieldMapping[];
+  onMappingsChange: (mappings: TFieldMapping[]) => void;
+  onSourceFieldsChange: (fields: TSourceField[]) => void;
+  onLoadSampleCSV: () => void;
+  onParsedDataChange?: (data: Record<string, string>[]) => void;
+}
+
+export function CsvConnectorUI({
+  sourceFields,
+  mappings,
+  onMappingsChange,
+  onSourceFieldsChange,
+  onLoadSampleCSV,
+  onParsedDataChange,
+}: CsvConnectorUIProps) {
+  const { t } = useTranslation();
+  const [csvFile, setCsvFile] = useState<File | null>(null);
+  const [csvPreview, setCsvPreview] = useState<string[][]>([]);
+  const [showMapping, setShowMapping] = useState(false);
+  const [csvError, setCsvError] = useState("");
+
+  const handleFileUpload = (e: React.ChangeEvent<HTMLInputElement>) => {
+    const file = e.target?.files?.[0];
+    if (file) {
+      processCSVFile(file);
+    }
+  };
+
+  const processCSVFile = (file: File) => {
+    setCsvError("");
+
+    const validateCSVFileResult = validateCsvFile(file, t);
+
+    if (!validateCSVFileResult.valid) {
+      setCsvError(validateCSVFileResult.error);
+      return;
+    }
+
+    const reader = new FileReader();
+    reader.onload = (e) => {
+      const csv = e.target?.result as string;
+
+      try {
+        const records = parse(csv, { columns: true, skip_empty_lines: true });
+
+        const result = createFeedbackCSVDataSchema(t).safeParse(records);
+        if (!result.success) {
+          setCsvError(result.error.issues[0].message);
+          return;
+        }
+
+        const validRecords = result.data;
+        const headers = Object.keys(validRecords[0]);
+
+        const preview: string[][] = [
+          headers,
+          ...validRecords.slice(0, 5).map((row) => headers.map((h) => row[h] ?? "")),
+        ];
+        setCsvFile(file);
+        setCsvPreview(preview);
+
+        const fields: TSourceField[] = headers.map((header) => ({
+          id: header,
+          name: header,
+          type: "string",
+          sampleValue: validRecords[0][header] ?? "",
+        }));
+        onSourceFieldsChange(fields);
+        onParsedDataChange?.(validRecords);
+        setShowMapping(true);
+      } catch (error) {
+        const message = error instanceof Error ? error.message : t("common.failed_to_parse_csv");
+        setCsvError(message);
+      }
+    };
+    reader.readAsText(file);
+  };
+
+  const handleDragOver = (e: React.DragEvent<HTMLLabelElement>) => {
+    e.preventDefault();
+    e.stopPropagation();
+  };
+
+  const handleDrop = (e: React.DragEvent<HTMLLabelElement>) => {
+    e.preventDefault();
+    e.stopPropagation();
+    const file = e.dataTransfer.files[0];
+    if (file) {
+      processCSVFile(file);
+    }
+  };
+
+  const handleLoadSample = () => {
+    onLoadSampleCSV();
+    setShowMapping(true);
+  };
+
+  if (showMapping && sourceFields.length > 0) {
+    return (
+      <div className="space-y-4">
+        {csvFile && (
+          <div className="flex items-center justify-between rounded-lg border border-slate-200 bg-slate-50 px-4 py-2">
+            <div className="flex items-center gap-2">
+              <span className="text-sm font-medium text-slate-800">{csvFile.name}</span>
+              <Badge text={`${csvPreview.length - 1} rows`} type="gray" size="tiny" />
+            </div>
+            <Button
+              variant="secondary"
+              size="sm"
+              onClick={() => {
+                setCsvFile(null);
+                setCsvPreview([]);
+                setCsvError("");
+                setShowMapping(false);
+                onSourceFieldsChange([]);
+                onParsedDataChange?.([]);
+              }}>
+              {t("workspace.unify.change_file")}
+            </Button>
+          </div>
+        )}
+
+        {csvPreview.length > 0 && (
+          <div className="overflow-hidden rounded-lg border border-slate-200">
+            <div className="overflow-x-auto">
+              <table className="min-w-full text-sm">
+                <thead className="bg-slate-50">
+                  <tr>
+                    {csvPreview[0]?.map((header, i) => (
+                      <th key={i} className="px-3 py-2 text-left font-medium text-slate-700">
+                        {header}
+                      </th>
+                    ))}
+                  </tr>
+                </thead>
+                <tbody>
+                  {csvPreview.slice(1, 4).map((row, rowIndex) => (
+                    <tr key={rowIndex} className="border-t border-slate-100">
+                      {row.map((cell, cellIndex) => (
+                        <td key={cellIndex} className="px-3 py-2 text-slate-600">
+                          {cell || <span className="text-slate-300">—</span>}
+                        </td>
+                      ))}
+                    </tr>
+                  ))}
+                </tbody>
+              </table>
+            </div>
+            {csvPreview.length > 4 && (
+              <div className="border-t border-slate-100 bg-slate-50 px-3 py-1.5 text-center text-xs text-slate-500">
+                {t("workspace.unify.showing_rows", { count: csvPreview.length - 1 })}
+              </div>
+            )}
+          </div>
+        )}
+
+        <MappingUI
+          sourceFields={sourceFields}
+          mappings={mappings}
+          onMappingsChange={onMappingsChange}
+          connectorType="csv"
+        />
+      </div>
+    );
+  }
+
+  return (
+    <div className="space-y-4">
+      {csvError && (
+        <Alert variant="error" size="small">
+          {csvError}
+        </Alert>
+      )}
+      <div className="space-y-3">
+        <h4 className="text-sm font-medium text-slate-700">{t("workspace.unify.upload_csv_file")}</h4>
+        <div className="rounded-lg border-2 border-dashed border-slate-300 bg-slate-50 p-6">
+          <label
+            htmlFor="csv-file-upload"
+            className="flex cursor-pointer flex-col items-center justify-center"
+            onDragOver={handleDragOver}
+            onDrop={handleDrop}>
+            <ArrowUpFromLineIcon className="h-8 w-8 text-slate-400" />
+            <p className="mt-2 text-sm text-slate-600">
+              <span className="font-semibold">{t("workspace.unify.click_to_upload")}</span>{" "}
+              {t("workspace.unify.or_drag_and_drop")}
+            </p>
+            <p className="mt-1 text-xs text-slate-400">{t("workspace.unify.csv_files_only")}</p>
+            <input
+              type="file"
+              id="csv-file-upload"
+              accept=".csv"
+              className="hidden"
+              onChange={handleFileUpload}
+            />
+          </label>
+        </div>
+        <div className="flex justify-between">
+          <Button variant="secondary" size="sm" onClick={handleLoadSample}>
+            {t("workspace.unify.load_sample_csv")}
+          </Button>
+        </div>
+      </div>
+    </div>
+  );
+}

apps/web/app/(app)/workspaces/[workspaceId]/unify/sources/components/csv-import-modal.tsx

@@ -0,0 +1,204 @@
+"use client";
+
+import { parse } from "csv-parse/sync";
+import { ArrowUpFromLineIcon, Loader2Icon } from "lucide-react";
+import { useState } from "react";
+import toast from "react-hot-toast";
+import { useTranslation } from "react-i18next";
+import { importCsvDataAction } from "@/lib/connector/actions";
+import { getFormattedErrorMessage } from "@/lib/utils/helper";
+import { Alert } from "@/modules/ui/components/alert";
+import { Badge } from "@/modules/ui/components/badge";
+import { Button } from "@/modules/ui/components/button";
+import {
+  Dialog,
+  DialogContent,
+  DialogDescription,
+  DialogFooter,
+  DialogHeader,
+  DialogTitle,
+} from "@/modules/ui/components/dialog";
+import { createFeedbackCSVDataSchema } from "../types";
+import { validateCsvFile } from "../utils";
+
+interface CsvImportModalProps {
+  open: boolean;
+  onOpenChange: (open: boolean) => void;
+  connectorId: string;
+  workspaceId: string;
+  onOpenEditConnector?: () => void;
+}
+
+export function CsvImportModal({
+  open,
+  onOpenChange,
+  connectorId,
+  workspaceId,
+  onOpenEditConnector,
+}: CsvImportModalProps) {
+  const { t } = useTranslation();
+  const [csvFile, setCsvFile] = useState<File | null>(null);
+  const [rowCount, setRowCount] = useState(0);
+  const [parsedData, setParsedData] = useState<Record<string, string>[]>([]);
+  const [csvError, setCsvError] = useState("");
+  const [isImporting, setIsImporting] = useState(false);
+
+  const processCSVFile = (file: File) => {
+    setCsvError("");
+
+    const validateCSVFileResult = validateCsvFile(file, t);
+
+    if (!validateCSVFileResult.valid) {
+      setCsvError(validateCSVFileResult.error);
+      return;
+    }
+
+    file
+      .text()
+      .then((csv) => {
+        const records = parse(csv, { columns: true, skip_empty_lines: true });
+        const result = createFeedbackCSVDataSchema(t).safeParse(records);
+
+        if (!result.success) {
+          setCsvError(result.error.issues[0].message);
+          return;
+        }
+
+        setCsvFile(file);
+        setParsedData(result.data);
+        setRowCount(result.data.length);
+      })
+      .catch((error: unknown) => {
+        const message = error instanceof Error ? error.message : t("common.failed_to_parse_csv");
+        setCsvError(message);
+      });
+  };
+
+  const handleFileUpload = (e: React.ChangeEvent<HTMLInputElement>) => {
+    const file = e.target?.files?.[0];
+    if (file) processCSVFile(file);
+  };
+
+  const handleDragOver = (e: React.DragEvent<HTMLLabelElement>) => {
+    e.preventDefault();
+    e.stopPropagation();
+  };
+
+  const handleDrop = (e: React.DragEvent<HTMLLabelElement>) => {
+    e.preventDefault();
+    e.stopPropagation();
+    const file = e.dataTransfer.files[0];
+    if (file) processCSVFile(file);
+  };
+
+  const handleImport = async () => {
+    if (parsedData.length === 0) return;
+
+    setIsImporting(true);
+    const result = await importCsvDataAction({ connectorId, workspaceId, csvData: parsedData });
+    setIsImporting(false);
+
+    if (result?.data) {
+      toast.success(
+        t("workspace.unify.csv_import_complete", {
+          successes: result.data.successes,
+          failures: result.data.failures,
+          skipped: result.data.skipped,
+        })
+      );
+      setCsvFile(null);
+      setParsedData([]);
+      setRowCount(0);
+      onOpenChange(false);
+    } else {
+      toast.error(getFormattedErrorMessage(result));
+    }
+  };
+
+  const handleClear = () => {
+    setCsvFile(null);
+    setParsedData([]);
+    setRowCount(0);
+    setCsvError("");
+  };
+
+  return (
+    <Dialog open={open} onOpenChange={onOpenChange}>
+      <DialogContent>
+        <DialogHeader>
+          <DialogTitle>{t("workspace.unify.import_csv_data")}</DialogTitle>
+          <DialogDescription>{t("workspace.unify.upload_csv_data_description")}</DialogDescription>
+        </DialogHeader>
+
+        <div className="space-y-3">
+          <Alert variant="info" size="small">
+            {t("workspace.unify.csv_import_duplicate_warning")}
+          </Alert>
+
+          {csvError && (
+            <Alert variant="error" size="small">
+              {csvError}
+            </Alert>
+          )}
+
+          {csvFile ? (
+            <div className="flex items-center justify-between rounded-lg border border-slate-200 bg-slate-50 px-4 py-2">
+              <div className="flex items-center gap-2">
+                <span className="text-sm font-medium text-slate-800">{csvFile.name}</span>
+                <Badge text={`${rowCount} rows`} type="gray" size="tiny" />
+              </div>
+              <Button variant="secondary" size="sm" onClick={handleClear} disabled={isImporting}>
+                {t("workspace.unify.change_file")}
+              </Button>
+            </div>
+          ) : (
+            <div className="rounded-lg border-2 border-dashed border-slate-300 bg-slate-50 p-6">
+              <label
+                htmlFor="csv-import-upload"
+                className="flex cursor-pointer flex-col items-center justify-center"
+                onDragOver={handleDragOver}
+                onDrop={handleDrop}>
+                <ArrowUpFromLineIcon className="h-8 w-8 text-slate-400" />
+                <p className="mt-2 text-sm text-slate-600">
+                  <span className="font-semibold">{t("workspace.unify.click_to_upload")}</span>{" "}
+                  {t("workspace.unify.or_drag_and_drop")}
+                </p>
+                <p className="mt-1 text-xs text-slate-400">{t("workspace.unify.csv_files_only")}</p>
+                <input
+                  type="file"
+                  id="csv-import-upload"
+                  accept=".csv"
+                  className="hidden"
+                  onChange={handleFileUpload}
+                />
+              </label>
+            </div>
+          )}
+        </div>
+
+        <DialogFooter>
+          {onOpenEditConnector && (
+            <Button
+              variant="secondary"
+              onClick={() => {
+                onOpenChange(false);
+                onOpenEditConnector();
+              }}>
+              {t("workspace.unify.edit_csv_mapping")}
+            </Button>
+          )}
+          <Button onClick={handleImport} disabled={parsedData.length === 0 || isImporting}>
+            {isImporting ? (
+              <>
+                <Loader2Icon className="mr-2 h-4 w-4 animate-spin" />
+                {t("workspace.unify.importing_data")}
+              </>
+            ) : (
+              t("workspace.unify.import_rows", { count: rowCount })
+            )}
+          </Button>
+        </DialogFooter>
+      </DialogContent>
+    </Dialog>
+  );
+}

apps/web/app/(app)/workspaces/[workspaceId]/unify/sources/components/edit-connector-modal.tsx

@@ -0,0 +1,370 @@
+"use client";
+
+import { zodResolver } from "@hookform/resolvers/zod";
+import { useEffect, useMemo, useState } from "react";
+import { useForm } from "react-hook-form";
+import { useTranslation } from "react-i18next";
+import { TConnectorWithMappings } from "@formbricks/types/connector";
+import { Button } from "@/modules/ui/components/button";
+import {
+  Dialog,
+  DialogContent,
+  DialogDescription,
+  DialogFooter,
+  DialogHeader,
+  DialogTitle,
+} from "@/modules/ui/components/dialog";
+import {
+  FormControl,
+  FormError,
+  FormField,
+  FormItem,
+  FormLabel,
+  FormProvider,
+} from "@/modules/ui/components/form";
+import { Input } from "@/modules/ui/components/input";
+import { Label } from "@/modules/ui/components/label";
+import {
+  Select,
+  SelectContent,
+  SelectItem,
+  SelectTrigger,
+  SelectValue,
+} from "@/modules/ui/components/select";
+import {
+  SAMPLE_CSV_COLUMNS,
+  TFieldMapping,
+  TFormbricksConnectorForm,
+  TSourceField,
+  TUnifySurvey,
+  ZFormbricksConnectorForm,
+} from "../types";
+import {
+  areAllRequiredFieldsMapped,
+  isConnectorNameValid,
+  parseCSVColumnsToFields,
+  toggleQuestionId,
+} from "../utils";
+import { getConnectorIcon, getConnectorTypeLabelKey } from "./connector-display";
+import { FormbricksQuestionList } from "./formbricks-question-list";
+import { MappingUI } from "./mapping-ui";
+
+interface EditConnectorModalProps {
+  connector: TConnectorWithMappings | null;
+  open: boolean;
+  onOpenChange: (open: boolean) => void;
+  onUpdateConnector: (data: {
+    connectorId: string;
+    workspaceId: string;
+    name: string;
+    surveyMappings?: { surveyId: string; elementIds: string[] }[];
+    fieldMappings?: TFieldMapping[];
+  }) => Promise<void>;
+  surveys: TUnifySurvey[];
+  onOpenCsvImport?: () => void;
+}
+
+export const EditConnectorModal = ({
+  connector,
+  open,
+  onOpenChange,
+  onUpdateConnector,
+  surveys,
+  onOpenCsvImport,
+}: EditConnectorModalProps) => {
+  const { t } = useTranslation();
+  const [csvConnectorName, setCsvConnectorName] = useState("");
+  const [mappings, setMappings] = useState<TFieldMapping[]>([]);
+  const [sourceFields, setSourceFields] = useState<TSourceField[]>([]);
+  const [isUpdating, setIsUpdating] = useState(false);
+
+  const formbricksForm = useForm<TFormbricksConnectorForm>({
+    resolver: zodResolver(ZFormbricksConnectorForm),
+    defaultValues: {
+      sourceName: "",
+      surveyId: "",
+      selectedQuestionIds: [],
+      importHistorical: true,
+    },
+    mode: "onChange",
+  });
+
+  const formbricksValues = formbricksForm.watch();
+  const selectedSurveyId = formbricksValues.surveyId;
+  const selectedQuestionIds = formbricksValues.selectedQuestionIds ?? [];
+  const selectedSurvey = useMemo(
+    () => surveys.find((survey) => survey.id === selectedSurveyId) ?? null,
+    [surveys, selectedSurveyId]
+  );
+
+  useEffect(() => {
+    if (connector) {
+      if (connector.type === "formbricks_survey") {
+        const mappedSurveyId = connector.formbricksMappings[0]?.surveyId ?? "";
+        const mappedQuestionIds = connector.formbricksMappings
+          .filter((mapping) => mapping.surveyId === mappedSurveyId)
+          .map((mapping) => mapping.elementId);
+
+        formbricksForm.reset({
+          sourceName: connector.name,
+          surveyId: mappedSurveyId,
+          selectedQuestionIds: mappedQuestionIds,
+          importHistorical: true,
+        });
+        setCsvConnectorName("");
+        setSourceFields([]);
+        setMappings([]);
+      } else if (connector.type === "csv") {
+        setCsvConnectorName(connector.name);
+        const columnsFromMappings = [
+          ...new Set(connector.fieldMappings.map((m) => m.sourceFieldId).filter(Boolean)),
+        ];
+        setSourceFields(
+          columnsFromMappings.length > 0
+            ? parseCSVColumnsToFields(columnsFromMappings.join(","))
+            : parseCSVColumnsToFields(SAMPLE_CSV_COLUMNS)
+        );
+        setMappings(
+          connector.fieldMappings.map((m) => ({
+            sourceFieldId: m.sourceFieldId,
+            targetFieldId: m.targetFieldId,
+            staticValue: m.staticValue ?? undefined,
+          }))
+        );
+        formbricksForm.reset({
+          sourceName: "",
+          surveyId: "",
+          selectedQuestionIds: [],
+          importHistorical: true,
+        });
+      } else {
+        setCsvConnectorName("");
+        setSourceFields([]);
+        setMappings([]);
+        formbricksForm.reset({
+          sourceName: "",
+          surveyId: "",
+          selectedQuestionIds: [],
+          importHistorical: true,
+        });
+      }
+    }
+  }, [connector, formbricksForm]);
+
+  const resetForm = () => {
+    setCsvConnectorName("");
+    setMappings([]);
+    setSourceFields([]);
+    formbricksForm.reset({
+      sourceName: "",
+      surveyId: "",
+      selectedQuestionIds: [],
+      importHistorical: true,
+    });
+    setIsUpdating(false);
+  };
+
+  const handleOpenChange = (newOpen: boolean) => {
+    if (!newOpen) {
+      resetForm();
+    }
+    onOpenChange(newOpen);
+  };
+
+  const handleUpdateFormbricksConnector = async (values: TFormbricksConnectorForm) => {
+    if (connector?.type !== "formbricks_survey") return;
+    setIsUpdating(true);
+    await onUpdateConnector({
+      connectorId: connector.id,
+      workspaceId: connector.workspaceId,
+      name: values.sourceName.trim(),
+      surveyMappings: [{ surveyId: values.surveyId, elementIds: values.selectedQuestionIds }],
+      fieldMappings: undefined,
+    });
+    setIsUpdating(false);
+    handleOpenChange(false);
+  };
+
+  const handleUpdateCsvConnector = async () => {
+    if (connector?.type !== "csv" || !isConnectorNameValid(csvConnectorName)) return;
+    setIsUpdating(true);
+    await onUpdateConnector({
+      connectorId: connector.id,
+      workspaceId: connector.workspaceId,
+      name: csvConnectorName.trim(),
+      surveyMappings: undefined,
+      fieldMappings: mappings.length > 0 ? mappings : undefined,
+    });
+    setIsUpdating(false);
+    handleOpenChange(false);
+  };
+
+  const handleFormbricksQuestionToggle = (questionId: string) => {
+    const nextSelection = toggleQuestionId(formbricksForm.getValues("selectedQuestionIds"), questionId);
+    formbricksForm.setValue("selectedQuestionIds", nextSelection, {
+      shouldDirty: true,
+      shouldValidate: true,
+    });
+  };
+
+  const saveChangesDisabled = useMemo(() => {
+    if (!connector) return true;
+    if (isUpdating) return true;
+
+    if (connector.type === "formbricks_survey") {
+      return (
+        !isConnectorNameValid(formbricksValues.sourceName ?? "") ||
+        !formbricksValues.surveyId ||
+        !formbricksValues.selectedQuestionIds?.length
+      );
+    }
+
+    if (connector.type === "csv") {
+      return !isConnectorNameValid(csvConnectorName) || !areAllRequiredFieldsMapped(mappings);
+    }
+
+    return true;
+  }, [connector, csvConnectorName, formbricksValues, isUpdating, mappings]);
+
+  if (!connector) return null;
+
+  return (
+    <Dialog open={open} onOpenChange={handleOpenChange}>
+      <DialogContent className="max-w-3xl">
+        <DialogHeader>
+          <DialogTitle>{t("workspace.unify.edit_source_connection")}</DialogTitle>
+          <DialogDescription>{t("workspace.unify.update_mapping_description")}</DialogDescription>
+        </DialogHeader>
+
+        <div className="space-y-4 py-4">
+          {connector.type === "formbricks_survey" ? (
+            <FormProvider {...formbricksForm}>
+              <form className="space-y-4">
+                <FormField
+                  control={formbricksForm.control}
+                  name="sourceName"
+                  render={({ field }) => (
+                    <FormItem>
+                      <FormLabel>{t("workspace.unify.source_name")}</FormLabel>
+                      <FormControl>
+                        <Input
+                          value={field.value}
+                          onChange={field.onChange}
+                          placeholder={t("workspace.unify.enter_name_for_source")}
+                        />
+                      </FormControl>
+                      <FormError />
+                    </FormItem>
+                  )}
+                />
+
+                <FormField
+                  control={formbricksForm.control}
+                  name="surveyId"
+                  render={({ field }) => (
+                    <FormItem>
+                      <FormLabel>{t("workspace.unify.select_survey")}</FormLabel>
+                      <FormControl>
+                        <Select value={field.value} onValueChange={field.onChange} disabled>
+                          <SelectTrigger>
+                            <SelectValue placeholder={t("workspace.unify.select_survey")} />
+                          </SelectTrigger>
+                          <SelectContent>
+                            {selectedSurvey && (
+                              <SelectItem key={selectedSurvey.id} value={selectedSurvey.id}>
+                                {selectedSurvey.name}
+                              </SelectItem>
+                            )}
+                            {!selectedSurvey && field.value && (
+                              <SelectItem value={field.value}>{field.value}</SelectItem>
+                            )}
+                          </SelectContent>
+                        </Select>
+                      </FormControl>
+                      <FormError />
+                    </FormItem>
+                  )}
+                />
+
+                <FormField
+                  control={formbricksForm.control}
+                  name="selectedQuestionIds"
+                  render={() => (
+                    <FormItem>
+                      <FormLabel>{t("workspace.unify.select_questions")}</FormLabel>
+                      <FormControl>
+                        <div>
+                          <FormbricksQuestionList
+                            survey={selectedSurvey}
+                            selectedQuestionIds={selectedQuestionIds}
+                            onQuestionToggle={handleFormbricksQuestionToggle}
+                          />
+                        </div>
+                      </FormControl>
+                      <FormError />
+                    </FormItem>
+                  )}
+                />
+              </form>
+            </FormProvider>
+          ) : (
+            <>
+              <div className="flex items-center gap-3 rounded-lg border border-slate-200 bg-slate-50 p-3">
+                {getConnectorIcon(connector.type, "h-5 w-5 text-slate-500")}
+                <div>
+                  <p className="text-sm font-medium text-slate-900">
+                    {t(getConnectorTypeLabelKey(connector.type))}
+                  </p>
+                  <p className="text-xs text-slate-500">
+                    {t("workspace.unify.source_type_cannot_be_changed")}
+                  </p>
+                </div>
+              </div>
+
+              <div className="space-y-2">
+                <Label htmlFor="editConnectorName">{t("workspace.unify.source_name")}</Label>
+                <Input
+                  id="editConnectorName"
+                  value={csvConnectorName}
+                  onChange={(event) => setCsvConnectorName(event.target.value)}
+                  placeholder={t("workspace.unify.enter_name_for_source")}
+                />
+              </div>
+
+              <div className="max-h-[40vh] overflow-y-auto rounded-lg border border-slate-200 p-4">
+                <MappingUI
+                  sourceFields={sourceFields}
+                  mappings={mappings}
+                  onMappingsChange={setMappings}
+                  connectorType={connector.type}
+                />
+              </div>
+            </>
+          )}
+        </div>
+
+        <DialogFooter>
+          {connector.type === "csv" && (
+            <Button
+              variant="secondary"
+              onClick={() => {
+                handleOpenChange(false);
+                onOpenCsvImport?.();
+              }}>
+              {t("workspace.unify.import_feedback")}
+            </Button>
+          )}
+          <Button
+            onClick={
+              connector.type === "formbricks_survey"
+                ? () => void formbricksForm.handleSubmit(handleUpdateFormbricksConnector)()
+                : handleUpdateCsvConnector
+            }
+            disabled={saveChangesDisabled}>
+            {t("workspace.unify.save_changes")}
+          </Button>
+        </DialogFooter>
+      </DialogContent>
+    </Dialog>
+  );
+};

apps/web/app/(app)/workspaces/[workspaceId]/unify/sources/components/formbricks-question-list.tsx

@@ -0,0 +1,80 @@
+"use client";
+
+import { useTranslation } from "react-i18next";
+import { UNSUPPORTED_CONNECTOR_ELEMENT_TYPES } from "@formbricks/types/connector";
+import { getTSurveyElementTypeEnumName } from "@/modules/survey/lib/elements";
+import { Checkbox } from "@/modules/ui/components/checkbox";
+import { Label } from "@/modules/ui/components/label";
+import { TUnifySurvey } from "../types";
+
+interface FormbricksQuestionListProps {
+  survey: TUnifySurvey | null;
+  selectedQuestionIds: string[];
+  onQuestionToggle: (questionId: string) => void;
+}
+
+const isUnsupportedElementType = (type: string): boolean =>
+  (UNSUPPORTED_CONNECTOR_ELEMENT_TYPES as readonly string[]).includes(type);
+
+export const FormbricksQuestionList = ({
+  survey,
+  selectedQuestionIds,
+  onQuestionToggle,
+}: Readonly<FormbricksQuestionListProps>) => {
+  const { t } = useTranslation();
+
+  if (!survey) {
+    return (
+      <div className="rounded-md border border-dashed border-slate-300 p-3">
+        <p className="text-sm text-slate-500">{t("workspace.unify.select_a_survey_to_see_questions")}</p>
+      </div>
+    );
+  }
+
+  if (survey.elements.length === 0) {
+    return (
+      <div className="rounded-md border border-dashed border-slate-300 p-3">
+        <p className="text-sm text-slate-500">{t("workspace.unify.survey_has_no_questions")}</p>
+      </div>
+    );
+  }
+
+  return (
+    <div className="max-h-64 space-y-2 overflow-y-auto rounded-md border border-slate-200 p-3">
+      {survey.elements.map((element) => {
+        const unsupported = isUnsupportedElementType(element.type);
+        const isChecked = selectedQuestionIds.includes(element.id);
+        const elementTypeLabel = getTSurveyElementTypeEnumName(element.type, t) ?? element.type;
+        const inputId = `connector-question-${element.id}`;
+
+        return (
+          <div
+            key={element.id}
+            className={`flex items-start gap-3 rounded-md border border-slate-100 p-2 ${
+              unsupported ? "opacity-60" : ""
+            }`}>
+            <Checkbox
+              id={inputId}
+              checked={!unsupported && isChecked}
+              disabled={unsupported}
+              onCheckedChange={() => {
+                if (!unsupported) {
+                  onQuestionToggle(element.id);
+                }
+              }}
+            />
+            <div className="space-y-0.5">
+              <Label htmlFor={inputId} className={unsupported ? "cursor-not-allowed" : "cursor-pointer"}>
+                {element.headline}
+              </Label>
+              <p className="text-xs text-slate-500">{elementTypeLabel}</p>
+              {unsupported && (
+                <p className="text-xs text-slate-500">{t("workspace.unify.question_type_not_supported")}</p>
+              )}
+            </div>
+          </div>
+        );
+      })}
+    </div>
+  );
+};

apps/web/app/(app)/workspaces/[workspaceId]/unify/sources/components/mapping-field.tsx

@@ -0,0 +1,358 @@
+"use client";
+
+import { useDraggable, useDroppable } from "@dnd-kit/core";
+import { ChevronDownIcon, GripVerticalIcon, PencilIcon, XIcon } from "lucide-react";
+import { useState } from "react";
+import { useTranslation } from "react-i18next";
+import { Input } from "@/modules/ui/components/input";
+import {
+  Select,
+  SelectContent,
+  SelectItem,
+  SelectTrigger,
+  SelectValue,
+} from "@/modules/ui/components/select";
+import { cn } from "@/modules/ui/lib/utils";
+import { TFieldMapping, TSourceField, TTargetField } from "../types";
+
+interface DraggableSourceFieldProps {
+  field: TSourceField;
+  isMapped: boolean;
+}
+
+export const DraggableSourceField = ({ field, isMapped }: DraggableSourceFieldProps) => {
+  const { attributes, listeners, setNodeRef, transform, isDragging } = useDraggable({
+    id: field.id,
+    data: field,
+  });
+
+  const style = transform
+    ? {
+        transform: `translate3d(${transform.x}px, ${transform.y}px, 0)`,
+      }
+    : undefined;
+
+  return (
+    <div
+      ref={setNodeRef}
+      style={style}
+      {...listeners}
+      {...attributes}
+      className={`flex cursor-grab items-center gap-2 rounded-md border p-2 text-sm transition-colors ${
+        isDragging
+          ? "border-brand-dark bg-slate-100 opacity-50"
+          : isMapped
+            ? "border-green-300 bg-green-50 text-green-800"
+            : "border-slate-200 bg-white hover:border-slate-300"
+      }`}>
+      <GripVerticalIcon className="h-4 w-4 text-slate-400" />
+      <div className="flex-1 truncate">
+        <span className="font-medium">{field.name}</span>
+        <span className="ml-2 text-xs text-slate-500">({field.type})</span>
+      </div>
+      {field.sampleValue && (
+        <span className="max-w-24 truncate text-xs text-slate-400">{field.sampleValue}</span>
+      )}
+    </div>
+  );
+};
+
+const getMappingStateClass = (isActive: boolean, hasMapping: unknown): string => {
+  if (isActive) return "border-brand-dark bg-slate-100";
+  if (hasMapping) return "border-green-300 bg-green-50";
+  return "border-dashed border-slate-300 bg-slate-50";
+};
+
+interface RemoveMappingButtonProps {
+  onClick: () => void;
+  variant: "green" | "blue";
+}
+
+const RemoveMappingButton = ({ onClick, variant }: RemoveMappingButtonProps) => {
+  const colorClass = variant === "green" ? "hover:bg-green-100" : "hover:bg-blue-100";
+  const iconClass = variant === "green" ? "text-green-600" : "text-blue-600";
+  return (
+    <button type="button" onClick={onClick} className={`ml-1 rounded p-0.5 ${colorClass}`}>
+      <XIcon className={`h-3 w-3 ${iconClass}`} />
+    </button>
+  );
+};
+
+interface EnumTargetFieldContentProps {
+  field: TTargetField;
+  mappedSourceField: TSourceField | null;
+  mapping: TFieldMapping | null;
+  onRemoveMapping: () => void;
+  onStaticValueChange: (value: string) => void;
+  t: (key: string) => string;
+}
+
+const EnumTargetFieldContent = ({
+  field,
+  mappedSourceField,
+  mapping,
+  onRemoveMapping,
+  onStaticValueChange,
+  t,
+}: EnumTargetFieldContentProps) => {
+  return (
+    <div className="flex flex-1 flex-col gap-1">
+      <div className="flex items-center gap-2">
+        <span className="font-medium text-slate-900">{field.name}</span>
+        {field.required && <span className="text-xs text-red-500">*</span>}
+        <span className="text-xs text-slate-400">{t("workspace.unify.enum")}</span>
+      </div>
+
+      {mappedSourceField && !mapping?.staticValue ? (
+        <div className="flex items-center gap-1">
+          <span className="text-xs text-green-700">&larr; {mappedSourceField.name}</span>
+          <RemoveMappingButton onClick={onRemoveMapping} variant="green" />
+        </div>
+      ) : (
+        <Select value={mapping?.staticValue || ""} onValueChange={onStaticValueChange}>
+          <SelectTrigger className="h-8 w-full bg-white">
+            <SelectValue placeholder={t("workspace.unify.select_a_value")} />
+          </SelectTrigger>
+          <SelectContent>
+            {field.enumValues?.map((value) => (
+              <SelectItem key={value} value={value}>
+                {value}
+              </SelectItem>
+            ))}
+          </SelectContent>
+        </Select>
+      )}
+    </div>
+  );
+};
+
+interface StringTargetFieldContentProps {
+  field: TTargetField;
+  mappedSourceField: TSourceField | null;
+  mapping: TFieldMapping | null;
+  hasMapping: unknown;
+  onRemoveMapping: () => void;
+  onStaticValueChange: (value: string) => void;
+  t: (key: string) => string;
+}
+
+const StringTargetFieldContent = ({
+  field,
+  mappedSourceField,
+  mapping,
+  hasMapping,
+  onRemoveMapping,
+  onStaticValueChange,
+  t,
+}: StringTargetFieldContentProps) => {
+  const [isEditingStatic, setIsEditingStatic] = useState(false);
+  const [customValue, setCustomValue] = useState("");
+
+  return (
+    <div className="flex flex-1 flex-col gap-1">
+      <div className="flex items-center gap-2">
+        <span className="font-medium text-slate-900">{field.name}</span>
+        {field.required && <span className="text-xs text-red-500">*</span>}
+      </div>
+
+      {mappedSourceField && !mapping?.staticValue && (
+        <div className="flex items-center gap-1">
+          <span className="text-xs text-green-700">← {mappedSourceField.name}</span>
+          <RemoveMappingButton onClick={onRemoveMapping} variant="green" />
+        </div>
+      )}
+
+      {mapping?.staticValue && !mappedSourceField && (
+        <div className="flex items-center gap-1">
+          <span className="rounded bg-blue-100 px-1.5 py-0.5 text-xs text-blue-700">
+            = &ldquo;{mapping.staticValue}&rdquo;
+          </span>
+          <RemoveMappingButton onClick={onRemoveMapping} variant="blue" />
+        </div>
+      )}
+
+      {isEditingStatic && !hasMapping && (
+        <div className="flex items-center gap-1">
+          <Input
+            type="text"
+            value={customValue}
+            onChange={(e) => setCustomValue(e.target.value)}
+            placeholder={
+              field.exampleStaticValues
+                ? `e.g., ${field.exampleStaticValues[0]}`
+                : t("workspace.unify.enter_value")
+            }
+            className="h-7 text-xs"
+            autoFocus
+            onKeyDown={(e) => {
+              if (e.key === "Enter" && customValue.trim()) {
+                onStaticValueChange(customValue.trim());
+                setCustomValue("");
+                setIsEditingStatic(false);
+              }
+              if (e.key === "Escape") {
+                setCustomValue("");
+                setIsEditingStatic(false);
+              }
+            }}
+          />
+          <button
+            type="button"
+            onClick={() => {
+              if (customValue.trim()) {
+                onStaticValueChange(customValue.trim());
+                setCustomValue("");
+              }
+              setIsEditingStatic(false);
+            }}
+            className="rounded p-1 text-slate-500 hover:bg-slate-200">
+            <ChevronDownIcon className="h-3 w-3" />
+          </button>
+        </div>
+      )}
+
+      {!hasMapping && !isEditingStatic && (
+        <div className="flex flex-wrap items-center gap-1">
+          <span className="text-xs text-slate-400">{t("workspace.unify.drop_field_or")}</span>
+          <button
+            type="button"
+            onClick={() => setIsEditingStatic(true)}
+            className="flex items-center gap-1 rounded px-1 py-0.5 text-xs text-slate-500 hover:bg-slate-200">
+            <PencilIcon className="h-3 w-3" />
+            {t("workspace.unify.set_value")}
+          </button>
+          {field.exampleStaticValues && field.exampleStaticValues.length > 0 && (
+            <>
+              <span className="text-xs text-slate-300">|</span>
+              {field.exampleStaticValues.slice(0, 3).map((val) => (
+                <button
+                  key={val}
+                  type="button"
+                  onClick={() => onStaticValueChange(val)}
+                  className="rounded bg-slate-100 px-1.5 py-0.5 text-xs text-slate-600 hover:bg-slate-200">
+                  {val}
+                </button>
+              ))}
+            </>
+          )}
+        </div>
+      )}
+    </div>
+  );
+};
+
+interface DroppableTargetFieldProps {
+  field: TTargetField;
+  mappedSourceField: TSourceField | null;
+  mapping: TFieldMapping | null;
+  onRemoveMapping: () => void;
+  onStaticValueChange: (value: string) => void;
+  isOver?: boolean;
+}
+
+export const DroppableTargetField = ({
+  field,
+  mappedSourceField,
+  mapping,
+  onRemoveMapping,
+  onStaticValueChange,
+  isOver,
+}: DroppableTargetFieldProps) => {
+  const { t } = useTranslation();
+  const { setNodeRef, isOver: isOverCurrent } = useDroppable({
+    id: field.id,
+    data: field,
+  });
+
+  const isActive = isOver || isOverCurrent;
+  const hasMapping = mappedSourceField || mapping?.staticValue;
+  const containerClass = cn(
+    "flex items-center gap-2 rounded-md border p-2 text-sm transition-colors",
+    getMappingStateClass(!!isActive, hasMapping)
+  );
+
+  if (field.type === "enum" && field.enumValues) {
+    return (
+      <div ref={setNodeRef} className={containerClass}>
+        <EnumTargetFieldContent
+          field={field}
+          mappedSourceField={mappedSourceField}
+          mapping={mapping}
+          onRemoveMapping={onRemoveMapping}
+          onStaticValueChange={onStaticValueChange}
+          t={t}
+        />
+      </div>
+    );
+  }
+
+  if (field.type === "string") {
+    return (
+      <div ref={setNodeRef} className={containerClass}>
+        <StringTargetFieldContent
+          field={field}
+          mappedSourceField={mappedSourceField}
+          mapping={mapping}
+          hasMapping={hasMapping}
+          onRemoveMapping={onRemoveMapping}
+          onStaticValueChange={onStaticValueChange}
+          t={t}
+        />
+      </div>
+    );
+  }
+
+  // Helper to get display label for static values
+  const getStaticValueLabel = (value: string) => {
+    if (value === "$now") return t("workspace.unify.feedback_date");
+    return value;
+  };
+
+  return (
+    <div ref={setNodeRef} className={containerClass}>
+      <div className="flex flex-1 flex-col">
+        <div className="flex items-center gap-2">
+          <span className="font-medium text-slate-900">{field.name}</span>
+          {field.required && <span className="text-xs text-red-500">*</span>}
+          <span className="text-xs text-slate-400">({field.type})</span>
+        </div>
+
+        {mappedSourceField && !mapping?.staticValue && (
+          <div className="mt-1 flex items-center gap-1">
+            <span className="text-xs text-green-700">← {mappedSourceField.name}</span>
+            <RemoveMappingButton onClick={onRemoveMapping} variant="green" />
+          </div>
+        )}
+
+        {mapping?.staticValue && !mappedSourceField && (
+          <div className="mt-1 flex items-center gap-1">
+            <span className="rounded bg-blue-100 px-1.5 py-0.5 text-xs text-blue-700">
+              = {getStaticValueLabel(mapping.staticValue)}
+            </span>
+            <RemoveMappingButton onClick={onRemoveMapping} variant="blue" />
+          </div>
+        )}
+
+        {!hasMapping && (
+          <div className="mt-1 flex flex-wrap items-center gap-1">
+            <span className="text-xs text-slate-400">{t("workspace.unify.drop_a_field_here")}</span>
+            {field.exampleStaticValues && field.exampleStaticValues.length > 0 && (
+              <>
+                <span className="text-xs text-slate-300">|</span>
+                {field.exampleStaticValues.map((val) => (
+                  <button
+                    key={val}
+                    type="button"
+                    onClick={() => onStaticValueChange(val)}
+                    className="rounded bg-slate-100 px-1.5 py-0.5 text-xs text-slate-600 hover:bg-slate-200">
+                    {getStaticValueLabel(val)}
+                  </button>
+                ))}
+              </>
+            )}
+          </div>
+        )}
+      </div>
+    </div>
+  );
+};

apps/web/app/(app)/workspaces/[workspaceId]/unify/sources/components/mapping-ui.tsx

@@ -0,0 +1,146 @@
+"use client";
+
+import { DndContext, DragEndEvent, DragOverlay, DragStartEvent } from "@dnd-kit/core";
+import { useState } from "react";
+import { useTranslation } from "react-i18next";
+import { TConnectorType } from "@formbricks/types/connector";
+import { FEEDBACK_RECORD_FIELDS, TFieldMapping, TSourceField } from "../types";
+import { DraggableSourceField, DroppableTargetField } from "./mapping-field";
+
+interface MappingUIProps {
+  sourceFields: TSourceField[];
+  mappings: TFieldMapping[];
+  onMappingsChange: (mappings: TFieldMapping[]) => void;
+  connectorType: TConnectorType;
+}
+
+export function MappingUI({ sourceFields, mappings, onMappingsChange, connectorType }: MappingUIProps) {
+  const { t } = useTranslation();
+  const [activeId, setActiveId] = useState<string | null>(null);
+
+  const requiredFields = FEEDBACK_RECORD_FIELDS.filter((f) => f.required);
+  const optionalFields = FEEDBACK_RECORD_FIELDS.filter((f) => !f.required);
+
+  const handleDragStart = (event: DragStartEvent) => {
+    setActiveId(event.active.id as string);
+  };
+
+  const handleDragEnd = (event: DragEndEvent) => {
+    const { active, over } = event;
+    setActiveId(null);
+
+    if (!over) return;
+
+    const sourceFieldId = active.id as string;
+    const targetFieldId = over.id as string;
+
+    const newMappings = mappings.filter(
+      (m) => m.sourceFieldId !== sourceFieldId && m.targetFieldId !== targetFieldId
+    );
+    onMappingsChange([...newMappings, { sourceFieldId, targetFieldId }]);
+  };
+
+  const handleRemoveMapping = (targetFieldId: string) => {
+    onMappingsChange(mappings.filter((m) => m.targetFieldId !== targetFieldId));
+  };
+
+  const handleStaticValueChange = (targetFieldId: string, staticValue: string) => {
+    const newMappings = mappings.filter((m) => m.targetFieldId !== targetFieldId);
+    onMappingsChange([...newMappings, { targetFieldId, staticValue }]);
+  };
+
+  const getSourceFieldById = (id: string) => sourceFields.find((f) => f.id === id);
+
+  const getMappingForTarget = (targetFieldId: string) => {
+    return mappings.find((m) => m.targetFieldId === targetFieldId) ?? null;
+  };
+
+  const getMappedSourceField = (targetFieldId: string) => {
+    const mapping = getMappingForTarget(targetFieldId);
+    return mapping?.sourceFieldId ? getSourceFieldById(mapping.sourceFieldId) : null;
+  };
+
+  const isSourceFieldMapped = (sourceFieldId: string) =>
+    mappings.some((m) => m.sourceFieldId === sourceFieldId);
+
+  const activeField = activeId ? getSourceFieldById(activeId) : null;
+
+  return (
+    <DndContext onDragStart={handleDragStart} onDragEnd={handleDragEnd}>
+      <div className="grid grid-cols-2 gap-6">
+        {/* Source Fields Panel */}
+        <div className="space-y-3">
+          <h4 className="text-sm font-medium text-slate-700">
+            {connectorType === "csv" ? t("workspace.unify.csv_columns") : t("workspace.unify.source_fields")}
+          </h4>
+
+          {sourceFields.length === 0 ? (
+            <div className="flex h-64 items-center justify-center rounded-lg border border-dashed border-slate-300 bg-slate-50">
+              <p className="text-sm text-slate-500">
+                {connectorType === "csv"
+                  ? t("workspace.unify.click_load_sample_csv")
+                  : t("workspace.unify.no_source_fields_loaded")}
+              </p>
+            </div>
+          ) : (
+            <div className="space-y-2">
+              {sourceFields.map((field) => (
+                <DraggableSourceField key={field.id} field={field} isMapped={isSourceFieldMapped(field.id)} />
+              ))}
+            </div>
+          )}
+        </div>
+
+        {/* Target Fields Panel */}
+        <div className="space-y-3">
+          <h4 className="text-sm font-medium text-slate-700">
+            {t("workspace.unify.feedback_record_fields")}
+          </h4>
+
+          {/* Required Fields */}
+          <div className="space-y-2">
+            <p className="text-xs font-medium uppercase tracking-wide text-slate-500">
+              {t("workspace.unify.required")}
+            </p>
+            {requiredFields.map((field) => (
+              <DroppableTargetField
+                key={field.id}
+                field={field}
+                mappedSourceField={getMappedSourceField(field.id) ?? null}
+                mapping={getMappingForTarget(field.id)}
+                onRemoveMapping={() => handleRemoveMapping(field.id)}
+                onStaticValueChange={(value) => handleStaticValueChange(field.id, value)}
+              />
+            ))}
+          </div>
+
+          {/* Optional Fields */}
+          <div className="mt-4 space-y-2">
+            <p className="text-xs font-medium uppercase tracking-wide text-slate-500">
+              {t("workspace.unify.optional")}
+            </p>
+            {optionalFields.map((field) => (
+              <DroppableTargetField
+                key={field.id}
+                field={field}
+                mappedSourceField={getMappedSourceField(field.id) ?? null}
+                mapping={getMappingForTarget(field.id)}
+                onRemoveMapping={() => handleRemoveMapping(field.id)}
+                onStaticValueChange={(value) => handleStaticValueChange(field.id, value)}
+              />
+            ))}
+          </div>
+        </div>
+      </div>
+
+      <DragOverlay>
+        {activeField ? (
+          <div className="rounded-md border border-brand-dark bg-white p-2 text-sm shadow-lg">
+            <span className="font-medium">{activeField.name}</span>
+            <span className="ml-2 text-xs text-slate-500">({activeField.type})</span>
+          </div>
+        ) : null}
+      </DragOverlay>
+    </DndContext>
+  );
+}

apps/web/app/(app)/workspaces/[workspaceId]/unify/sources/lib.test.ts

@@ -0,0 +1,243 @@
+import { describe, expect, test, vi } from "vitest";
+import { TSurveyElementTypeEnum } from "@formbricks/types/surveys/elements";
+import { TSurvey } from "@formbricks/types/surveys/types";
+import { transformToUnifySurvey } from "./lib";
+
+vi.mock("@formbricks/types/surveys/validation", () => ({
+  getTextContent: (str: string) => str,
+}));
+
+vi.mock("@/lib/i18n/utils", () => ({
+  getLocalizedValue: (val: Record<string, string>, _lang: string) => val?.default ?? "",
+}));
+
+vi.mock("@/lib/survey/utils", () => ({
+  getElementsFromBlocks: (blocks: Array<{ elements: unknown[] }>) =>
+    blocks.flatMap((block) => block.elements),
+}));
+
+vi.mock("@/lib/utils/recall", () => ({
+  recallToHeadline: (headline: Record<string, string>) => headline,
+}));
+
+const NOW = new Date("2026-02-24T10:00:00.000Z");
+
+const createMockSurvey = (overrides: Partial<TSurvey> = {}): TSurvey =>
+  ({
+    id: "survey-1",
+    name: "Test Survey",
+    status: "inProgress",
+    createdAt: NOW,
+    blocks: [
+      {
+        elements: [
+          {
+            id: "el-text",
+            type: TSurveyElementTypeEnum.OpenText,
+            headline: { default: "What do you think?" },
+            required: true,
+          },
+          {
+            id: "el-nps",
+            type: TSurveyElementTypeEnum.NPS,
+            headline: { default: "How likely to recommend?" },
+            required: false,
+          },
+        ],
+      },
+    ],
+    ...overrides,
+  }) as unknown as TSurvey;
+
+describe("transformToUnifySurvey", () => {
+  test("transforms a survey with basic elements", () => {
+    const result = transformToUnifySurvey(createMockSurvey());
+
+    expect(result).toEqual({
+      id: "survey-1",
+      name: "Test Survey",
+      status: "active",
+      createdAt: NOW,
+      elements: [
+        {
+          id: "el-text",
+          type: TSurveyElementTypeEnum.OpenText,
+          headline: "What do you think?",
+          required: true,
+        },
+        {
+          id: "el-nps",
+          type: TSurveyElementTypeEnum.NPS,
+          headline: "How likely to recommend?",
+          required: false,
+        },
+      ],
+    });
+  });
+
+  test("filters out CTA elements", () => {
+    const survey = createMockSurvey({
+      blocks: [
+        {
+          elements: [
+            {
+              id: "el-text",
+              type: TSurveyElementTypeEnum.OpenText,
+              headline: { default: "Feedback" },
+              required: true,
+            },
+            {
+              id: "el-cta",
+              type: TSurveyElementTypeEnum.CTA,
+              headline: { default: "Click here" },
+              required: false,
+            },
+          ],
+        },
+      ],
+    } as Partial<TSurvey>);
+
+    const result = transformToUnifySurvey(survey);
+
+    expect(result.elements).toHaveLength(1);
+    expect(result.elements[0].id).toBe("el-text");
+  });
+
+  test("defaults required to false when not set", () => {
+    const survey = createMockSurvey({
+      blocks: [
+        {
+          elements: [
+            {
+              id: "el-1",
+              type: TSurveyElementTypeEnum.Rating,
+              headline: { default: "Rate us" },
+            },
+          ],
+        },
+      ],
+    } as Partial<TSurvey>);
+
+    const result = transformToUnifySurvey(survey);
+    expect(result.elements[0].required).toBe(false);
+  });
+
+  test("falls back to 'Untitled' when headline is empty", () => {
+    const survey = createMockSurvey({
+      blocks: [
+        {
+          elements: [
+            {
+              id: "el-1",
+              type: TSurveyElementTypeEnum.OpenText,
+              headline: { default: "" },
+              required: false,
+            },
+          ],
+        },
+      ],
+    } as Partial<TSurvey>);
+
+    const result = transformToUnifySurvey(survey);
+    expect(result.elements[0].headline).toBe("Untitled");
+  });
+
+  describe("mapSurveyStatus", () => {
+    test("maps 'inProgress' to 'active'", () => {
+      const result = transformToUnifySurvey(createMockSurvey({ status: "inProgress" } as Partial<TSurvey>));
+      expect(result.status).toBe("active");
+    });
+
+    test("maps 'paused' to 'paused'", () => {
+      const result = transformToUnifySurvey(createMockSurvey({ status: "paused" } as Partial<TSurvey>));
+      expect(result.status).toBe("paused");
+    });
+
+    test("maps 'draft' to 'draft'", () => {
+      const result = transformToUnifySurvey(createMockSurvey({ status: "draft" } as Partial<TSurvey>));
+      expect(result.status).toBe("draft");
+    });
+
+    test("maps 'completed' to 'completed'", () => {
+      const result = transformToUnifySurvey(createMockSurvey({ status: "completed" } as Partial<TSurvey>));
+      expect(result.status).toBe("completed");
+    });
+
+    test("maps unknown status to 'draft'", () => {
+      const result = transformToUnifySurvey(createMockSurvey({ status: "archived" } as Partial<TSurvey>));
+      expect(result.status).toBe("draft");
+    });
+  });
+
+  test("handles multiple blocks", () => {
+    const survey = createMockSurvey({
+      blocks: [
+        {
+          elements: [
+            {
+              id: "el-1",
+              type: TSurveyElementTypeEnum.OpenText,
+              headline: { default: "Q1" },
+              required: true,
+            },
+          ],
+        },
+        {
+          elements: [
+            { id: "el-2", type: TSurveyElementTypeEnum.Rating, headline: { default: "Q2" }, required: false },
+          ],
+        },
+      ],
+    } as Partial<TSurvey>);
+
+    const result = transformToUnifySurvey(survey);
+    expect(result.elements).toHaveLength(2);
+    expect(result.elements[0].id).toBe("el-1");
+    expect(result.elements[1].id).toBe("el-2");
+  });
+
+  test("handles empty blocks", () => {
+    const survey = createMockSurvey({ blocks: [] } as Partial<TSurvey>);
+    const result = transformToUnifySurvey(survey);
+    expect(result.elements).toEqual([]);
+  });
+
+  test("preserves all element types except CTA", () => {
+    const elementTypes = [
+      TSurveyElementTypeEnum.OpenText,
+      TSurveyElementTypeEnum.NPS,
+      TSurveyElementTypeEnum.Rating,
+      TSurveyElementTypeEnum.MultipleChoiceSingle,
+      TSurveyElementTypeEnum.MultipleChoiceMulti,
+      TSurveyElementTypeEnum.Date,
+      TSurveyElementTypeEnum.Consent,
+      TSurveyElementTypeEnum.Matrix,
+      TSurveyElementTypeEnum.Ranking,
+      TSurveyElementTypeEnum.PictureSelection,
+      TSurveyElementTypeEnum.ContactInfo,
+      TSurveyElementTypeEnum.Address,
+      TSurveyElementTypeEnum.FileUpload,
+      TSurveyElementTypeEnum.Cal,
+      TSurveyElementTypeEnum.CTA,
+    ];
+
+    const survey = createMockSurvey({
+      blocks: [
+        {
+          elements: elementTypes.map((type, i) => ({
+            id: `el-${i.toString()}`,
+            type,
+            headline: { default: `Question ${i.toString()}` },
+            required: false,
+          })),
+        },
+      ],
+    } as Partial<TSurvey>);
+
+    const result = transformToUnifySurvey(survey);
+    const resultTypes = result.elements.map((e) => e.type);
+
+    expect(resultTypes).not.toContain(TSurveyElementTypeEnum.CTA);
+    expect(result.elements).toHaveLength(elementTypes.length - 1);
+  });
+});

apps/web/app/(app)/workspaces/[workspaceId]/unify/sources/lib.ts

@@ -0,0 +1,51 @@
+import { TSurveyElement, TSurveyElementTypeEnum } from "@formbricks/types/surveys/elements";
+import { TSurvey } from "@formbricks/types/surveys/types";
+import { getTextContent } from "@formbricks/types/surveys/validation";
+import { getLocalizedValue } from "@/lib/i18n/utils";
+import { getElementsFromBlocks } from "@/lib/survey/utils";
+import { recallToHeadline } from "@/lib/utils/recall";
+import { TUnifySurvey, TUnifySurveyElement } from "./types";
+
+const getElementHeadline = (element: TSurveyElement, survey: TSurvey): string => {
+  return (
+    getTextContent(
+      getLocalizedValue(recallToHeadline(element.headline, survey, false, "default"), "default")
+    ) || "Untitled"
+  );
+};
+
+const mapSurveyStatus = (status: string): TUnifySurvey["status"] => {
+  switch (status) {
+    case "inProgress":
+      return "active";
+    case "paused":
+      return "paused";
+    case "draft":
+      return "draft";
+    case "completed":
+      return "completed";
+    default:
+      return "draft";
+  }
+};
+
+export const transformToUnifySurvey = (survey: TSurvey): TUnifySurvey => {
+  const elements = getElementsFromBlocks(survey.blocks);
+
+  const unifySurveyElements: TUnifySurveyElement[] = elements
+    .filter((el) => el.type !== TSurveyElementTypeEnum.CTA)
+    .map((el) => ({
+      id: el.id,
+      type: el.type,
+      headline: getElementHeadline(el, survey),
+      required: el.required ?? false,
+    }));
+
+  return {
+    id: survey.id,
+    name: survey.name,
+    status: mapSurveyStatus(survey.status),
+    elements: unifySurveyElements,
+    createdAt: survey.createdAt,
+  };
+};

apps/web/app/(app)/workspaces/[workspaceId]/unify/sources/page.tsx

@@ -0,0 +1,6 @@
+import { redirect } from "next/navigation";
+
+export default async function UnifySourcesPage(props: { params: Promise<{ workspaceId: string }> }) {
+  const params = await props.params;
+  redirect(`/workspaces/${params.workspaceId}/feedback-sources`);
+}

apps/web/app/(app)/workspaces/[workspaceId]/unify/sources/types.ts

@@ -0,0 +1,229 @@
+import { TFunction } from "i18next";
+import { z } from "zod";
+import { THubFieldType, ZHubFieldType } from "@formbricks/types/connector";
+import { TSurveyElementTypeEnum } from "@formbricks/types/surveys/constants";
+
+export interface TUnifySurveyElement {
+  id: string;
+  type: TSurveyElementTypeEnum;
+  headline: string;
+  required: boolean;
+}
+
+export interface TUnifySurvey {
+  id: string;
+  name: string;
+  status: "draft" | "active" | "paused" | "completed";
+  elements: TUnifySurveyElement[];
+  createdAt: Date;
+}
+
+export interface TFieldMapping {
+  targetFieldId: string;
+  sourceFieldId?: string;
+  staticValue?: string;
+}
+
+export type TTargetFieldType = "string" | "enum" | "timestamp" | "float64" | "boolean" | "jsonb" | "string[]";
+
+export interface TTargetField {
+  id: string;
+  name: string;
+  type: TTargetFieldType;
+  required: boolean;
+  description: string;
+  enumValues?: THubFieldType[];
+  exampleStaticValues?: string[];
+}
+
+export interface TSourceField {
+  id: string;
+  name: string;
+  type: string;
+  sampleValue?: string;
+}
+
+export const FEEDBACK_RECORD_FIELDS: TTargetField[] = [
+  {
+    id: "collected_at",
+    name: "Collected At",
+    type: "timestamp",
+    required: true,
+    description: "When the feedback was originally collected",
+  },
+  {
+    id: "source_type",
+    name: "Source Type",
+    type: "string",
+    required: true,
+    description: "Type of source (e.g., survey, review, support)",
+  },
+  {
+    id: "field_id",
+    name: "Field ID",
+    type: "string",
+    required: true,
+    description: "Unique question/field identifier",
+  },
+  {
+    id: "field_type",
+    name: "Field Type",
+    type: "enum",
+    required: true,
+    description: "Data type (text, nps, csat, rating, etc.)",
+    enumValues: ZHubFieldType.options,
+  },
+  {
+    id: "tenant_id",
+    name: "Tenant ID",
+    type: "string",
+    required: false,
+    description: "Tenant/organization identifier for multi-tenant deployments",
+  },
+  {
+    id: "submission_id",
+    name: "Submission ID",
+    type: "string",
+    required: false,
+    description:
+      "Optional. Map to a stable column (e.g. order_id, ticket_id) to enable idempotent re-imports. Auto-generated UUID per row if unmapped.",
+  },
+  {
+    id: "source_id",
+    name: "Source ID",
+    type: "string",
+    required: false,
+    description: "Reference to survey/form/ticket/review ID",
+  },
+  {
+    id: "source_name",
+    name: "Source Name",
+    type: "string",
+    required: false,
+    description: "Human-readable source name for display",
+  },
+  {
+    id: "field_label",
+    name: "Field Label",
+    type: "string",
+    required: false,
+    description: "Question text or field label for display",
+  },
+  {
+    id: "field_group_id",
+    name: "Field Group ID",
+    type: "string",
+    required: false,
+    description: "Stable identifier grouping related fields (for ranking, matrix, grid questions)",
+  },
+  {
+    id: "field_group_label",
+    name: "Field Group Label",
+    type: "string",
+    required: false,
+    description: "Human-readable question text for the group",
+  },
+  {
+    id: "value_text",
+    name: "Value (Text)",
+    type: "string",
+    required: false,
+    description: "Text responses (feedback, comments, open-ended answers)",
+  },
+  {
+    id: "value_number",
+    name: "Value (Number)",
+    type: "float64",
+    required: false,
+    description: "Numeric responses (ratings, scores, NPS, CSAT)",
+  },
+  {
+    id: "value_boolean",
+    name: "Value (Boolean)",
+    type: "boolean",
+    required: false,
+    description: "Yes/no responses",
+  },
+  {
+    id: "value_date",
+    name: "Value (Date)",
+    type: "timestamp",
+    required: false,
+    description: "Date/datetime responses",
+  },
+  {
+    id: "metadata",
+    name: "Metadata",
+    type: "jsonb",
+    required: false,
+    description: "Flexible context (device, location, campaign, custom fields)",
+  },
+  {
+    id: "language",
+    name: "Language",
+    type: "string",
+    required: false,
+    description: "ISO 639-1 language code (e.g., en, de, fr)",
+    exampleStaticValues: ["en", "de", "fr", "es", "pt", "ja", "zh"],
+  },
+  {
+    id: "user_identifier",
+    name: "User Identifier",
+    type: "string",
+    required: false,
+    description: "Anonymous user ID for tracking (hashed, never PII)",
+  },
+];
+
+export const SAMPLE_CSV_COLUMNS = "timestamp,customer_id,rating,feedback_text,category";
+
+export const MAX_CSV_VALUES = {
+  FILE_SIZE: 2_097_152, // 2MB (2 * 1024 * 1024)
+  RECORDS: 1_000, // 1,000 records
+} as const;
+
+export const createFeedbackCSVDataSchema = (t: TFunction) =>
+  z
+    .array(z.record(z.string(), z.string()))
+    .min(1, { message: t("workspace.unify.csv_at_least_one_row") })
+    .max(MAX_CSV_VALUES.RECORDS, {
+      message: t("workspace.unify.csv_max_records", {
+        max: MAX_CSV_VALUES.RECORDS.toLocaleString(),
+      }),
+    })
+    .superRefine((rows, ctx) => {
+      const localeSort = (a: string, b: string) => a.localeCompare(b);
+      const firstRowKeys = Object.keys(rows[0]).sort(localeSort).join(",");
+
+      for (let i = 1; i < rows.length; i++) {
+        const rowKeys = Object.keys(rows[i]).sort(localeSort).join(",");
+        if (rowKeys !== firstRowKeys) {
+          ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: t("workspace.unify.csv_inconsistent_columns", { row: (i + 1).toString() }),
+          });
+          return;
+        }
+      }
+
+      const emptyHeaders = Object.keys(rows[0]).filter((k) => k.trim() === "");
+      if (emptyHeaders.length > 0) {
+        ctx.addIssue({
+          code: z.ZodIssueCode.custom,
+          message: t("workspace.unify.csv_empty_column_headers"),
+        });
+      }
+    });
+
+export type TFeedbackCSVData = z.infer<ReturnType<typeof createFeedbackCSVDataSchema>>;
+
+export type TCreateConnectorStep = "selectType" | "mapping";
+
+export const ZFormbricksConnectorForm = z.object({
+  sourceName: z.string().trim().min(1),
+  surveyId: z.string().min(1),
+  selectedQuestionIds: z.array(z.string()).min(1),
+  importHistorical: z.boolean(),
+});
+
+export type TFormbricksConnectorForm = z.infer<typeof ZFormbricksConnectorForm>;

apps/web/app/(app)/workspaces/[workspaceId]/unify/sources/utils.test.ts

@@ -0,0 +1,232 @@
+import { describe, expect, test } from "vitest";
+import { MAX_CSV_VALUES, TFieldMapping, TSourceField } from "./types";
+import {
+  areAllRequiredFieldsMapped,
+  getConnectorOptions,
+  isConnectorNameValid,
+  parseCSVColumnsToFields,
+  toggleQuestionId,
+  validateCsvFile,
+} from "./utils";
+
+const mockT = (key: string) => key;
+
+describe("getConnectorOptions", () => {
+  test("returns formbricks, csv, api ingestion, and mcp options", () => {
+    const options = getConnectorOptions(mockT as never);
+    expect(options).toHaveLength(4);
+    expect(options[0].id).toBe("formbricks_survey");
+    expect(options[1].id).toBe("csv");
+    expect(options[2].id).toBe("api_ingestion");
+    expect(options[3].id).toBe("feedback_record_mcp");
+  });
+
+  test("both options are enabled by default", () => {
+    const options = getConnectorOptions(mockT as never);
+    expect(options.every((o) => !o.disabled)).toBe(true);
+  });
+
+  test("uses translation keys for name and description", () => {
+    const options = getConnectorOptions(mockT as never);
+    expect(options[0].name).toBe("workspace.unify.formbricks_surveys");
+    expect(options[0].description).toBe("workspace.unify.source_connect_formbricks_description");
+    expect(options[1].name).toBe("workspace.unify.csv_import");
+    expect(options[1].description).toBe("workspace.unify.source_connect_csv_description");
+    expect(options[2].name).toBe("workspace.unify.api_ingestion");
+    expect(options[2].description).toBe("workspace.unify.api_ingestion_settings_description");
+    expect(options[3].name).toBe("workspace.unify.feedback_record_mcp");
+    expect(options[3].description).toBe("workspace.unify.source_connect_feedback_record_mcp_description");
+  });
+});
+
+describe("parseCSVColumnsToFields", () => {
+  test("parses comma-separated column names into source fields", () => {
+    const result = parseCSVColumnsToFields("name,email,score");
+    expect(result).toHaveLength(3);
+    expect(result).toEqual<TSourceField[]>([
+      { id: "name", name: "name", type: "string", sampleValue: "Sample name" },
+      { id: "email", name: "email", type: "string", sampleValue: "Sample email" },
+      { id: "score", name: "score", type: "string", sampleValue: "Sample score" },
+    ]);
+  });
+
+  test("trims whitespace from column names", () => {
+    const result = parseCSVColumnsToFields(" name , email , score ");
+    expect(result[0].id).toBe("name");
+    expect(result[1].id).toBe("email");
+    expect(result[2].id).toBe("score");
+  });
+
+  test("handles single column", () => {
+    const result = parseCSVColumnsToFields("feedback");
+    expect(result).toHaveLength(1);
+    expect(result[0].id).toBe("feedback");
+  });
+
+  test("generates sample values from column names", () => {
+    const result = parseCSVColumnsToFields("rating,comment");
+    expect(result[0].sampleValue).toBe("Sample rating");
+    expect(result[1].sampleValue).toBe("Sample comment");
+  });
+});
+
+const createMockFile = (name: string, size: number, type: string): File =>
+  new File(["x".repeat(size)], name, { type });
+
+describe("validateCsvFile", () => {
+  test("accepts a valid .csv file", () => {
+    const file = createMockFile("data.csv", 1024, "text/csv");
+    const result = validateCsvFile(file, mockT as never);
+    expect(result).toEqual({ valid: true });
+  });
+
+  test("rejects a file without .csv extension", () => {
+    const file = createMockFile("data.xlsx", 1024, "text/csv");
+    const result = validateCsvFile(file, mockT as never);
+    expect(result).toEqual({ valid: false, error: "workspace.unify.csv_files_only" });
+  });
+
+  test("rejects a file with wrong MIME type", () => {
+    const file = createMockFile("data.csv", 1024, "application/json");
+    const result = validateCsvFile(file, mockT as never);
+    expect(result).toEqual({ valid: false, error: "workspace.unify.csv_files_only" });
+  });
+
+  test("accepts a .csv file with empty MIME type", () => {
+    const file = createMockFile("data.csv", 1024, "");
+    const result = validateCsvFile(file, mockT as never);
+    expect(result).toEqual({ valid: true });
+  });
+
+  test("accepts a .csv file with alternative csv MIME type", () => {
+    const file = createMockFile("report.csv", 512, "application/csv");
+    const result = validateCsvFile(file, mockT as never);
+    expect(result).toEqual({ valid: true });
+  });
+
+  test("rejects a file exceeding the size limit", () => {
+    const file = createMockFile("big.csv", MAX_CSV_VALUES.FILE_SIZE + 1, "text/csv");
+    const result = validateCsvFile(file, mockT as never);
+    expect(result).toEqual({ valid: false, error: "workspace.unify.csv_file_too_large" });
+  });
+
+  test("accepts a file exactly at the size limit", () => {
+    const file = createMockFile("exact.csv", MAX_CSV_VALUES.FILE_SIZE, "text/csv");
+    const result = validateCsvFile(file, mockT as never);
+    expect(result).toEqual({ valid: true });
+  });
+
+  test("checks extension before MIME type", () => {
+    const file = createMockFile("data.txt", 100, "text/csv");
+    const result = validateCsvFile(file, mockT as never);
+    expect(result).toEqual({ valid: false, error: "workspace.unify.csv_files_only" });
+  });
+});
+
+describe("isConnectorNameValid", () => {
+  test("returns true for non-empty name", () => {
+    expect(isConnectorNameValid("My Connector")).toBe(true);
+  });
+
+  test("returns false for empty string", () => {
+    expect(isConnectorNameValid("")).toBe(false);
+  });
+
+  test("returns false for whitespace-only string", () => {
+    expect(isConnectorNameValid("   ")).toBe(false);
+    expect(isConnectorNameValid("\t\n  ")).toBe(false);
+  });
+
+  test("returns true for name with surrounding whitespace", () => {
+    expect(isConnectorNameValid("  name  ")).toBe(true);
+  });
+
+  test("returns true for single character", () => {
+    expect(isConnectorNameValid("a")).toBe(true);
+  });
+});
+
+describe("areAllRequiredFieldsMapped", () => {
+  const requiredMappings: TFieldMapping[] = [
+    { targetFieldId: "collected_at", sourceFieldId: "ts" },
+    { targetFieldId: "source_type", staticValue: "csv" },
+    { targetFieldId: "field_id", sourceFieldId: "qid" },
+    { targetFieldId: "field_type", staticValue: "text" },
+  ];
+
+  test("returns true when all required fields have a sourceFieldId or staticValue", () => {
+    expect(areAllRequiredFieldsMapped(requiredMappings)).toBe(true);
+  });
+
+  test("returns false when a required field is missing entirely", () => {
+    const missing = requiredMappings.slice(0, 3);
+    expect(areAllRequiredFieldsMapped(missing)).toBe(false);
+  });
+
+  test("returns false when a required mapping has neither sourceFieldId nor staticValue", () => {
+    const incomplete: TFieldMapping[] = [...requiredMappings.slice(0, 3), { targetFieldId: "field_type" }];
+    expect(areAllRequiredFieldsMapped(incomplete)).toBe(false);
+  });
+
+  test("ignores mappings for non-required target fields", () => {
+    const withOptionals: TFieldMapping[] = [
+      ...requiredMappings,
+      { targetFieldId: "tenant_id", sourceFieldId: "tenant" },
+      { targetFieldId: "unknown_field", sourceFieldId: "anything" },
+    ];
+    expect(areAllRequiredFieldsMapped(withOptionals)).toBe(true);
+  });
+
+  test("returns false for empty mappings array", () => {
+    expect(areAllRequiredFieldsMapped([])).toBe(false);
+  });
+
+  test("treats empty staticValue and missing sourceFieldId as unmapped", () => {
+    const incomplete: TFieldMapping[] = [
+      { targetFieldId: "collected_at", sourceFieldId: "ts" },
+      { targetFieldId: "source_type", sourceFieldId: "", staticValue: "" },
+      { targetFieldId: "field_id", sourceFieldId: "qid" },
+      { targetFieldId: "field_type", staticValue: "text" },
+    ];
+    expect(areAllRequiredFieldsMapped(incomplete)).toBe(false);
+  });
+
+  test("counts required field as mapped when only staticValue is set", () => {
+    const onlyStatic: TFieldMapping[] = [
+      { targetFieldId: "collected_at", staticValue: "2026-01-01" },
+      { targetFieldId: "source_type", staticValue: "csv" },
+      { targetFieldId: "field_id", staticValue: "id" },
+      { targetFieldId: "field_type", staticValue: "text" },
+    ];
+    expect(areAllRequiredFieldsMapped(onlyStatic)).toBe(true);
+  });
+});
+
+describe("toggleQuestionId", () => {
+  test("adds id when not present", () => {
+    expect(toggleQuestionId(["a", "b"], "c")).toEqual(["a", "b", "c"]);
+  });
+
+  test("removes id when present", () => {
+    expect(toggleQuestionId(["a", "b", "c"], "b")).toEqual(["a", "c"]);
+  });
+
+  test("adds to empty selection", () => {
+    expect(toggleQuestionId([], "x")).toEqual(["x"]);
+  });
+
+  test("returns empty when removing the only id", () => {
+    expect(toggleQuestionId(["only"], "only")).toEqual([]);
+  });
+
+  test("does not mutate the input array", () => {
+    const input = ["a", "b"];
+    const result = toggleQuestionId(input, "c");
+    expect(input).toEqual(["a", "b"]);
+    expect(result).not.toBe(input);
+  });
+
+  test("removes only the matching id when duplicates exist", () => {
+    expect(toggleQuestionId(["a", "b", "a"], "a")).toEqual(["b"]);
+  });
+});

apps/web/app/(app)/workspaces/[workspaceId]/unify/sources/utils.ts

@@ -0,0 +1,133 @@
+import { TFunction } from "i18next";
+import { TConnectorType, THubFieldType } from "@formbricks/types/connector";
+import { FEEDBACK_RECORD_FIELDS, MAX_CSV_VALUES, TFieldMapping, TSourceField } from "./types";
+
+export type TConnectorOptionId = TConnectorType | "api_ingestion" | "feedback_record_mcp";
+
+export interface TConnectorOption {
+  id: TConnectorOptionId;
+  name: string;
+  description: string;
+  disabled: boolean;
+  badge?: { text: string; type: "success" | "gray" | "warning" };
+}
+
+export const getConnectorOptions = (t: TFunction): TConnectorOption[] => [
+  {
+    id: "formbricks_survey",
+    name: t("workspace.unify.formbricks_surveys"),
+    description: t("workspace.unify.source_connect_formbricks_description"),
+    disabled: false,
+  },
+  {
+    id: "csv",
+    name: t("workspace.unify.csv_import"),
+    description: t("workspace.unify.source_connect_csv_description"),
+    disabled: false,
+  },
+  {
+    id: "api_ingestion",
+    name: t("workspace.unify.api_ingestion"),
+    description: t("workspace.unify.api_ingestion_settings_description"),
+    disabled: false,
+  },
+  {
+    id: "feedback_record_mcp",
+    name: t("workspace.unify.feedback_record_mcp"),
+    description: t("workspace.unify.source_connect_feedback_record_mcp_description"),
+    disabled: false,
+  },
+];
+
+export const parseCSVColumnsToFields = (columns: string): TSourceField[] => {
+  return columns.split(",").map((col) => {
+    const trimmed = col.trim();
+    return { id: trimmed, name: trimmed, type: "string", sampleValue: `Sample ${trimmed}` };
+  });
+};
+
+export interface TEnumValidationError {
+  targetFieldName: string;
+  invalidEntries: { row: number; value: string }[];
+  allowedValues: string[];
+}
+
+/**
+ * Validates that CSV columns mapped to enum target fields contain only allowed values.
+ * Returns an array of validation errors (empty if all valid).
+ */
+export const validateEnumMappings = (
+  mappings: TFieldMapping[],
+  csvData: Record<string, string>[]
+): TEnumValidationError[] => {
+  const errors: TEnumValidationError[] = [];
+
+  for (const mapping of mappings) {
+    if (!mapping.sourceFieldId || mapping.staticValue) continue;
+
+    const targetField = FEEDBACK_RECORD_FIELDS.find((f) => f.id === mapping.targetFieldId);
+    if (targetField?.type !== "enum" || !targetField?.enumValues) continue;
+
+    const allowedValues = new Set(targetField.enumValues);
+    const invalidEntries: { row: number; value: string }[] = [];
+
+    for (let i = 0; i < csvData.length; i++) {
+      const value = csvData[i][mapping.sourceFieldId]?.trim();
+      if (value && !allowedValues.has(value as THubFieldType)) {
+        invalidEntries.push({ row: i + 1, value });
+      }
+    }
+
+    if (invalidEntries.length > 0) {
+      errors.push({
+        targetFieldName: targetField.name,
+        invalidEntries,
+        allowedValues: targetField.enumValues,
+      });
+    }
+  }
+
+  return errors;
+};
+
+export const isConnectorNameValid = (name: string): boolean => name.trim().length > 0;
+
+export const areAllRequiredFieldsMapped = (mappings: TFieldMapping[]): boolean => {
+  const requiredFieldIds = new Set(
+    FEEDBACK_RECORD_FIELDS.filter((field) => field.required).map((field) => field.id)
+  );
+
+  for (const mapping of mappings) {
+    if (!requiredFieldIds.has(mapping.targetFieldId)) {
+      continue;
+    }
+
+    if (mapping.sourceFieldId || mapping.staticValue) {
+      requiredFieldIds.delete(mapping.targetFieldId);
+    }
+  }
+
+  return requiredFieldIds.size === 0;
+};
+
+export const toggleQuestionId = (currentSelection: string[], questionId: string): string[] => {
+  return currentSelection.includes(questionId)
+    ? currentSelection.filter((id) => id !== questionId)
+    : [...currentSelection, questionId];
+};
+
+export const validateCsvFile = (
+  file: File,
+  t: TFunction
+): { valid: true } | { valid: false; error: string } => {
+  if (!file.name.endsWith(".csv")) {
+    return { valid: false, error: t("workspace.unify.csv_files_only") };
+  }
+  if (file.type && file.type !== "text/csv" && !file.type.includes("csv")) {
+    return { valid: false, error: t("workspace.unify.csv_files_only") };
+  }
+  if (file.size > MAX_CSV_VALUES.FILE_SIZE) {
+    return { valid: false, error: t("workspace.unify.csv_file_too_large") };
+  }
+  return { valid: true };
+};

apps/web/app/api/(internal)/pipeline/route.ts

@@ -1,309 +0,0 @@
-import { PipelineTriggers, Webhook } from "@prisma/client";
-import { headers } from "next/headers";
-import { v7 as uuidv7 } from "uuid";
-import { prisma } from "@formbricks/database";
-import { logger } from "@formbricks/logger";
-import { ResourceNotFoundError } from "@formbricks/types/errors";
-import { sendTelemetryEvents } from "@/app/api/(internal)/pipeline/lib/telemetry";
-import { ZPipelineInput } from "@/app/api/(internal)/pipeline/types/pipelines";
-import { responses } from "@/app/lib/api/response";
-import { transformErrorToDetails } from "@/app/lib/api/validator";
-import { CRON_SECRET, POSTHOG_KEY } from "@/lib/constants";
-import { generateStandardWebhookSignature } from "@/lib/crypto";
-import { getIntegrations } from "@/lib/integration/service";
-import { getOrganization } from "@/lib/organization/service";
-import { getResponseCountBySurveyId } from "@/lib/response/service";
-import { getSurvey, updateSurvey } from "@/lib/survey/service";
-import { convertDatesInObject } from "@/lib/time";
-import { getOrganizationIdFromWorkspaceId } from "@/lib/utils/helper";
-import { validateWebhookUrl } from "@/lib/utils/validate-webhook-url";
-import { queueAuditEvent } from "@/modules/ee/audit-logs/lib/handler";
-import { TAuditStatus, UNKNOWN_DATA } from "@/modules/ee/audit-logs/types/audit-log";
-import { recordResponseCreatedMeterEvent } from "@/modules/ee/billing/lib/metering";
-import { sendResponseFinishedEmail } from "@/modules/email";
-import { resolveStorageUrlsInObject } from "@/modules/storage/utils";
-import { sendFollowUpsForResponse } from "@/modules/survey/follow-ups/lib/follow-ups";
-import { FollowUpSendError } from "@/modules/survey/follow-ups/types/follow-up";
-import { handleIntegrations } from "./lib/handleIntegrations";
-import { captureSurveyResponsePostHogEvent } from "./lib/posthog";
-
-export const POST = async (request: Request) => {
-  const requestHeaders = await headers();
-  // Check authentication
-  if (requestHeaders.get("x-api-key") !== CRON_SECRET) {
-    return responses.notAuthenticatedResponse();
-  }
-
-  const jsonInput = await request.json();
-  const convertedJsonInput = convertDatesInObject(
-    jsonInput,
-    new Set(["contactAttributes", "variables", "data", "meta"])
-  );
-  const inputValidation = ZPipelineInput.safeParse(convertedJsonInput);
-
-  if (!inputValidation.success) {
-    logger.error(
-      { error: inputValidation.error, url: request.url },
-      "Error in POST /api/(internal)/pipeline"
-    );
-    return responses.badRequestResponse(
-      "Fields are missing or incorrectly formatted",
-      transformErrorToDetails(inputValidation.error),
-      true
-    );
-  }
-
-  const { workspaceId, surveyId, event, response } = inputValidation.data;
-
-  const organizationId = await getOrganizationIdFromWorkspaceId(workspaceId);
-  const organization = await getOrganization(organizationId);
-  if (!organization) {
-    throw new ResourceNotFoundError("Organization", "Organization not found");
-  }
-
-  // Fetch survey for webhook payload
-  const survey = await getSurvey(surveyId);
-  if (!survey) {
-    logger.error({ url: request.url, surveyId }, `Survey with id ${surveyId} not found`);
-
-    return responses.notFoundResponse("Survey", surveyId, true);
-  }
-
-  if (survey.workspaceId !== workspaceId) {
-    logger.error(
-      { url: request.url, surveyId, workspaceId, surveyWorkspaceId: survey.workspaceId },
-      `Survey ${surveyId} does not belong to workspace ${workspaceId}`
-    );
-    return responses.badRequestResponse("Survey not found in this workspace");
-  }
-
-  // Fetch webhooks
-  const getWebhooksForPipeline = async (workspaceId: string, event: PipelineTriggers, surveyId: string) => {
-    const webhooks = await prisma.webhook.findMany({
-      where: {
-        workspaceId,
-        triggers: { has: event },
-        OR: [{ surveyIds: { has: surveyId } }, { surveyIds: { isEmpty: true } }],
-      },
-    });
-    return webhooks;
-  };
-
-  const webhooks: Webhook[] = await getWebhooksForPipeline(workspaceId, event, surveyId);
-  // Prepare webhook and email promises
-
-  // Fetch with timeout of 5 seconds to prevent hanging
-  const fetchWithTimeout = (url: string, options: RequestInit, timeout: number = 5000): Promise<Response> => {
-    return Promise.race([
-      fetch(url, options),
-      new Promise<never>((_, reject) => setTimeout(() => reject(new Error("Timeout")), timeout)),
-    ]);
-  };
-
-  const resolvedResponseData = resolveStorageUrlsInObject(response.data);
-
-  const webhookPromises = webhooks.map((webhook) => {
-    const body = JSON.stringify({
-      webhookId: webhook.id,
-      event,
-      data: {
-        ...response,
-        data: resolvedResponseData,
-        survey: {
-          title: survey.name,
-          type: survey.type,
-          status: survey.status,
-          createdAt: survey.createdAt,
-          updatedAt: survey.updatedAt,
-        },
-      },
-    });
-
-    // Generate Standard Webhooks headers
-    const webhookMessageId = uuidv7();
-    const webhookTimestamp = Math.floor(Date.now() / 1000);
-
-    const requestHeaders: Record<string, string> = {
-      "content-type": "application/json",
-      "webhook-id": webhookMessageId,
-      "webhook-timestamp": webhookTimestamp.toString(),
-    };
-
-    // Add signature if webhook has a secret configured
-    if (webhook.secret) {
-      requestHeaders["webhook-signature"] = generateStandardWebhookSignature(
-        webhookMessageId,
-        webhookTimestamp,
-        body,
-        webhook.secret
-      );
-    }
-
-    return validateWebhookUrl(webhook.url)
-      .then(() =>
-        fetchWithTimeout(webhook.url, {
-          method: "POST",
-          headers: requestHeaders,
-          body,
-        })
-      )
-      .catch((error) => {
-        logger.error({ error, url: request.url }, `Webhook call to ${webhook.url} failed`);
-      });
-  });
-
-  if (event === "responseFinished") {
-    // Fetch integrations and responseCount in parallel
-    const [integrations, responseCount] = await Promise.all([
-      getIntegrations(workspaceId),
-      getResponseCountBySurveyId(surveyId),
-    ]);
-
-    if (integrations.length > 0) {
-      await handleIntegrations(integrations, inputValidation.data, survey);
-    }
-
-    // Fetch users with notifications in a single query
-    const usersWithNotifications = await prisma.user.findMany({
-      where: {
-        memberships: {
-          some: {
-            organization: {
-              workspaces: {
-                some: {
-                  id: workspaceId,
-                },
-              },
-            },
-          },
-        },
-        OR: [
-          {
-            memberships: {
-              every: {
-                role: {
-                  in: ["owner", "manager"],
-                },
-              },
-            },
-          },
-          {
-            teamUsers: {
-              some: {
-                team: {
-                  workspaceTeams: {
-                    some: {
-                      workspace: {
-                        id: workspaceId,
-                      },
-                    },
-                  },
-                },
-              },
-            },
-          },
-        ],
-        notificationSettings: {
-          path: ["alert", surveyId],
-          equals: true,
-        },
-      },
-      select: { email: true, locale: true },
-    });
-
-    if (survey.followUps?.length > 0) {
-      // send follow up emails
-      const followUpsResult = await sendFollowUpsForResponse(response.id);
-      if (!followUpsResult.ok) {
-        const { error: followUpsError } = followUpsResult;
-        if (followUpsError.code !== FollowUpSendError.FOLLOW_UP_NOT_ALLOWED) {
-          logger.error({ error: followUpsError }, `Failed to send follow-up emails for survey ${surveyId}`);
-        }
-      }
-    }
-
-    const emailPromises = usersWithNotifications.map((user) =>
-      sendResponseFinishedEmail(user.email, user.locale, workspaceId, survey, response, responseCount).catch(
-        (error) => {
-          logger.error(
-            { error, url: request.url, userEmail: user.email },
-            `Failed to send email to ${user.email}`
-          );
-        }
-      )
-    );
-
-    // Update survey status if necessary
-    if (survey.autoComplete && responseCount >= survey.autoComplete) {
-      let logStatus: TAuditStatus = "success";
-
-      try {
-        await updateSurvey({
-          ...survey,
-          status: "completed",
-        });
-      } catch (error) {
-        logStatus = "failure";
-        logger.error(
-          { error, url: request.url, surveyId },
-          `Failed to update survey ${surveyId} status to completed`
-        );
-      } finally {
-        await queueAuditEvent({
-          status: logStatus,
-          action: "updated",
-          targetType: "survey",
-          userId: UNKNOWN_DATA,
-          userType: "system",
-          targetId: survey.id,
-          organizationId: organization.id,
-          newObject: {
-            status: "completed",
-          },
-        });
-      }
-    }
-
-    // Await webhook and email promises with allSettled to prevent early rejection
-    const results = await Promise.allSettled([...webhookPromises, ...emailPromises]);
-    results.forEach((result) => {
-      if (result.status === "rejected") {
-        logger.error({ error: result.reason, url: request.url }, "Promise rejected");
-      }
-    });
-  } else {
-    // Await webhook promises if no emails are sent (with allSettled to prevent early rejection)
-    const results = await Promise.allSettled(webhookPromises);
-    results.forEach((result) => {
-      if (result.status === "rejected") {
-        logger.error({ error: result.reason, url: request.url }, "Promise rejected");
-      }
-    });
-  }
-  if (event === "responseCreated") {
-    recordResponseCreatedMeterEvent({
-      stripeCustomerId: organization.billing.stripeCustomerId,
-      responseId: response.id,
-      createdAt: response.createdAt,
-    }).catch((error) => {
-      logger.error({ error, responseId: response.id }, "Failed to record response meter event");
-    });
-
-    if (POSTHOG_KEY) {
-      const responseCount = await getResponseCountBySurveyId(surveyId);
-
-      captureSurveyResponsePostHogEvent({
-        organizationId: organization.id,
-        surveyId,
-        surveyType: survey.type,
-        workspaceId,
-        responseCount,
-      });
-    }
-
-    // Send telemetry events
-    await sendTelemetryEvents();
-  }
-
-  return Response.json({ data: {} });
-};

apps/web/app/api/(internal)/pipeline/types/pipelines.ts

@@ -1,12 +0,0 @@
-import { z } from "zod";
-import { ZWebhook } from "@formbricks/database/zod/webhooks";
-import { ZResponse } from "@formbricks/types/responses";
-
-export const ZPipelineInput = z.object({
-  event: ZWebhook.shape.triggers.element,
-  response: ZResponse,
-  workspaceId: z.string(),
-  surveyId: z.string(),
-});
-
-export type TPipelineInput = z.infer<typeof ZPipelineInput>;

apps/web/app/api/v1/client/[workspaceId]/displays/[displayId]/response/lib/response.test.ts

@@ -0,0 +1,98 @@
+import { Prisma } from "@prisma/client";
+import { beforeEach, describe, expect, test, vi } from "vitest";
+import { prisma } from "@formbricks/database";
+import { DatabaseError, ResourceNotFoundError, ValidationError } from "@formbricks/types/errors";
+import { validateInputs } from "@/lib/utils/validate";
+import { getResponseIdByDisplayId } from "./response";
+
+vi.mock("@/lib/utils/validate", () => ({
+  validateInputs: vi.fn((inputs: [unknown, unknown][]) =>
+    inputs.map((input: [unknown, unknown]) => input[0])
+  ),
+}));
+
+vi.mock("@formbricks/database", () => ({
+  prisma: {
+    display: {
+      findFirst: vi.fn(),
+    },
+  },
+}));
+
+describe("getResponseIdByDisplayId", () => {
+  const workspaceId = "ws1234567890123456789012";
+  const displayId = "display1234567890123456789";
+
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+
+  test("returns the linked responseId when a response exists", async () => {
+    vi.mocked(prisma.display.findFirst).mockResolvedValue({
+      response: {
+        id: "response123456789012345678",
+      },
+    } as any);
+
+    const result = await getResponseIdByDisplayId(workspaceId, displayId);
+
+    expect(validateInputs).toHaveBeenCalledWith(
+      [workspaceId, expect.any(Object)],
+      [displayId, expect.any(Object)]
+    );
+    expect(prisma.display.findFirst).toHaveBeenCalledWith({
+      where: {
+        id: displayId,
+        survey: {
+          workspaceId,
+        },
+      },
+      select: {
+        response: {
+          select: {
+            id: true,
+          },
+        },
+      },
+    });
+    expect(result).toEqual({ responseId: "response123456789012345678" });
+  });
+
+  test("returns null when the display exists but has no response", async () => {
+    vi.mocked(prisma.display.findFirst).mockResolvedValue({
+      response: null,
+    } as any);
+
+    await expect(getResponseIdByDisplayId(workspaceId, displayId)).resolves.toEqual({
+      responseId: null,
+    });
+  });
+
+  test("throws ResourceNotFoundError when the display does not exist in the workspace", async () => {
+    vi.mocked(prisma.display.findFirst).mockResolvedValue(null);
+
+    await expect(getResponseIdByDisplayId(workspaceId, displayId)).rejects.toThrow(
+      new ResourceNotFoundError("Display", displayId)
+    );
+  });
+
+  test("throws ValidationError when input validation fails", async () => {
+    const validationError = new ValidationError("Validation failed");
+    vi.mocked(validateInputs).mockImplementation(() => {
+      throw validationError;
+    });
+
+    await expect(getResponseIdByDisplayId(workspaceId, displayId)).rejects.toThrow(ValidationError);
+    expect(prisma.display.findFirst).not.toHaveBeenCalled();
+  });
+
+  test("throws DatabaseError on Prisma request errors", async () => {
+    const prismaError = new Prisma.PrismaClientKnownRequestError("Database error", {
+      code: "P2002",
+      clientVersion: "test",
+    });
+    vi.mocked(prisma.display.findFirst).mockRejectedValue(prismaError);
+
+    await expect(getResponseIdByDisplayId(workspaceId, displayId)).rejects.toThrow(DatabaseError);
+  });
+});

apps/web/app/api/v1/client/[workspaceId]/displays/[displayId]/response/lib/response.ts

@@ -0,0 +1,44 @@
+import { Prisma } from "@prisma/client";
+import { prisma } from "@formbricks/database";
+import { ZId } from "@formbricks/types/common";
+import { DatabaseError, ResourceNotFoundError } from "@formbricks/types/errors";
+import { validateInputs } from "@/lib/utils/validate";
+
+export const getResponseIdByDisplayId = async (
+  workspaceId: string,
+  displayId: string
+): Promise<{ responseId: string | null }> => {
+  validateInputs([workspaceId, ZId], [displayId, ZId]);
+
+  try {
+    const display = await prisma.display.findFirst({
+      where: {
+        id: displayId,
+        survey: {
+          workspaceId,
+        },
+      },
+      select: {
+        response: {
+          select: {
+            id: true,
+          },
+        },
+      },
+    });
+
+    if (!display) {
+      throw new ResourceNotFoundError("Display", displayId);
+    }
+
+    return {
+      responseId: display.response?.id ?? null,
+    };
+  } catch (error) {
+    if (error instanceof Prisma.PrismaClientKnownRequestError) {
+      throw new DatabaseError(error.message);
+    }
+
+    throw error;
+  }
+};

apps/web/app/api/v1/client/[workspaceId]/displays/[displayId]/response/route.ts

@@ -0,0 +1,49 @@
+import { logger } from "@formbricks/logger";
+import { ResourceNotFoundError } from "@formbricks/types/errors";
+import { responses } from "@/app/lib/api/response";
+import { THandlerParams, withV1ApiWrapper } from "@/app/lib/api/with-api-logging";
+import { resolveClientApiIds } from "@/lib/utils/resolve-client-id";
+import { getResponseIdByDisplayId } from "./lib/response";
+
+export const OPTIONS = async (): Promise<Response> => {
+  return responses.successResponse({}, true);
+};
+
+export const GET = withV1ApiWrapper({
+  handler: async ({
+    req,
+    props,
+  }: THandlerParams<{ params: Promise<{ workspaceId: string; displayId: string }> }>) => {
+    const params = await props.params;
+
+    const resolved = await resolveClientApiIds(params.workspaceId);
+    if (!resolved) {
+      return {
+        response: responses.notFoundResponse("Workspace", params.workspaceId, true),
+      };
+    }
+    const { workspaceId } = resolved;
+
+    try {
+      const response = await getResponseIdByDisplayId(workspaceId, params.displayId);
+
+      return {
+        response: responses.successResponse(response, true),
+      };
+    } catch (error) {
+      if (error instanceof ResourceNotFoundError) {
+        return {
+          response: responses.notFoundResponse("Display", params.displayId, true),
+        };
+      }
+
+      logger.error(
+        { error, url: req.url, workspaceId, displayId: params.displayId },
+        "Error in GET /api/v1/client/[workspaceId]/displays/[displayId]/response"
+      );
+      return {
+        response: responses.internalServerErrorResponse("Something went wrong. Please try again."),
+      };
+    }
+  },
+});

apps/web/app/api/v1/client/[workspaceId]/environment/lib/environmentState.test.ts

@@ -33,10 +33,13 @@ vi.mock("@formbricks/logger", () => ({
 vi.mock("./data");
 vi.mock("@/app/lib/api/api-backwards-compat", () => ({
   addLegacyProjectOverwritesToList: vi.fn((surveys: unknown[]) =>
-    surveys.map((s: Record<string, unknown>) => ({
-      ...s,
-      projectOverwrites: s.workspaceOverwrites ?? null,
-    }))
+    surveys.map((survey) => {
+      const typedSurvey = survey as Record<string, unknown>;
+      return {
+        ...typedSurvey,
+        projectOverwrites: typedSurvey.workspaceOverwrites ?? null,
+      };
+    })
   ),
   addLegacyProjectToEnvironmentState: vi.fn((data: Record<string, unknown>) => ({
     ...data,
@@ -129,7 +132,7 @@ const mockActionClasses = [
     description: null,
     type: "code",
     noCodeConfig: null,
-    environmentId: workspaceId,
+    workspaceId,
     key: "action1",
   },
 ] as unknown as TActionClass[];

apps/web/app/api/v1/client/[workspaceId]/responses/[responseId]/lib/put-response-handler.ts

@@ -254,7 +254,7 @@ export const putResponseHandler = async ({
 
   const { quotaFull, ...responseData } = updatedResponse;
 
-  sendToPipeline({
+  await sendToPipeline({
     event: "responseUpdated",
     workspaceId: survey.workspaceId,
     surveyId: survey.id,
@@ -262,7 +262,7 @@ export const putResponseHandler = async ({
   });
 
   if (updatedResponse.finished) {
-    sendToPipeline({
+    await sendToPipeline({
       event: "responseFinished",
       workspaceId: survey.workspaceId,
       surveyId: survey.id,

apps/web/app/api/v1/client/[workspaceId]/responses/route.ts

@@ -126,7 +126,6 @@ export const POST = withV1ApiWrapper({
         response: responses.badRequestResponse(
           "Survey is part of another workspace",
           {
-            "survey.workspaceId": survey.workspaceId,
             workspaceId,
           },
           true
@@ -187,7 +186,7 @@ export const POST = withV1ApiWrapper({
 
     const { quotaFull, ...responseData } = response;
 
-    sendToPipeline({
+    await sendToPipeline({
       event: "responseCreated",
       workspaceId,
       surveyId: responseData.surveyId,
@@ -195,7 +194,7 @@ export const POST = withV1ApiWrapper({
     });
 
     if (responseInput.finished) {
-      sendToPipeline({
+      await sendToPipeline({
         event: "responseFinished",
         workspaceId,
         surveyId: responseData.surveyId,

apps/web/app/api/v1/management/me/route.ts

@@ -15,20 +15,14 @@ const apiKeySelect = {
   lastUsedAt: true,
   apiKeyWorkspaces: {
     select: {
-      environment: {
+      workspace: {
         select: {
           id: true,
-          type: true,
+          legacyEnvironmentId: true,
           createdAt: true,
           updatedAt: true,
-          workspaceId: true,
+          name: true,
           appSetupCompleted: true,
-          workspace: {
-            select: {
-              id: true,
-              name: true,
-            },
-          },
         },
       },
       permission: true,
@@ -44,17 +38,13 @@ type ApiKeyData = {
   lastUsedAt: Date | null;
   apiKeyWorkspaces: Array<{
     permission: string;
-    environment: {
+    workspace: {
       id: string;
-      type: string;
+      legacyEnvironmentId: string | null;
       createdAt: Date;
       updatedAt: Date;
-      workspaceId: string;
+      name: string;
       appSetupCompleted: boolean;
-      workspace: {
-        id: string;
-        name: string;
-      };
     };
   }>;
 };
@@ -116,21 +106,24 @@ const updateApiKeyUsage = async (apiKeyId: string) => {
   });
 };
 
-const buildEnvironmentResponse = (apiKeyData: ApiKeyData) => {
-  const env = apiKeyData.apiKeyWorkspaces[0].environment;
+const buildWorkspaceResponse = (apiKeyData: ApiKeyData) => {
+  const workspace = apiKeyData.apiKeyWorkspaces[0].workspace;
   return Response.json({
-    id: env.id,
-    type: env.type,
-    createdAt: env.createdAt,
-    updatedAt: env.updatedAt,
-    appSetupCompleted: env.appSetupCompleted,
+    // Keep v1 payload shape stable while sourcing data from workspace.
+    id: workspace.legacyEnvironmentId ?? workspace.id,
+    type: "production",
+    createdAt: workspace.createdAt,
+    updatedAt: workspace.updatedAt,
+    appSetupCompleted: workspace.appSetupCompleted,
     workspace: {
-      id: env.workspaceId,
-      name: env.workspace.name,
+      id: workspace.id,
+      name: workspace.name,
     },
     // Backwards compat: old consumers expect project fields
-    projectId: env.workspaceId,
-    projectName: env.workspace.name,
+    project: {
+      id: workspace.id,
+      name: workspace.name,
+    },
   });
 };
 
@@ -162,7 +155,7 @@ const handleApiKeyAuthentication = async (apiKey: string) => {
     return responses.badRequestResponse("You can't use this method with this API key");
   }
 
-  return buildEnvironmentResponse(apiKeyData);
+  return buildWorkspaceResponse(apiKeyData);
 };
 
 const handleSessionAuthentication = async () => {

apps/web/app/api/v1/management/responses/[responseId]/route.ts

@@ -169,7 +169,7 @@ export const PUT = withV1ApiWrapper({
         auditLog.newObject = updated;
       }
 
-      sendToPipeline({
+      await sendToPipeline({
         event: "responseUpdated",
         workspaceId: result.survey.workspaceId,
         surveyId: result.survey.id,
@@ -177,7 +177,7 @@ export const PUT = withV1ApiWrapper({
       });
 
       if (updated.finished) {
-        sendToPipeline({
+        await sendToPipeline({
           event: "responseFinished",
           workspaceId: result.survey.workspaceId,
           surveyId: result.survey.id,

apps/web/app/api/v1/management/responses/route.ts

@@ -73,7 +73,6 @@ const validateSurvey = async (responseInput: TResponseInput, workspaceId: string
       error: responses.badRequestResponse(
         "Survey is part of another workspace",
         {
-          "survey.workspaceId": survey.workspaceId,
           workspaceId,
         },
         true
@@ -166,7 +165,7 @@ export const POST = withV1ApiWrapper({
           auditLog.newObject = response;
         }
 
-        sendToPipeline({
+        await sendToPipeline({
           event: "responseCreated",
           workspaceId: surveyResult.survey.workspaceId,
           surveyId: response.surveyId,
@@ -174,7 +173,7 @@ export const POST = withV1ApiWrapper({
         });
 
         if (response.finished) {
-          sendToPipeline({
+          await sendToPipeline({
             event: "responseFinished",
             workspaceId: surveyResult.survey.workspaceId,
             surveyId: response.surveyId,

apps/web/app/api/v1/management/surveys/[surveyId]/lib/surveys.test.ts

@@ -1,43 +1,16 @@
-import { Prisma } from "@prisma/client";
 import { afterEach, beforeEach, describe, expect, test, vi } from "vitest";
-import { prisma } from "@formbricks/database";
-import { logger } from "@formbricks/logger";
-import { DatabaseError } from "@formbricks/types/errors";
-import { validateInputs } from "@/lib/utils/validate";
 import { deleteSurvey } from "./surveys";
 
-vi.mock("@/lib/utils/validate", () => ({
-  validateInputs: vi.fn(),
+const { mockDeleteSharedSurvey } = vi.hoisted(() => ({
+  mockDeleteSharedSurvey: vi.fn(),
 }));
-vi.mock("@formbricks/database", () => ({
-  prisma: {
-    survey: {
-      delete: vi.fn(),
-    },
-    segment: {
-      delete: vi.fn(),
-    },
-  },
-}));
-vi.mock("@formbricks/logger", () => ({
-  logger: {
-    error: vi.fn(),
-  },
+
+vi.mock("@/modules/survey/lib/surveys", () => ({
+  deleteSurvey: mockDeleteSharedSurvey,
 }));
 
 const surveyId = "clq5n7p1q0000m7z0h5p6g3r2";
 const workspaceId = "clq5n7p1q0000m7z0h5p6g3r3";
-const segmentId = "clq5n7p1q0000m7z0h5p6g3r4";
-const actionClassId1 = "clq5n7p1q0000m7z0h5p6g3r5";
-const actionClassId2 = "clq5n7p1q0000m7z0h5p6g3r6";
-
-const mockDeletedSurveyAppPrivateSegment = {
-  id: surveyId,
-  workspaceId,
-  type: "app",
-  segment: { id: segmentId, isPrivate: true },
-  triggers: [{ actionClass: { id: actionClassId1 } }, { actionClass: { id: actionClassId2 } }],
-};
 
 const mockDeletedSurveyLink = {
   id: surveyId,
@@ -56,66 +29,20 @@ describe("deleteSurvey", () => {
     vi.clearAllMocks();
   });
 
-  test("should delete a link survey without a segment and revalidate caches", async () => {
-    vi.mocked(prisma.survey.delete).mockResolvedValue(mockDeletedSurveyLink as any);
+  test("delegates survey deletion to the shared service", async () => {
+    mockDeleteSharedSurvey.mockResolvedValue(mockDeletedSurveyLink);
 
     const deletedSurvey = await deleteSurvey(surveyId);
 
-    expect(validateInputs).toHaveBeenCalledWith([surveyId, expect.any(Object)]);
-    expect(prisma.survey.delete).toHaveBeenCalledWith({
-      where: { id: surveyId },
-      include: {
-        segment: true,
-        triggers: { include: { actionClass: true } },
-      },
-    });
-    expect(prisma.segment.delete).not.toHaveBeenCalled();
-
+    expect(mockDeleteSharedSurvey).toHaveBeenCalledWith(surveyId);
     expect(deletedSurvey).toEqual(mockDeletedSurveyLink);
   });
 
-  test("should handle PrismaClientKnownRequestError during survey deletion", async () => {
-    const prismaError = new Prisma.PrismaClientKnownRequestError("Record not found", {
-      code: "P2025",
-      clientVersion: "4.0.0",
-    });
-    vi.mocked(prisma.survey.delete).mockRejectedValue(prismaError);
-
-    await expect(deleteSurvey(surveyId)).rejects.toThrow(DatabaseError);
-    expect(logger.error).toHaveBeenCalledWith({ error: prismaError, surveyId }, "Error deleting survey");
-    expect(prisma.segment.delete).not.toHaveBeenCalled();
-  });
-
-  test("should handle PrismaClientKnownRequestError during segment deletion", async () => {
-    const prismaError = new Prisma.PrismaClientKnownRequestError("Foreign key constraint failed", {
-      code: "P2003",
-      clientVersion: "4.0.0",
-    });
-    vi.mocked(prisma.survey.delete).mockResolvedValue(mockDeletedSurveyAppPrivateSegment as any);
-    vi.mocked(prisma.segment.delete).mockRejectedValue(prismaError);
-
-    await expect(deleteSurvey(surveyId)).rejects.toThrow(DatabaseError);
-    expect(logger.error).toHaveBeenCalledWith({ error: prismaError, surveyId }, "Error deleting survey");
-    expect(prisma.segment.delete).toHaveBeenCalledWith({ where: { id: segmentId } });
-  });
-
-  test("should handle generic errors during deletion", async () => {
+  test("rethrows shared delete service errors", async () => {
     const genericError = new Error("Something went wrong");
-    vi.mocked(prisma.survey.delete).mockRejectedValue(genericError);
+    mockDeleteSharedSurvey.mockRejectedValue(genericError);
 
     await expect(deleteSurvey(surveyId)).rejects.toThrow(genericError);
-    expect(logger.error).not.toHaveBeenCalled();
-    expect(prisma.segment.delete).not.toHaveBeenCalled();
-  });
-
-  test("should throw validation error for invalid surveyId", async () => {
-    const invalidSurveyId = "invalid-id";
-    const validationError = new Error("Validation failed");
-    vi.mocked(validateInputs).mockImplementation(() => {
-      throw validationError;
-    });
-
-    await expect(deleteSurvey(invalidSurveyId)).rejects.toThrow(validationError);
-    expect(prisma.survey.delete).not.toHaveBeenCalled();
+    expect(mockDeleteSharedSurvey).toHaveBeenCalledWith(surveyId);
   });
 });

apps/web/app/api/v1/management/surveys/[surveyId]/lib/surveys.ts

@@ -1,43 +1,3 @@
-import { Prisma } from "@prisma/client";
-import { z } from "zod";
-import { prisma } from "@formbricks/database";
-import { logger } from "@formbricks/logger";
-import { DatabaseError } from "@formbricks/types/errors";
-import { validateInputs } from "@/lib/utils/validate";
+import { deleteSurvey as deleteSharedSurvey } from "@/modules/survey/lib/surveys";
 
-export const deleteSurvey = async (surveyId: string) => {
-  validateInputs([surveyId, z.cuid2()]);
-
-  try {
-    const deletedSurvey = await prisma.survey.delete({
-      where: {
-        id: surveyId,
-      },
-      include: {
-        segment: true,
-        triggers: {
-          include: {
-            actionClass: true,
-          },
-        },
-      },
-    });
-
-    if (deletedSurvey.type === "app" && deletedSurvey.segment?.isPrivate) {
-      await prisma.segment.delete({
-        where: {
-          id: deletedSurvey.segment.id,
-        },
-      });
-    }
-
-    return deletedSurvey;
-  } catch (error) {
-    if (error instanceof Prisma.PrismaClientKnownRequestError) {
-      logger.error({ error, surveyId }, "Error deleting survey");
-      throw new DatabaseError(error.message);
-    }
-
-    throw error;
-  }
-};
+export const deleteSurvey = async (surveyId: string) => deleteSharedSurvey(surveyId);

apps/web/app/api/v1/management/surveys/[surveyId]/route.ts

@@ -1,5 +1,6 @@
 import { logger } from "@formbricks/logger";
 import { TAuthenticationApiKey } from "@formbricks/types/auth";
+import { ResourceNotFoundError } from "@formbricks/types/errors";
 import { ZSurveyUpdateInput } from "@formbricks/types/surveys/types";
 import { handleErrorResponse } from "@/app/api/v1/auth";
 import { deleteSurvey } from "@/app/api/v1/management/surveys/[surveyId]/lib/surveys";
@@ -78,6 +79,12 @@ export const GET = withV1ApiWrapper({
         ),
       };
     } catch (error) {
+      if (error instanceof ResourceNotFoundError) {
+        return {
+          response: responses.notFoundResponse("Survey", params.surveyId),
+        };
+      }
+
       return {
         response: handleErrorResponse(error),
       };

apps/web/app/api/v2/client/[environmentId]/environment/route.test.ts

@@ -1,141 +0,0 @@
-import * as Sentry from "@sentry/nextjs";
-import { type NextRequest } from "next/server";
-import { beforeEach, describe, expect, test, vi } from "vitest";
-
-const mocks = vi.hoisted(() => ({
-  applyIPRateLimit: vi.fn(),
-  getWorkspaceState: vi.fn(),
-  resolveClientApiIds: vi.fn(),
-  contextualLoggerError: vi.fn(),
-}));
-
-vi.mock("@/app/api/v1/client/[workspaceId]/environment/lib/environmentState", () => ({
-  getWorkspaceState: mocks.getWorkspaceState,
-}));
-
-vi.mock("@/lib/utils/resolve-client-id", () => ({
-  resolveClientApiIds: mocks.resolveClientApiIds,
-}));
-
-vi.mock("@/modules/core/rate-limit/helpers", () => ({
-  applyIPRateLimit: mocks.applyIPRateLimit,
-  applyRateLimit: vi.fn(),
-}));
-
-vi.mock("@/modules/core/rate-limit/rate-limit-configs", () => ({
-  rateLimitConfigs: {
-    api: {
-      client: { windowMs: 60000, max: 100 },
-      v1: { windowMs: 60000, max: 1000 },
-    },
-  },
-}));
-
-vi.mock("@sentry/nextjs", () => ({
-  captureException: vi.fn(),
-  withScope: vi.fn(),
-}));
-
-vi.mock("@formbricks/logger", () => ({
-  logger: {
-    withContext: vi.fn(() => ({
-      error: mocks.contextualLoggerError,
-      warn: vi.fn(),
-      info: vi.fn(),
-    })),
-    error: vi.fn(),
-    warn: vi.fn(),
-    info: vi.fn(),
-  },
-}));
-
-vi.mock("@/lib/constants", async (importOriginal) => {
-  const actual = await importOriginal<typeof import("@/lib/constants")>();
-  return {
-    ...actual,
-    AUDIT_LOG_ENABLED: false,
-    IS_PRODUCTION: true,
-    SENTRY_DSN: "test-dsn",
-    ENCRYPTION_KEY: "test-key",
-    REDIS_URL: "redis://localhost:6379",
-  };
-});
-
-const createMockRequest = (url: string, headers = new Map<string, string>()): NextRequest => {
-  const parsedUrl = new URL(url);
-
-  return {
-    method: "GET",
-    url,
-    headers: {
-      get: (key: string) => headers.get(key),
-    },
-    nextUrl: {
-      pathname: parsedUrl.pathname,
-    },
-  } as unknown as NextRequest;
-};
-
-describe("api/v2 client environment route", () => {
-  beforeEach(() => {
-    vi.clearAllMocks();
-    mocks.applyIPRateLimit.mockResolvedValue(undefined);
-    mocks.resolveClientApiIds.mockResolvedValue({ workspaceId: "ck12345678901234567890123" });
-  });
-
-  test("reports v1-backed failures as v2 and keeps the response payload unchanged", async () => {
-    const underlyingError = new Error("Environment load failed");
-    mocks.getWorkspaceState.mockRejectedValue(underlyingError);
-
-    const request = createMockRequest(
-      "https://api.test/api/v2/client/ck12345678901234567890123/environment",
-      new Map([["x-request-id", "req-v2-env"]])
-    );
-
-    const { GET } = await import("../../../../v1/client/[workspaceId]/environment/route");
-    const response = await GET(request, {
-      params: Promise.resolve({
-        workspaceId: "ck12345678901234567890123",
-      }),
-    });
-
-    expect(response.status).toBe(500);
-    expect(await response.json()).toEqual({
-      code: "internal_server_error",
-      message: "An error occurred while processing your request.",
-      details: {},
-    });
-
-    expect(Sentry.withScope).not.toHaveBeenCalled();
-    expect(Sentry.captureException).toHaveBeenCalledWith(
-      underlyingError,
-      expect.objectContaining({
-        tags: expect.objectContaining({
-          apiVersion: "v2",
-          correlationId: "req-v2-env",
-          method: "GET",
-          path: "/api/v2/client/ck12345678901234567890123/environment",
-        }),
-        extra: expect.objectContaining({
-          error: expect.objectContaining({
-            name: "Error",
-            message: "Environment load failed",
-          }),
-          originalError: expect.objectContaining({
-            name: "Error",
-            message: "Environment load failed",
-          }),
-        }),
-        contexts: expect.objectContaining({
-          apiRequest: expect.objectContaining({
-            apiVersion: "v2",
-            correlationId: "req-v2-env",
-            method: "GET",
-            path: "/api/v2/client/ck12345678901234567890123/environment",
-            status: 500,
-          }),
-        }),
-      })
-    );
-  });
-});

apps/web/app/api/v2/client/[workspaceId]/displays/route.test.ts

@@ -1,132 +0,0 @@
-import { beforeEach, describe, expect, test, vi } from "vitest";
-
-const mocks = vi.hoisted(() => ({
-  createDisplay: vi.fn(),
-  getIsContactsEnabled: vi.fn(),
-  getOrganizationIdFromWorkspaceId: vi.fn(),
-  reportApiError: vi.fn(),
-  resolveClientApiIds: vi.fn(),
-}));
-
-vi.mock("./lib/display", () => ({
-  createDisplay: mocks.createDisplay,
-}));
-
-vi.mock("@/modules/ee/license-check/lib/utils", () => ({
-  getIsContactsEnabled: mocks.getIsContactsEnabled,
-}));
-
-vi.mock("@/lib/utils/helper", () => ({
-  getOrganizationIdFromWorkspaceId: mocks.getOrganizationIdFromWorkspaceId,
-}));
-
-vi.mock("@/lib/utils/resolve-client-id", () => ({
-  resolveClientApiIds: mocks.resolveClientApiIds,
-}));
-
-vi.mock("@/app/lib/api/api-error-reporter", () => ({
-  reportApiError: mocks.reportApiError,
-}));
-
-const environmentId = "cld1234567890abcdef123456";
-const surveyId = "clg123456789012345678901234";
-
-describe("api/v2 client displays route", () => {
-  beforeEach(() => {
-    vi.clearAllMocks();
-    mocks.resolveClientApiIds.mockResolvedValue({ workspaceId: environmentId });
-    mocks.getOrganizationIdFromWorkspaceId.mockResolvedValue("org_123");
-    mocks.getIsContactsEnabled.mockResolvedValue(true);
-  });
-
-  test("returns a v2 bad request response for malformed JSON without reporting an internal error", async () => {
-    const request = new Request(`https://api.test/api/v2/client/${environmentId}/displays`, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-      },
-      body: "{",
-    });
-
-    const { POST } = await import("./route");
-    const response = await POST(request, {
-      params: Promise.resolve({ workspaceId: environmentId }),
-    });
-
-    expect(response.status).toBe(400);
-    expect(await response.json()).toEqual(
-      expect.objectContaining({
-        code: "bad_request",
-        message: "Invalid JSON in request body",
-      })
-    );
-    expect(mocks.createDisplay).not.toHaveBeenCalled();
-    expect(mocks.reportApiError).not.toHaveBeenCalled();
-  });
-
-  test("reports unexpected createDisplay failures while keeping the response payload unchanged", async () => {
-    const underlyingError = new Error("display persistence failed");
-    mocks.createDisplay.mockRejectedValue(underlyingError);
-
-    const request = new Request(`https://api.test/api/v2/client/${environmentId}/displays`, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-      },
-      body: JSON.stringify({
-        surveyId,
-      }),
-    });
-
-    const { POST } = await import("./route");
-    const response = await POST(request, {
-      params: Promise.resolve({ workspaceId: environmentId }),
-    });
-
-    expect(response.status).toBe(500);
-    expect(await response.json()).toEqual({
-      code: "internal_server_error",
-      message: "Something went wrong. Please try again.",
-      details: {},
-    });
-    expect(mocks.reportApiError).toHaveBeenCalledWith({
-      request,
-      status: 500,
-      error: underlyingError,
-    });
-  });
-
-  test("reports unexpected contact-license lookup failures with the same generic public response", async () => {
-    const underlyingError = new Error("license lookup failed");
-    mocks.getOrganizationIdFromWorkspaceId.mockRejectedValue(underlyingError);
-
-    const request = new Request(`https://api.test/api/v2/client/${environmentId}/displays`, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-      },
-      body: JSON.stringify({
-        surveyId,
-        contactId: "clh123456789012345678901234",
-      }),
-    });
-
-    const { POST } = await import("./route");
-    const response = await POST(request, {
-      params: Promise.resolve({ workspaceId: environmentId }),
-    });
-
-    expect(response.status).toBe(500);
-    expect(await response.json()).toEqual({
-      code: "internal_server_error",
-      message: "Something went wrong. Please try again.",
-      details: {},
-    });
-    expect(mocks.reportApiError).toHaveBeenCalledWith({
-      request,
-      status: 500,
-      error: underlyingError,
-    });
-    expect(mocks.createDisplay).not.toHaveBeenCalled();
-  });
-});

apps/web/app/api/v2/client/[workspaceId]/responses/lib/response.test.ts

@@ -2,7 +2,7 @@ import { Prisma } from "@prisma/client";
 import { afterEach, beforeEach, describe, expect, test, vi } from "vitest";
 import { prisma } from "@formbricks/database";
 import { TContactAttributes } from "@formbricks/types/contact-attribute";
-import { DatabaseError, ResourceNotFoundError } from "@formbricks/types/errors";
+import { DatabaseError, ResourceNotFoundError, UniqueConstraintError } from "@formbricks/types/errors";
 import { TResponseWithQuotaFull, TSurveyQuota } from "@formbricks/types/quota";
 import { TResponse } from "@formbricks/types/responses";
 import { TTag } from "@formbricks/types/tags";
@@ -178,10 +178,34 @@ describe("createResponse V2", () => {
     ).rejects.toThrow(ResourceNotFoundError);
   });
 
-  test("should throw DatabaseError on Prisma known request error", async () => {
-    const prismaError = new Prisma.PrismaClientKnownRequestError("Test Prisma Error", {
+  test("should throw UniqueConstraintError on P2002 with singleUseId target", async () => {
+    const prismaError = new Prisma.PrismaClientKnownRequestError("Unique constraint failed", {
       code: "P2002",
       clientVersion: "test",
+      meta: { target: ["surveyId", "singleUseId"] },
+    });
+    vi.mocked(mockTx.response.create).mockRejectedValue(prismaError);
+    await expect(
+      createResponse(mockResponseInput, mockTx as unknown as Prisma.TransactionClient)
+    ).rejects.toThrow(UniqueConstraintError);
+  });
+
+  test("should throw DatabaseError on P2002 without singleUseId target", async () => {
+    const prismaError = new Prisma.PrismaClientKnownRequestError("Unique constraint failed", {
+      code: "P2002",
+      clientVersion: "test",
+      meta: { target: ["displayId"] },
+    });
+    vi.mocked(mockTx.response.create).mockRejectedValue(prismaError);
+    await expect(
+      createResponse(mockResponseInput, mockTx as unknown as Prisma.TransactionClient)
+    ).rejects.toThrow(DatabaseError);
+  });
+
+  test("should throw DatabaseError on non-P2002 Prisma known request error", async () => {
+    const prismaError = new Prisma.PrismaClientKnownRequestError("Test Prisma Error", {
+      code: "P2025",
+      clientVersion: "test",
     });
     vi.mocked(mockTx.response.create).mockRejectedValue(prismaError);
     await expect(

apps/web/app/api/v2/client/[workspaceId]/responses/lib/response.ts

@@ -2,7 +2,7 @@ import "server-only";
 import { Prisma } from "@prisma/client";
 import { prisma } from "@formbricks/database";
 import { TContactAttributes } from "@formbricks/types/contact-attribute";
-import { DatabaseError, ResourceNotFoundError } from "@formbricks/types/errors";
+import { DatabaseError, ResourceNotFoundError, UniqueConstraintError } from "@formbricks/types/errors";
 import { TResponseWithQuotaFull } from "@formbricks/types/quota";
 import { TResponse, ZResponseInput } from "@formbricks/types/responses";
 import { TTag } from "@formbricks/types/tags";
@@ -131,6 +131,13 @@ export const createResponse = async (
     return response;
   } catch (error) {
     if (error instanceof Prisma.PrismaClientKnownRequestError) {
+      if (error.code === "P2002") {
+        const target = (error.meta?.target as string[]) ?? [];
+        if (target?.includes("singleUseId")) {
+          throw new UniqueConstraintError("Response already submitted for this single-use link");
+        }
+      }
+
       throw new DatabaseError(error.message);
     }
 

apps/web/app/api/v2/client/[workspaceId]/responses/lib/utils.test.ts

@@ -92,6 +92,7 @@ const mockSurvey: TSurvey = {
   isCaptureIpEnabled: false,
   metadata: {},
   slug: null,
+  isAutoProgressingEnabled: true,
 };
 
 const mockResponseInput: TResponseInputV2 = {
@@ -126,7 +127,6 @@ describe("checkSurveyValidity", () => {
     expect(responses.badRequestResponse).toHaveBeenCalledWith(
       "Survey is part of another workspace",
       {
-        "survey.workspaceId": "ws-2",
         workspaceId: "ws-1",
       },
       true

apps/web/app/api/v2/client/[workspaceId]/responses/lib/utils.ts

@@ -20,7 +20,6 @@ export const checkSurveyValidity = async (
     return responses.badRequestResponse(
       "Survey is part of another workspace",
       {
-        "survey.workspaceId": survey.workspaceId,
         workspaceId,
       },
       true

apps/web/app/api/v2/client/[workspaceId]/responses/route.test.ts

@@ -1,150 +0,0 @@
-import { beforeEach, describe, expect, test, vi } from "vitest";
-
-const mocks = vi.hoisted(() => ({
-  checkSurveyValidity: vi.fn(),
-  createResponseWithQuotaEvaluation: vi.fn(),
-  getClientIpFromHeaders: vi.fn(),
-  getIsContactsEnabled: vi.fn(),
-  getOrganizationIdFromWorkspaceId: vi.fn(),
-  getSurvey: vi.fn(),
-  reportApiError: vi.fn(),
-  resolveClientApiIds: vi.fn(),
-  sendToPipeline: vi.fn(),
-  validateResponseData: vi.fn(),
-}));
-
-vi.mock("@/app/api/v2/client/[workspaceId]/responses/lib/utils", () => ({
-  checkSurveyValidity: mocks.checkSurveyValidity,
-}));
-
-vi.mock("./lib/response", () => ({
-  createResponseWithQuotaEvaluation: mocks.createResponseWithQuotaEvaluation,
-}));
-
-vi.mock("@/app/lib/api/api-error-reporter", () => ({
-  reportApiError: mocks.reportApiError,
-}));
-
-vi.mock("@/app/lib/pipelines", () => ({
-  sendToPipeline: mocks.sendToPipeline,
-}));
-
-vi.mock("@/lib/survey/service", () => ({
-  getSurvey: mocks.getSurvey,
-}));
-
-vi.mock("@/lib/utils/client-ip", () => ({
-  getClientIpFromHeaders: mocks.getClientIpFromHeaders,
-}));
-
-vi.mock("@/lib/utils/helper", () => ({
-  getOrganizationIdFromWorkspaceId: mocks.getOrganizationIdFromWorkspaceId,
-}));
-
-vi.mock("@/lib/utils/resolve-client-id", () => ({
-  resolveClientApiIds: mocks.resolveClientApiIds,
-}));
-
-vi.mock("@/modules/api/lib/validation", () => ({
-  formatValidationErrorsForV1Api: vi.fn((errors) => errors),
-  validateResponseData: mocks.validateResponseData,
-}));
-
-vi.mock("@/modules/ee/license-check/lib/utils", () => ({
-  getIsContactsEnabled: mocks.getIsContactsEnabled,
-}));
-
-const environmentId = "cld1234567890abcdef123456";
-const surveyId = "clg123456789012345678901234";
-
-describe("api/v2 client responses route", () => {
-  beforeEach(() => {
-    vi.clearAllMocks();
-    mocks.resolveClientApiIds.mockResolvedValue({ workspaceId: environmentId });
-    mocks.checkSurveyValidity.mockResolvedValue(null);
-    mocks.getSurvey.mockResolvedValue({
-      id: surveyId,
-      environmentId,
-      blocks: [],
-      questions: [],
-      isCaptureIpEnabled: false,
-    });
-    mocks.validateResponseData.mockReturnValue(null);
-    mocks.getOrganizationIdFromWorkspaceId.mockResolvedValue("org_123");
-    mocks.getIsContactsEnabled.mockResolvedValue(true);
-    mocks.getClientIpFromHeaders.mockResolvedValue("127.0.0.1");
-  });
-
-  test("reports unexpected response creation failures while keeping the public payload generic", async () => {
-    const underlyingError = new Error("response persistence failed");
-    mocks.createResponseWithQuotaEvaluation.mockRejectedValue(underlyingError);
-
-    const request = new Request(`https://api.test/api/v2/client/${environmentId}/responses`, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        "x-request-id": "req-v2-response",
-      },
-      body: JSON.stringify({
-        surveyId,
-        finished: false,
-        data: {},
-      }),
-    });
-
-    const { POST } = await import("./route");
-    const response = await POST(request, {
-      params: Promise.resolve({ workspaceId: environmentId }),
-    });
-
-    expect(response.status).toBe(500);
-    expect(await response.json()).toEqual({
-      code: "internal_server_error",
-      message: "Something went wrong. Please try again.",
-      details: {},
-    });
-    expect(mocks.reportApiError).toHaveBeenCalledWith({
-      request,
-      status: 500,
-      error: underlyingError,
-    });
-    expect(mocks.sendToPipeline).not.toHaveBeenCalled();
-  });
-
-  test("reports unexpected pre-persistence failures with the same generic public response", async () => {
-    const underlyingError = new Error("survey lookup failed");
-    mocks.getSurvey.mockRejectedValue(underlyingError);
-
-    const request = new Request(`https://api.test/api/v2/client/${environmentId}/responses`, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        "x-request-id": "req-v2-response-pre-check",
-      },
-      body: JSON.stringify({
-        surveyId,
-        finished: false,
-        data: {},
-      }),
-    });
-
-    const { POST } = await import("./route");
-    const response = await POST(request, {
-      params: Promise.resolve({ workspaceId: environmentId }),
-    });
-
-    expect(response.status).toBe(500);
-    expect(await response.json()).toEqual({
-      code: "internal_server_error",
-      message: "Something went wrong. Please try again.",
-      details: {},
-    });
-    expect(mocks.reportApiError).toHaveBeenCalledWith({
-      request,
-      status: 500,
-      error: underlyingError,
-    });
-    expect(mocks.createResponseWithQuotaEvaluation).not.toHaveBeenCalled();
-    expect(mocks.sendToPipeline).not.toHaveBeenCalled();
-  });
-});

apps/web/app/api/v2/client/[workspaceId]/responses/route.ts

@@ -1,5 +1,5 @@
 import { UAParser } from "ua-parser-js";
-import { InvalidInputError } from "@formbricks/types/errors";
+import { InvalidInputError, UniqueConstraintError } from "@formbricks/types/errors";
 import { TResponseWithQuotaFull } from "@formbricks/types/quota";
 import { checkSurveyValidity } from "@/app/api/v2/client/[workspaceId]/responses/lib/utils";
 import { reportApiError } from "@/app/lib/api/api-error-reporter";
@@ -164,6 +164,10 @@ const createResponseForRequest = async ({
       return responses.badRequestResponse(error.message, undefined, true);
     }
 
+    if (error instanceof UniqueConstraintError) {
+      return responses.conflictResponse(error.message, undefined, true);
+    }
+
     const response = getUnexpectedPublicErrorResponse();
     reportApiError({
       request,
@@ -233,7 +237,7 @@ export const POST = async (request: Request, context: Context): Promise<Response
     }
     const { quotaFull, ...responseData } = createdResponse;
 
-    sendToPipeline({
+    await sendToPipeline({
       event: "responseCreated",
       workspaceId,
       surveyId: responseData.surveyId,
@@ -241,7 +245,7 @@ export const POST = async (request: Request, context: Context): Promise<Response
     });
 
     if (responseData.finished) {
-      sendToPipeline({
+      await sendToPipeline({
         event: "responseFinished",
         workspaceId,
         surveyId: responseData.surveyId,

apps/web/app/api/v3/lib/api-wrapper.test.ts

@@ -9,6 +9,22 @@ const { mockAuthenticateRequest, mockGetServerSession } = vi.hoisted(() => ({
   mockGetServerSession: vi.fn(),
 }));
 
+const { mockQueueAuditEvent, mockBuildAuditLogBaseObject } = vi.hoisted(() => ({
+  mockQueueAuditEvent: vi.fn().mockImplementation(async () => undefined),
+  mockBuildAuditLogBaseObject: vi.fn((action: string, targetType: string, apiUrl: string) => ({
+    action,
+    targetType,
+    userId: "unknown",
+    targetId: "unknown",
+    organizationId: "unknown",
+    status: "failure",
+    oldObject: undefined,
+    newObject: undefined,
+    userType: "api",
+    apiUrl,
+  })),
+}));
+
 vi.mock("next-auth", () => ({
   getServerSession: mockGetServerSession,
 }));
@@ -25,6 +41,14 @@ vi.mock("@/modules/core/rate-limit/helpers", () => ({
   applyRateLimit: vi.fn().mockResolvedValue(undefined),
 }));
 
+vi.mock("@/modules/ee/audit-logs/lib/handler", () => ({
+  queueAuditEvent: mockQueueAuditEvent,
+}));
+
+vi.mock("@/app/lib/api/with-api-logging", () => ({
+  buildAuditLogBaseObject: mockBuildAuditLogBaseObject,
+}));
+
 vi.mock("@formbricks/logger", () => ({
   logger: {
     withContext: vi.fn(() => ({
@@ -45,6 +69,114 @@ describe("withV3ApiWrapper", () => {
     vi.clearAllMocks();
   });
 
+  test("passes an audit log to the handler and queues success after the response", async () => {
+    const { queueAuditEvent } = await import("@/modules/ee/audit-logs/lib/handler");
+
+    mockGetServerSession.mockResolvedValue({
+      user: { id: "user_1", name: "Test", email: "t@example.com" },
+      expires: "2026-01-01",
+    });
+
+    const handler = vi.fn(async ({ auditLog }) => {
+      expect(auditLog).toEqual(
+        expect.objectContaining({
+          action: "deleted",
+          targetType: "survey",
+          userId: "user_1",
+          userType: "user",
+          status: "failure",
+        })
+      );
+
+      if (auditLog) {
+        auditLog.targetId = "survey_1";
+        auditLog.organizationId = "org_1";
+        auditLog.oldObject = { id: "survey_1" };
+      }
+
+      return Response.json({ ok: true });
+    });
+
+    const wrapped = withV3ApiWrapper({
+      auth: "both",
+      action: "deleted",
+      targetType: "survey",
+      handler,
+    });
+
+    const response = await wrapped(
+      new NextRequest("http://localhost/api/v3/surveys/survey_1", {
+        method: "DELETE",
+        headers: { "x-request-id": "req-audit" },
+      }),
+      {} as never
+    );
+
+    expect(response.status).toBe(200);
+    expect(queueAuditEvent).toHaveBeenCalledWith(
+      expect.objectContaining({
+        action: "deleted",
+        targetType: "survey",
+        targetId: "survey_1",
+        organizationId: "org_1",
+        userId: "user_1",
+        userType: "user",
+        status: "success",
+        oldObject: { id: "survey_1" },
+      })
+    );
+  });
+
+  test("queues a failure audit log when the handler returns a non-ok response", async () => {
+    const { queueAuditEvent } = await import("@/modules/ee/audit-logs/lib/handler");
+
+    mockAuthenticateRequest.mockResolvedValue({
+      type: "apiKey",
+      apiKeyId: "key_1",
+      organizationId: "org_1",
+      organizationAccess: { accessControl: { read: true, write: true } },
+      environmentPermissions: [],
+    });
+
+    const wrapped = withV3ApiWrapper({
+      auth: "both",
+      action: "deleted",
+      targetType: "survey",
+      handler: async ({ auditLog }) => {
+        if (auditLog) {
+          auditLog.targetId = "survey_2";
+        }
+
+        return new Response("forbidden", { status: 403 });
+      },
+    });
+
+    const response = await wrapped(
+      new NextRequest("http://localhost/api/v3/surveys/survey_2", {
+        method: "DELETE",
+        headers: {
+          "x-request-id": "req-failure-audit",
+          "x-api-key": "fbk_test",
+        },
+      }),
+      {} as never
+    );
+
+    expect(response.status).toBe(403);
+    expect(queueAuditEvent).toHaveBeenCalledWith(
+      expect.objectContaining({
+        action: "deleted",
+        targetType: "survey",
+        targetId: "survey_2",
+        organizationId: "org_1",
+        userId: "key_1",
+        userType: "api",
+        status: "failure",
+        eventId: "req-failure-audit",
+      })
+    );
+  });
+
   test("uses session auth first in both mode and injects request id into plain responses", async () => {
     const { applyRateLimit } = await import("@/modules/core/rate-limit/helpers");
     mockGetServerSession.mockResolvedValue({

apps/web/app/api/v3/lib/api-wrapper.ts

@@ -4,10 +4,13 @@ import { z } from "zod";
 import { logger } from "@formbricks/logger";
 import { TooManyRequestsError } from "@formbricks/types/errors";
 import { authenticateRequest } from "@/app/api/v1/auth";
+import { buildAuditLogBaseObject } from "@/app/lib/api/with-api-logging";
 import { authOptions } from "@/modules/auth/lib/authOptions";
 import { applyRateLimit } from "@/modules/core/rate-limit/helpers";
 import { rateLimitConfigs } from "@/modules/core/rate-limit/rate-limit-configs";
 import type { TRateLimitConfig } from "@/modules/core/rate-limit/types/rate-limit";
+import { queueAuditEvent } from "@/modules/ee/audit-logs/lib/handler";
+import { TAuditAction, TAuditTarget } from "@/modules/ee/audit-logs/types/audit-log";
 import {
   type InvalidParam,
   problemBadRequest,
@@ -15,7 +18,7 @@ import {
   problemTooManyRequests,
   problemUnauthorized,
 } from "./response";
-import type { TV3Authentication } from "./types";
+import type { TV3AuditLog, TV3Authentication } from "./types";
 
 type TV3Schema = z.ZodTypeAny;
 type MaybePromise<T> = T | Promise<T>;
@@ -38,6 +41,7 @@ export type TV3HandlerParams<TParsedInput = Record<string, never>, TProps = unkn
   req: NextRequest;
   props: TProps;
   authentication: TV3Authentication;
+  auditLog?: TV3AuditLog;
   parsedInput: TParsedInput;
   requestId: string;
   instance: string;
@@ -48,6 +52,8 @@ export type TWithV3ApiWrapperParams<S extends TV3Schemas | undefined, TProps = u
   schemas?: S;
   rateLimit?: boolean;
   customRateLimitConfig?: TRateLimitConfig;
+  action?: TAuditAction;
+  targetType?: TAuditTarget;
   handler: (params: TV3HandlerParams<TV3ParsedInput<S>, TProps>) => MaybePromise<Response>;
 };
 
@@ -293,10 +299,61 @@ async function applyV3RateLimitOrRespond(params: {
   return null;
 }
 
+function buildV3AuditLog(
+  authentication: TV3Authentication,
+  action?: TAuditAction,
+  targetType?: TAuditTarget,
+  apiUrl?: string
+): TV3AuditLog | undefined {
+  if (!authentication || !action || !targetType || !apiUrl) {
+    return undefined;
+  }
+
+  const auditLog = buildAuditLogBaseObject(action, targetType, apiUrl);
+
+  if ("user" in authentication && authentication.user?.id) {
+    auditLog.userId = authentication.user.id;
+    auditLog.userType = "user";
+  } else if ("apiKeyId" in authentication) {
+    auditLog.userId = authentication.apiKeyId;
+    auditLog.userType = "api";
+    auditLog.organizationId = authentication.organizationId;
+  }
+
+  return auditLog;
+}
+
+async function queueV3AuditLog(
+  auditLog: TV3AuditLog | undefined,
+  requestId: string,
+  log: ReturnType<typeof logger.withContext>
+): Promise<void> {
+  if (!auditLog) {
+    return;
+  }
+
+  try {
+    await queueAuditEvent({
+      ...auditLog,
+      ...(auditLog.status === "failure" ? { eventId: auditLog.eventId ?? requestId } : {}),
+    });
+  } catch (error) {
+    log.error({ error }, "Failed to queue V3 audit event");
+  }
+}
+
 export const withV3ApiWrapper = <S extends TV3Schemas | undefined, TProps = unknown>(
   params: TWithV3ApiWrapperParams<S, TProps>
 ): ((req: NextRequest, props: TProps) => Promise<Response>) => {
-  const { auth = "both", schemas, rateLimit = true, customRateLimitConfig, handler } = params;
+  const {
+    auth = "both",
+    schemas,
+    rateLimit = true,
+    customRateLimitConfig,
+    handler,
+    action,
+    targetType,
+  } = params;
 
   return async (req: NextRequest, props: TProps): Promise<Response> => {
     const requestId = req.headers.get("x-request-id") ?? crypto.randomUUID();
@@ -306,6 +363,7 @@ export const withV3ApiWrapper = <S extends TV3Schemas | undefined, TProps = unkn
       method: req.method,
       path: instance,
     });
+    let auditLog: TV3AuditLog | undefined;
 
     try {
       const authResult = await authenticateV3RequestOrRespond(req, auth, requestId, instance);
@@ -331,17 +389,33 @@ export const withV3ApiWrapper = <S extends TV3Schemas | undefined, TProps = unkn
         return rateLimitResponse;
       }
 
+      auditLog = buildV3AuditLog(authResult.authentication, action, targetType, req.url);
+
       const response = await handler({
         req,
         props,
         authentication: authResult.authentication,
+        auditLog,
         parsedInput: parsedInputResult.parsedInput,
         requestId,
         instance,
       });
 
+      if (auditLog) {
+        if (response.ok) {
+          auditLog.status = "success";
+        } else {
+          auditLog.eventId = requestId;
+        }
+      }
+
+      await queueV3AuditLog(auditLog, requestId, log);
       return ensureRequestIdHeader(response, requestId);
     } catch (error) {
+      if (auditLog) {
+        auditLog.eventId = requestId;
+        await queueV3AuditLog(auditLog, requestId, log);
+      }
       log.error({ error, statusCode: 500 }, "V3 API unexpected error");
       return problemInternalError(requestId, "An unexpected error occurred.", instance);
     }

apps/web/app/api/v3/lib/response.test.ts

@@ -7,6 +7,7 @@ import {
   problemTooManyRequests,
   problemUnauthorized,
   successListResponse,
+  successResponse,
 } from "./response";
 
 describe("v3 problem responses", () => {
@@ -93,3 +94,27 @@ describe("successListResponse", () => {
     expect(res.headers.get("Cache-Control")).toBe("private, max-age=0");
   });
 });
+
+describe("successResponse", () => {
+  test("wraps the payload in a data envelope", async () => {
+    const res = successResponse({ id: "survey_1" }, { requestId: "req-success" });
+    expect(res.status).toBe(200);
+    expect(res.headers.get("X-Request-Id")).toBe("req-success");
+    expect(res.headers.get("Cache-Control")).toContain("no-store");
+    expect(await res.json()).toEqual({
+      data: { id: "survey_1" },
+    });
+  });
+
+  test("allows custom status and cache headers", async () => {
+    const res = successResponse(
+      { ok: true },
+      {
+        cache: "private, max-age=60",
+        status: 202,
+      }
+    );
+    expect(res.status).toBe(202);
+    expect(res.headers.get("Cache-Control")).toBe("private, max-age=60");
+  });
+});

apps/web/app/api/v3/lib/response.ts

@@ -147,3 +147,27 @@ export function successListResponse<T, TMeta extends Record<string, unknown>>(
   }
   return Response.json({ data, meta }, { status: 200, headers });
 }
+
+export function successResponse<T>(
+  data: T,
+  options?: { requestId?: string; cache?: string; status?: number }
+): Response {
+  const headers: Record<string, string> = {
+    "Content-Type": "application/json",
+    "Cache-Control": options?.cache ?? CACHE_NO_STORE,
+  };
+
+  if (options?.requestId) {
+    headers["X-Request-Id"] = options.requestId;
+  }
+
+  return Response.json(
+    {
+      data,
+    },
+    {
+      status: options?.status ?? 200,
+      headers,
+    }
+  );
+}

apps/web/app/api/v3/lib/types.ts

@@ -1,4 +1,6 @@
 import type { Session } from "next-auth";
 import type { TAuthenticationApiKey } from "@formbricks/types/auth";
+import type { TApiAuditLog } from "@/app/lib/api/with-api-logging";
 
 export type TV3Authentication = TAuthenticationApiKey | Session | null;
+export type TV3AuditLog = TApiAuditLog;

apps/web/app/api/v3/surveys/[surveyId]/route.test.ts

@@ -0,0 +1,318 @@
+import { ApiKeyPermission } from "@prisma/client";
+import { NextRequest } from "next/server";
+import { afterEach, beforeEach, describe, expect, test, vi } from "vitest";
+import { DatabaseError, ResourceNotFoundError } from "@formbricks/types/errors";
+import { requireV3WorkspaceAccess } from "@/app/api/v3/lib/auth";
+import { getSurvey } from "@/lib/survey/service";
+import { deleteSurvey } from "@/modules/survey/lib/surveys";
+import { DELETE } from "./route";
+
+const { mockAuthenticateRequest } = vi.hoisted(() => ({
+  mockAuthenticateRequest: vi.fn(),
+}));
+
+const { mockQueueAuditEvent, mockBuildAuditLogBaseObject } = vi.hoisted(() => ({
+  mockQueueAuditEvent: vi.fn().mockImplementation(async () => undefined),
+  mockBuildAuditLogBaseObject: vi.fn((action: string, targetType: string, apiUrl: string) => ({
+    action,
+    targetType,
+    userId: "unknown",
+    targetId: "unknown",
+    organizationId: "unknown",
+    status: "failure",
+    oldObject: undefined,
+    newObject: undefined,
+    userType: "api",
+    apiUrl,
+  })),
+}));
+
+vi.mock("next-auth", () => ({
+  getServerSession: vi.fn(),
+}));
+
+vi.mock("@/app/api/v1/auth", async (importOriginal) => {
+  const actual = await importOriginal<typeof import("@/app/api/v1/auth")>();
+  return { ...actual, authenticateRequest: mockAuthenticateRequest };
+});
+
+vi.mock("@/modules/core/rate-limit/helpers", () => ({
+  applyRateLimit: vi.fn().mockResolvedValue(undefined),
+  applyIPRateLimit: vi.fn().mockResolvedValue(undefined),
+}));
+
+vi.mock("@/lib/constants", async (importOriginal) => {
+  const actual = await importOriginal<typeof import("@/lib/constants")>();
+  return { ...actual, AUDIT_LOG_ENABLED: false };
+});
+
+vi.mock("@/app/api/v3/lib/auth", () => ({
+  requireV3WorkspaceAccess: vi.fn(),
+}));
+
+vi.mock("@/lib/survey/service", () => ({
+  getSurvey: vi.fn(),
+}));
+
+vi.mock("@/modules/survey/lib/surveys", () => ({
+  deleteSurvey: vi.fn(),
+}));
+
+vi.mock("@/modules/ee/audit-logs/lib/handler", () => ({
+  queueAuditEvent: mockQueueAuditEvent,
+}));
+
+vi.mock("@/app/lib/api/with-api-logging", () => ({
+  buildAuditLogBaseObject: mockBuildAuditLogBaseObject,
+}));
+
+vi.mock("@formbricks/logger", () => ({
+  logger: {
+    withContext: vi.fn(() => ({
+      warn: vi.fn(),
+      error: vi.fn(),
+    })),
+  },
+}));
+
+const getServerSession = vi.mocked((await import("next-auth")).getServerSession);
+const queueAuditEvent = vi.mocked((await import("@/modules/ee/audit-logs/lib/handler")).queueAuditEvent);
+
+const surveyId = "clxx1234567890123456789012";
+const workspaceId = "clzz9876543210987654321098";
+
+function createRequest(url: string, requestId?: string, extraHeaders?: Record<string, string>): NextRequest {
+  const headers: Record<string, string> = { ...extraHeaders };
+  if (requestId) {
+    headers["x-request-id"] = requestId;
+  }
+
+  return new NextRequest(url, {
+    method: "DELETE",
+    headers,
+  });
+}
+
+const apiKeyAuth = {
+  type: "apiKey" as const,
+  apiKeyId: "key_1",
+  organizationId: "org_1",
+  organizationAccess: {
+    accessControl: { read: true, write: true },
+  },
+  workspacePermissions: [
+    {
+      workspaceId,
+      workspaceName: "W",
+      permission: ApiKeyPermission.write,
+    },
+  ],
+};
+
+describe("DELETE /api/v3/surveys/[surveyId]", () => {
+  beforeEach(() => {
+    vi.resetAllMocks();
+    getServerSession.mockResolvedValue({
+      user: { id: "user_1", name: "User", email: "u@example.com" },
+      expires: "2026-01-01",
+    } as any);
+    mockAuthenticateRequest.mockResolvedValue(null);
+    vi.mocked(getSurvey).mockResolvedValue({
+      id: surveyId,
+      name: "Delete me",
+      workspaceId: workspaceId,
+      type: "link",
+      status: "draft",
+      createdAt: new Date("2026-04-15T10:00:00.000Z"),
+      updatedAt: new Date("2026-04-15T10:00:00.000Z"),
+      responseCount: 0,
+      creator: { name: "User" },
+      singleUse: null,
+    } as any);
+    vi.mocked(deleteSurvey).mockResolvedValue({
+      id: surveyId,
+      workspaceId,
+      type: "link",
+      segment: null,
+      triggers: [],
+    } as any);
+    vi.mocked(requireV3WorkspaceAccess).mockResolvedValue({
+      workspaceId,
+      organizationId: "org_1",
+    });
+  });
+
+  afterEach(() => {
+    vi.clearAllMocks();
+  });
+
+  test("returns 401 when no session and no API key", async () => {
+    getServerSession.mockResolvedValue(null);
+    mockAuthenticateRequest.mockResolvedValue(null);
+
+    const res = await DELETE(createRequest(`http://localhost/api/v3/surveys/${surveyId}`), {
+      params: Promise.resolve({ surveyId }),
+    } as never);
+
+    expect(res.status).toBe(401);
+    expect(vi.mocked(getSurvey)).not.toHaveBeenCalled();
+  });
+
+  test("returns 200 with session auth and deletes the survey", async () => {
+    const res = await DELETE(createRequest(`http://localhost/api/v3/surveys/${surveyId}`, "req-delete"), {
+      params: Promise.resolve({ surveyId }),
+    } as never);
+
+    expect(res.status).toBe(200);
+    expect(requireV3WorkspaceAccess).toHaveBeenCalledWith(
+      expect.objectContaining({ user: expect.any(Object) }),
+      workspaceId,
+      "readWrite",
+      "req-delete",
+      `/api/v3/surveys/${surveyId}`
+    );
+    expect(deleteSurvey).toHaveBeenCalledWith(surveyId);
+    expect(await res.json()).toEqual({
+      data: {
+        id: surveyId,
+      },
+    });
+  });
+
+  test("returns 200 with x-api-key when the key can delete in the survey workspace", async () => {
+    getServerSession.mockResolvedValue(null);
+    mockAuthenticateRequest.mockResolvedValue(apiKeyAuth as any);
+
+    const res = await DELETE(
+      createRequest(`http://localhost/api/v3/surveys/${surveyId}`, "req-api-key", {
+        "x-api-key": "fbk_test",
+      }),
+      {
+        params: Promise.resolve({ surveyId }),
+      } as never
+    );
+
+    expect(res.status).toBe(200);
+    expect(requireV3WorkspaceAccess).toHaveBeenCalledWith(
+      expect.objectContaining({ apiKeyId: "key_1" }),
+      workspaceId,
+      "readWrite",
+      "req-api-key",
+      `/api/v3/surveys/${surveyId}`
+    );
+  });
+
+  test("returns 400 when surveyId is invalid", async () => {
+    const res = await DELETE(createRequest("http://localhost/api/v3/surveys/not-a-cuid"), {
+      params: Promise.resolve({ surveyId: "not-a-cuid" }),
+    } as never);
+
+    expect(res.status).toBe(400);
+    expect(vi.mocked(getSurvey)).not.toHaveBeenCalled();
+  });
+
+  test("returns 403 when the survey does not exist", async () => {
+    vi.mocked(getSurvey).mockResolvedValueOnce(null);
+
+    const res = await DELETE(createRequest(`http://localhost/api/v3/surveys/${surveyId}`), {
+      params: Promise.resolve({ surveyId }),
+    } as never);
+
+    expect(res.status).toBe(403);
+    expect(deleteSurvey).not.toHaveBeenCalled();
+  });
+
+  test("returns 403 when the user lacks readWrite workspace access", async () => {
+    vi.mocked(requireV3WorkspaceAccess).mockResolvedValueOnce(
+      new Response(
+        JSON.stringify({
+          title: "Forbidden",
+          status: 403,
+          detail: "You are not authorized to access this resource",
+          requestId: "req-forbidden",
+        }),
+        { status: 403, headers: { "Content-Type": "application/problem+json" } }
+      )
+    );
+
+    const res = await DELETE(createRequest(`http://localhost/api/v3/surveys/${surveyId}`, "req-forbidden"), {
+      params: Promise.resolve({ surveyId }),
+    } as never);
+
+    expect(res.status).toBe(403);
+    expect(deleteSurvey).not.toHaveBeenCalled();
+    expect(queueAuditEvent).toHaveBeenCalledWith(
+      expect.objectContaining({
+        action: "deleted",
+        targetType: "survey",
+        targetId: "unknown",
+        organizationId: "unknown",
+        userId: "user_1",
+        userType: "user",
+        status: "failure",
+        oldObject: undefined,
+      })
+    );
+  });
+
+  test("returns 500 when survey deletion fails", async () => {
+    vi.mocked(deleteSurvey).mockRejectedValueOnce(new DatabaseError("db down"));
+
+    const res = await DELETE(createRequest(`http://localhost/api/v3/surveys/${surveyId}`, "req-db"), {
+      params: Promise.resolve({ surveyId }),
+    } as never);
+
+    expect(res.status).toBe(500);
+    const body = await res.json();
+    expect(body.code).toBe("internal_server_error");
+  });
+
+  test("returns 403 when the survey is deleted after authorization succeeds", async () => {
+    vi.mocked(deleteSurvey).mockRejectedValueOnce(new ResourceNotFoundError("Survey", surveyId));
+
+    const res = await DELETE(createRequest(`http://localhost/api/v3/surveys/${surveyId}`, "req-race"), {
+      params: Promise.resolve({ surveyId }),
+    } as never);
+
+    expect(res.status).toBe(403);
+    const body = await res.json();
+    expect(body.code).toBe("forbidden");
+    expect(queueAuditEvent).toHaveBeenCalledWith(
+      expect.objectContaining({
+        action: "deleted",
+        targetType: "survey",
+        targetId: surveyId,
+        organizationId: "org_1",
+        userId: "user_1",
+        userType: "user",
+        status: "failure",
+        oldObject: expect.objectContaining({
+          id: surveyId,
+          workspaceId: workspaceId,
+        }),
+      })
+    );
+  });
+
+  test("queues an audit log with target, actor, organization, and old object", async () => {
+    await DELETE(createRequest(`http://localhost/api/v3/surveys/${surveyId}`, "req-audit"), {
+      params: Promise.resolve({ surveyId }),
+    } as never);
+
+    expect(queueAuditEvent).toHaveBeenCalledWith(
+      expect.objectContaining({
+        action: "deleted",
+        targetType: "survey",
+        targetId: surveyId,
+        organizationId: "org_1",
+        userId: "user_1",
+        userType: "user",
+        status: "success",
+        oldObject: expect.objectContaining({
+          id: surveyId,
+          workspaceId: workspaceId,
+        }),
+      })
+    );
+  });
+});

apps/web/app/api/v3/surveys/[surveyId]/route.ts

@@ -0,0 +1,72 @@
+import { z } from "zod";
+import { logger } from "@formbricks/logger";
+import { DatabaseError, ResourceNotFoundError } from "@formbricks/types/errors";
+import { withV3ApiWrapper } from "@/app/api/v3/lib/api-wrapper";
+import { requireV3WorkspaceAccess } from "@/app/api/v3/lib/auth";
+import { problemForbidden, problemInternalError, successResponse } from "@/app/api/v3/lib/response";
+import { getSurvey } from "@/lib/survey/service";
+import { deleteSurvey } from "@/modules/survey/lib/surveys";
+
+export const DELETE = withV3ApiWrapper({
+  auth: "both",
+  action: "deleted",
+  targetType: "survey",
+  schemas: {
+    params: z.object({
+      surveyId: z.cuid2(),
+    }),
+  },
+  handler: async ({ parsedInput, authentication, requestId, instance, auditLog }) => {
+    const surveyId = parsedInput.params.surveyId;
+    const log = logger.withContext({ requestId, surveyId });
+
+    try {
+      const survey = await getSurvey(surveyId);
+
+      if (!survey) {
+        log.warn({ statusCode: 403 }, "Survey not found or not accessible");
+        return problemForbidden(requestId, "You are not authorized to access this resource", instance);
+      }
+
+      const authResult = await requireV3WorkspaceAccess(
+        authentication,
+        survey.workspaceId,
+        "readWrite",
+        requestId,
+        instance
+      );
+
+      if (authResult instanceof Response) {
+        return authResult;
+      }
+
+      if (auditLog) {
+        auditLog.targetId = survey.id;
+        auditLog.organizationId = authResult.organizationId;
+        auditLog.oldObject = survey;
+      }
+
+      const deletedSurvey = await deleteSurvey(surveyId);
+
+      return successResponse(
+        {
+          id: deletedSurvey.id,
+        },
+        { requestId }
+      );
+    } catch (error) {
+      if (error instanceof ResourceNotFoundError) {
+        log.warn({ errorCode: error.name, statusCode: 403 }, "Survey not found or not accessible");
+        return problemForbidden(requestId, "You are not authorized to access this resource", instance);
+      }
+
+      if (error instanceof DatabaseError) {
+        log.error({ error, statusCode: 500 }, "Database error");
+        return problemInternalError(requestId, "An unexpected error occurred.", instance);
+      }
+
+      log.error({ error, statusCode: 500 }, "V3 survey delete unexpected error");
+      return problemInternalError(requestId, "An unexpected error occurred.", instance);
+    }
+  },
+});

apps/web/app/api/v3/surveys/route.test.ts

@@ -314,8 +314,8 @@ describe("GET /api/v3/surveys", () => {
     const res = await GET(req, {} as any);
     const body = await res.json();
     expect(body.data[0]).not.toHaveProperty("blocks");
-    expect(body.data[0]).not.toHaveProperty("singleUse");
     expect(body.data[0]).not.toHaveProperty("_count");
+    expect(body.data[0]).not.toHaveProperty("singleUse");
     expect(body.data[0].id).toBe("s1");
     expect(body.data[0].workspaceId).toBe("ws_1");
   });

apps/web/app/lib/api/parse-and-validate-json-body.test.ts

@@ -93,17 +93,17 @@ describe("parseAndValidateJsonBody", () => {
       request,
       schema: z.object({
         finished: z.boolean(),
-        environmentId: z.string(),
+        workspaceId: z.string(),
       }),
       buildInput: (jsonInput) => ({
         ...(jsonInput as Record<string, unknown>),
-        environmentId: "env_123",
+        workspaceId: "ws_123",
       }),
     });
 
     expect(result).toEqual({
       data: {
-        environmentId: "env_123",
+        workspaceId: "ws_123",
         finished: true,
       },
     });

apps/web/app/lib/api/response.test.ts

@@ -339,6 +339,56 @@ describe("API Response Utilities", () => {
     });
   });
 
+  describe("conflictResponse", () => {
+    test("should return a conflict response", () => {
+      const message = "Resource already exists";
+      const details = { field: "singleUseId" };
+      const response = responses.conflictResponse(message, details);
+
+      expect(response.status).toBe(409);
+
+      return response.json().then((body) => {
+        expect(body).toEqual({
+          code: "conflict",
+          message,
+          details,
+        });
+      });
+    });
+
+    test("should handle undefined details", () => {
+      const message = "Resource already exists";
+      const response = responses.conflictResponse(message);
+
+      expect(response.status).toBe(409);
+
+      return response.json().then((body) => {
+        expect(body).toEqual({
+          code: "conflict",
+          message,
+          details: {},
+        });
+      });
+    });
+
+    test("should include CORS headers when cors is true", () => {
+      const message = "Resource already exists";
+      const response = responses.conflictResponse(message, undefined, true);
+
+      expect(response.headers.get("Access-Control-Allow-Origin")).toBe("*");
+      expect(response.headers.get("Access-Control-Allow-Methods")).toBe("GET, POST, PUT, DELETE, OPTIONS");
+      expect(response.headers.get("Access-Control-Allow-Headers")).toBe("Content-Type, Authorization");
+    });
+
+    test("should use custom cache control header when provided", () => {
+      const message = "Resource already exists";
+      const customCache = "no-cache";
+      const response = responses.conflictResponse(message, undefined, false, customCache);
+
+      expect(response.headers.get("Cache-Control")).toBe(customCache);
+    });
+  });
+
   describe("tooManyRequestsResponse", () => {
     test("should return a too many requests response", () => {
       const message = "Rate limit exceeded";

apps/web/app/lib/api/response.ts

@@ -16,7 +16,8 @@ interface ApiErrorResponse {
     | "method_not_allowed"
     | "not_authenticated"
     | "forbidden"
-    | "too_many_requests";
+    | "too_many_requests"
+    | "conflict";
   message: string;
   details: {
     [key: string]: string | string[] | number | number[] | boolean | boolean[];
@@ -236,6 +237,30 @@ const internalServerErrorResponse = (
   );
 };
 
+const conflictResponse = (
+  message: string,
+  details?: { [key: string]: string },
+  cors: boolean = false,
+  cache: string = "private, no-store"
+) => {
+  const headers = {
+    ...(cors && corsHeaders),
+    "Cache-Control": cache,
+  };
+
+  return Response.json(
+    {
+      code: "conflict",
+      message,
+      details: details || {},
+    } as ApiErrorResponse,
+    {
+      status: 409,
+      headers,
+    }
+  );
+};
+
 const tooManyRequestsResponse = (
   message: string,
   cors: boolean = false,
@@ -270,4 +295,5 @@ export const responses = {
   successResponse,
   tooManyRequestsResponse,
   forbiddenResponse,
+  conflictResponse,
 };

apps/web/app/lib/pipelines.test.ts

@@ -1,113 +1,84 @@
 import { PipelineTriggers } from "@prisma/client";
-import { afterEach, beforeEach, describe, expect, test, vi } from "vitest";
+import { beforeEach, describe, expect, test, vi } from "vitest";
+import { TResponsePipelineJobData, getBackgroundJobProducer } from "@formbricks/jobs";
 import { logger } from "@formbricks/logger";
 import { TResponse } from "@formbricks/types/responses";
-import { TPipelineInput } from "@/app/lib/types/pipelines";
-import { sendToPipeline } from "./pipelines";
+import { sendToPipeline } from "@/app/lib/pipelines";
+import { getJobsQueueingConfig } from "@/lib/jobs/config";
 
-// Mock the constants module
-vi.mock("@/lib/constants", () => ({
-  CRON_SECRET: "mocked-cron-secret",
-  WEBAPP_URL: "https://test.formbricks.com",
+const mockEnqueueResponsePipeline = vi.fn();
+
+vi.mock("@formbricks/jobs", () => ({
+  getBackgroundJobProducer: vi.fn(() => ({
+    enqueueResponsePipeline: mockEnqueueResponsePipeline,
+  })),
+}));
+
+vi.mock("@/lib/jobs/config", () => ({
+  getJobsQueueingConfig: vi.fn(),
 }));
 
-// Mock the logger
 vi.mock("@formbricks/logger", () => ({
   logger: {
     error: vi.fn(),
   },
 }));
 
-// Mock global fetch
-const mockFetch = vi.fn();
-global.fetch = mockFetch;
+describe("sendToPipeline", () => {
+  const testData: TResponsePipelineJobData = {
+    event: PipelineTriggers.responseCreated,
+    surveyId: "cm8ckvchx000008lb710n0gdn",
+    workspaceId: "cm8cmp9hp000008jf7l570ml2",
+    response: { id: "cm8cmpnjj000108jfdr9dfqe6" } as TResponse,
+  };
 
-describe("pipelines", () => {
-  // Reset mocks before each test
   beforeEach(() => {
     vi.clearAllMocks();
+    vi.mocked(getJobsQueueingConfig).mockReturnValue({
+      enabled: true,
+      redisUrl: "redis://localhost:6379",
+    });
   });
 
-  // Clean up after each test
-  afterEach(() => {
-    vi.clearAllMocks();
-  });
-
-  test("sendToPipeline should call fetch with correct parameters", async () => {
-    // Mock the fetch implementation to return a successful response
-    mockFetch.mockResolvedValueOnce({
-      ok: true,
-      json: async () => ({ success: true }),
+  test("enqueues the pipeline job through the BullMQ producer", async () => {
+    mockEnqueueResponsePipeline.mockResolvedValue({
+      jobId: "job-1",
+      jobName: "response-pipeline.process",
+      queueName: "background-jobs",
     });
 
-    // Create sample data for testing
-    const testData: TPipelineInput = {
-      event: PipelineTriggers.responseCreated,
-      surveyId: "cm8ckvchx000008lb710n0gdn",
-      workspaceId: "cm8cnq2hp000008jf7l570abc",
-      response: { id: "cm8cmpnjj000108jfdr9dfqe6" } as TResponse,
-    };
-
-    // Call the function with test data
     await sendToPipeline(testData);
 
-    // Check that fetch was called with the correct arguments
-    expect(mockFetch).toHaveBeenCalledTimes(1);
-    expect(mockFetch).toHaveBeenCalledWith("https://test.formbricks.com/api/pipeline", {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        "x-api-key": "mocked-cron-secret",
-      },
-      body: JSON.stringify({
-        workspaceId: testData.workspaceId,
-        surveyId: testData.surveyId,
+    expect(getBackgroundJobProducer).toHaveBeenCalledTimes(1);
+    expect(mockEnqueueResponsePipeline).toHaveBeenCalledWith(testData);
+  });
+
+  test("logs enqueue failures and rethrows", async () => {
+    const testError = new Error("Redis unavailable");
+    mockEnqueueResponsePipeline.mockRejectedValue(testError);
+
+    await expect(sendToPipeline(testData)).rejects.toThrow(testError);
+
+    expect(logger.error).toHaveBeenCalledWith(
+      {
+        error: testError,
         event: testData.event,
-        response: testData.response,
-      }),
+        surveyId: testData.surveyId,
+        workspaceId: testData.workspaceId,
+      },
+      "Error queueing pipeline event"
+    );
+  });
+
+  test("throws when BullMQ queueing is disabled", async () => {
+    vi.mocked(getJobsQueueingConfig).mockReturnValue({
+      enabled: false,
+      redisUrl: null,
     });
-  });
 
-  test("sendToPipeline should handle fetch errors", async () => {
-    // Mock fetch to throw an error
-    const testError = new Error("Network error");
-    mockFetch.mockRejectedValueOnce(testError);
-
-    // Create sample data for testing
-    const testData: TPipelineInput = {
-      event: PipelineTriggers.responseCreated,
-      surveyId: "cm8ckvchx000008lb710n0gdn",
-      workspaceId: "cm8cnq2hp000008jf7l570abc",
-      response: { id: "cm8cmpnjj000108jfdr9dfqe6" } as TResponse,
-    };
-
-    // Call the function
-    await sendToPipeline(testData);
-
-    // Check that the error was logged using logger
-    expect(logger.error).toHaveBeenCalledWith(testError, "Error sending event to pipeline");
-  });
-
-  test("sendToPipeline should throw error if CRON_SECRET is not set", async () => {
-    // For this test, we need to mock CRON_SECRET as undefined
-    // Let's use a more compatible approach to reset the mocks
-    const originalModule = await import("@/lib/constants");
-    const mockConstants = { ...originalModule, CRON_SECRET: undefined };
-
-    vi.doMock("@/lib/constants", () => mockConstants);
-
-    // Re-import the module to get the new mocked values
-    const { sendToPipeline: sendToPipelineNoSecret } = await import("./pipelines");
-
-    // Create sample data for testing
-    const testData: TPipelineInput = {
-      event: PipelineTriggers.responseCreated,
-      surveyId: "cm8ckvchx000008lb710n0gdn",
-      workspaceId: "cm8cnq2hp000008jf7l570abc",
-      response: { id: "cm8cmpnjj000108jfdr9dfqe6" } as TResponse,
-    };
-
-    // Expect the function to throw an error
-    await expect(sendToPipelineNoSecret(testData)).rejects.toThrow("CRON_SECRET is not set");
+    await expect(sendToPipeline(testData)).rejects.toThrow(
+      "BullMQ response pipeline queueing is not enabled"
+    );
+    expect(getBackgroundJobProducer).not.toHaveBeenCalled();
   });
 });

apps/web/app/lib/pipelines.ts

@@ -1,25 +1,21 @@
+import { TResponsePipelineJobData, getBackgroundJobProducer } from "@formbricks/jobs";
 import { logger } from "@formbricks/logger";
-import { TPipelineInput } from "@/app/lib/types/pipelines";
-import { CRON_SECRET, WEBAPP_URL } from "@/lib/constants";
+import { getJobsQueueingConfig } from "@/lib/jobs/config";
 
-export const sendToPipeline = async ({ event, surveyId, workspaceId, response }: TPipelineInput) => {
-  if (!CRON_SECRET) {
-    throw new Error("CRON_SECRET is not set");
+export const sendToPipeline = async (job: TResponsePipelineJobData): Promise<void> => {
+  try {
+    const jobsQueueingConfig = getJobsQueueingConfig();
+    if (!jobsQueueingConfig.enabled) {
+      throw new Error("BullMQ response pipeline queueing is not enabled");
+    }
+
+    const producer = getBackgroundJobProducer();
+    await producer.enqueueResponsePipeline(job);
+  } catch (error) {
+    logger.error(
+      { error, event: job.event, surveyId: job.surveyId, workspaceId: job.workspaceId },
+      "Error queueing pipeline event"
+    );
+    throw error;
   }
-
-  return fetch(`${WEBAPP_URL}/api/pipeline`, {
-    method: "POST",
-    headers: {
-      "Content-Type": "application/json",
-      "x-api-key": CRON_SECRET,
-    },
-    body: JSON.stringify({
-      workspaceId,
-      surveyId,
-      event,
-      response,
-    }),
-  }).catch((error) => {
-    logger.error(error, "Error sending event to pipeline");
-  });
 };