@explorer02/cfm-survey-sdk 0.0.1

package/dist/useSubmitResponse.js

@@ -0,0 +1,146 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatAnswers = formatAnswers;
+exports.buildSubmitRequestBody = buildSubmitRequestBody;
+exports.mapSubmitResponse = mapSubmitResponse;
+exports.buildExternalSubmitUrl = buildExternalSubmitUrl;
+exports.useSubmitResponse = useSubmitResponse;
+const react_1 = require("react");
+const SUBMIT_BASE_URL = "https://custom-p0.feedbook.me/api/feedback/survey/responseV2";
+const CLIENT_SUBMIT_PATH = "/api/survey/submit";
+function formatAnswers(answers) {
+    const result = {};
+    for (const key in answers) {
+        if (answers[key] === undefined || answers[key] === null)
+            continue;
+        result[key] = [String(answers[key])];
+    }
+    return result;
+}
+function buildSubmitRequestBody(answers, questions, token) {
+    const questionToAnswers = {};
+    const optionLevelAnswers = {};
+    for (const question of questions) {
+        const value = answers[question.id];
+        if (value === undefined || value === null)
+            continue;
+        const formatted = String(value);
+        questionToAnswers[question.submitQuestionId] = [formatted];
+        if (question.optionLevelQuestionId) {
+            optionLevelAnswers[question.optionLevelQuestionId] = [formatted];
+        }
+    }
+    return {
+        questionToAnswers,
+        quesIdVsAttachmentDetails: {},
+        optionLevelAnswers,
+        conjointTasks: [],
+        token,
+    };
+}
+function mapSubmitResponse(apiResponse, answers, questions) {
+    const raw = apiResponse;
+    const requestAnswers = buildSubmitRequestBody(answers, questions, "");
+    const submittedAnswers = questions
+        .filter((question) => answers[question.id] !== undefined)
+        .map((question) => {
+        const value = String(answers[question.id]);
+        const label = question.options.find((option) => String(option.value) === value)?.label ?? value;
+        return {
+            questionId: question.id,
+            text: question.text,
+            value,
+            label,
+        };
+    });
+    return {
+        responseId: raw.responseId ?? "",
+        answers: submittedAnswers,
+        questionToAnswers: requestAnswers.questionToAnswers,
+        optionLevelAnswers: requestAnswers.optionLevelAnswers,
+        raw: apiResponse,
+    };
+}
+function buildExternalSubmitUrl(instanceId, surveyLanguage = "en") {
+    const params = new URLSearchParams({
+        instanceId,
+        surveySubmitted: "true",
+        surveyLanguage,
+    });
+    return `${SUBMIT_BASE_URL}?${params.toString()}`;
+}
+function buildSubmitUrl(instanceId, surveyLanguage = "en") {
+    const params = new URLSearchParams({
+        instanceId,
+        surveySubmitted: "true",
+        surveyLanguage,
+    });
+    return `${CLIENT_SUBMIT_PATH}?${params.toString()}`;
+}
+function isSubmitInput(input) {
+    return (typeof input === "object" &&
+        input !== null &&
+        "instanceId" in input &&
+        "answers" in input);
+}
+function resolveSubmitInput(input, session, survey) {
+    if (isSubmitInput(input)) {
+        return {
+            ...input,
+            token: input.token ?? "",
+            surveyLanguage: input.surveyLanguage ?? session?.language ?? "en",
+            questions: input.questions ?? survey?.questions ?? [],
+        };
+    }
+    if (!session?.instanceId) {
+        throw new Error("Survey session not ready. Fetch survey before submitting.");
+    }
+    return {
+        answers: input,
+        instanceId: session.instanceId,
+        token: session.token ?? "",
+        surveyLanguage: session.language ?? "en",
+        questions: survey?.questions ?? [],
+    };
+}
+function useSubmitResponse(session, survey) {
+    const [data, setData] = (0, react_1.useState)(null);
+    const [loading, setLoading] = (0, react_1.useState)(false);
+    const [error, setError] = (0, react_1.useState)(null);
+    const submit = (0, react_1.useCallback)(async (input) => {
+        const resolved = resolveSubmitInput(input, session, survey);
+        console.log("SUBMIT INPUT:", resolved);
+        setLoading(true);
+        setError(null);
+        try {
+            const surveyLanguage = resolved.surveyLanguage ?? "en";
+            const requestBody = buildSubmitRequestBody(resolved.answers, resolved.questions ?? [], resolved.token);
+            console.log("FORMATTED BODY:", requestBody);
+            const response = await fetch(buildExternalSubmitUrl(resolved.instanceId, surveyLanguage), {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify(requestBody),
+            });
+            const responseData = await response.json().catch(() => null);
+            if (!response.ok) {
+                throw new Error(`Submit failed (${response.status}): ${JSON.stringify(responseData)}`);
+            }
+            console.log("API RESPONSE:", responseData);
+            const mapped = mapSubmitResponse(responseData, resolved.answers, resolved.questions ?? []);
+            console.log("MAPPED SUBMIT RESULT:", mapped);
+            setData(mapped);
+            return mapped;
+        }
+        catch (err) {
+            const submitError = err instanceof Error ? err : new Error(String(err));
+            console.error("SUBMIT ERROR:", submitError);
+            setError(submitError);
+            throw submitError;
+        }
+        finally {
+            setLoading(false);
+        }
+    }, [session, survey]);
+    return { submit, data, loading, error };
+}
+//# sourceMappingURL=useSubmitResponse.js.map

package/dist/useSubmitResponse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSubmitResponse.js","sourceRoot":"","sources":["../src/useSubmitResponse.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@explorer02/cfm-survey-sdk",
+  "version": "0.0.1",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "cfm-sdk": "./dist/cli/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "lint": "tsc --noEmit",
+    "prepare": "yarn build"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "@tanstack/react-query": "^5.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.1.6",
+    "@tanstack/react-query": "^5.0.0",
+    "react": "^19.1.0",
+    "typescript": "^5.8.3"
+  }
+}

package/src/analytics/analyticsTracker.ts

@@ -0,0 +1,48 @@
+import { sdkLogger } from '../logger/logger';
+import type { AnalyticsEvent } from './types';
+
+export function trackEvent(event: AnalyticsEvent) {
+  if (event.eventName === 'survey_session_summary') {
+    const {
+      completed,
+      totalDurationMs,
+      maxVisitedPageIndex,
+      totalQuestionsCount,
+      answeredQuestionsCount,
+      skippedQuestionsCount,
+      skippedQuestionIds,
+      validationErrorsCount,
+      backtrackCount,
+    } = event.metadata;
+
+    // Always log to console with Heading as ANALYTICS
+    sdkLogger.analytics(`Event: ${event.eventName} - SESSION SUMMARY TABLE:`);
+
+    const summaryTable = [
+      { Metric: 'Completion Status', Value: completed ? 'COMPLETED ✅' : 'ABANDONED ❌' },
+      { Metric: 'Total Time Spent', Value: `${(totalDurationMs / 1000).toFixed(2)} seconds` },
+      { Metric: 'Max Page Index Reached', Value: `${maxVisitedPageIndex}` },
+      { Metric: 'Total Questions', Value: totalQuestionsCount },
+      { Metric: 'Answered Questions', Value: answeredQuestionsCount },
+      { Metric: 'Skipped Optional Questions', Value: skippedQuestionsCount },
+      { Metric: 'Skipped Question IDs', Value: skippedQuestionIds.join(', ') || 'None' },
+      { Metric: 'Validation Errors Triggered', Value: validationErrorsCount },
+      { Metric: 'Backtrack Count', Value: backtrackCount },
+      {
+        Metric: 'Validation Error History',
+        Value:
+          event.metadata.validationHistory
+            ?.map(
+              h =>
+                `[Page ${h.pageIndex}] Attempt ${h.attemptNumber}: ${Object.keys(h.errors).join(', ')}`
+            )
+            .join(' | ') || 'NO Validation Erros Occurred',
+      },
+    ];
+
+    console.table(summaryTable);
+  } else {
+    // Always log to console with Heading as ANALYTICS
+    sdkLogger.analytics(`Event: ${event.eventName}`, event.metadata);
+  }
+}

package/src/analytics/types.ts

@@ -0,0 +1,80 @@
+export type AnalyticsEvent =
+  | {
+      eventName: 'survey_fetch_latency';
+      metadata: {
+        durationMs: number;
+        status: number | string;
+        success: boolean;
+        url: string;
+        payloadSize?: string;
+      };
+    }
+  | {
+      eventName: 'survey_submit_latency';
+      metadata: {
+        durationMs: number;
+        status: number | string;
+        success: boolean;
+        url: string;
+        requestSize?: string;
+        responseSize?: string;
+      };
+    }
+  | {
+      eventName: 'api_error';
+      metadata: {
+        apiName: string;
+        status: number | string;
+        url: string;
+        errorMessage: string;
+      };
+    }
+  | {
+      eventName: 'optional_question_skipped';
+      metadata: {
+        questionId: string;
+        pageIndex: number;
+      };
+    }
+  | {
+      eventName: 'backtrack_revisited';
+      metadata: {
+        fromPageIndex: number;
+        toPageIndex: number;
+        changedAnswers: Record<string, { oldValue: any; newValue: any }>;
+      };
+    }
+  | {
+      eventName: 'validation_error';
+      metadata: {
+        pageIndex: number;
+        errors: Record<string, string>;
+        attemptNumber: number;
+      };
+    }
+  | {
+      eventName: 'page_time_spent';
+      metadata: {
+        pageIndex: number;
+        durationMs: number;
+      };
+    }
+  | {
+      eventName: 'survey_session_summary';
+      metadata: {
+        maxVisitedPageIndex: number;
+        totalDurationMs: number;
+        completed: boolean;
+        totalQuestionsCount: number;
+        answeredQuestionsCount: number;
+        skippedQuestionsCount: number;
+        skippedQuestionIds: string[];
+        validationErrorsCount: number;
+        backtrackCount: number;
+        validationHistory: Array<{
+          pageIndex: number;
+          errors: Record<string, string>;
+          attemptNumber: number;
+        }>;
+      };
+    };

package/src/cli/deploy.ts

@@ -0,0 +1,205 @@
+import { execSync, spawn } from 'child_process';
+import readline from 'readline/promises';
+import { stdin as input, stdout as output } from 'process';
+import path from 'path';
+
+const colors = {
+  reset: '\x1b[0m',
+  bold: '\x1b[1m',
+  green: '\x1b[32m',
+  red: '\x1b[31m',
+  cyan: '\x1b[36m',
+  yellow: '\x1b[33m',
+  dim: '\x1b[2m',
+};
+
+// Simple interactive prompt using Node.js built-in readline
+async function askQuestion(query: string): Promise<string> {
+  const rl = readline.createInterface({ input, output });
+  try {
+    return (await rl.question(query)).trim();
+  } finally {
+    rl.close();
+  }
+}
+
+// Check if a shell executable is available in the user's system PATH
+function hasCommand(cmd: string): boolean {
+  try {
+    const checkCmd = process.platform === 'win32' ? `where ${cmd}` : `command -v ${cmd}`;
+    execSync(checkCmd, { stdio: 'ignore' });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// Execute a command synchronously and capture output/return code
+function runCommandSync(cmd: string, args: string[]): boolean {
+  try {
+    const fullCmd = `${cmd} ${args.join(' ')}`;
+    execSync(fullCmd, { stdio: 'inherit', shell: true } as any);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// Spawn an interactive command that inherits stdin/stdout/stderr
+function runCommandInteractive(cmd: string, args: string[]): Promise<number | null> {
+  return new Promise((resolve) => {
+    const child = spawn(cmd, args, {
+      stdio: 'inherit',
+      shell: true,
+    });
+
+    child.on('close', (code) => {
+      resolve(code);
+    });
+  });
+}
+
+// Main deployment wrapper
+export async function runDeployment() {
+  console.log(`\n${colors.bold}${colors.cyan}🚀 Starting CFM Vercel Deployment...${colors.reset}\n`);
+
+  // --- STEP 1: NODE.JS VERSION CHECK & AUTOMATED UPGRADE ---
+  const majorVersion = parseInt(process.version.slice(1).split('.')[0], 10);
+  console.log(`${colors.dim}Step 1/4: Checking Node.js version (current: ${process.version})...${colors.reset}`);
+
+  if (majorVersion < 18) {
+    console.log(`⚠️  ${colors.yellow}Outdated Node.js version detected. v18.0.0 or higher is required.${colors.reset}`);
+    
+    const isWin = process.platform === 'win32';
+    const isMac = process.platform === 'darwin';
+
+    if (isWin) {
+      if (hasCommand('winget')) {
+        console.log(`\n📦 ${colors.green}winget package manager found! Installing Node.js v18+ in background...${colors.reset}`);
+        const success = runCommandSync('winget', ['upgrade', 'OpenJS.NodeJS', '--silent', '--accept-package-agreements', '--accept-source-agreements']);
+        if (success) {
+          console.log(`\n✔ ${colors.green}Node.js installation triggered successfully. Please restart your terminal/command-prompt for changes to take effect.${colors.reset}\n`);
+          process.exit(0);
+        } else {
+          console.log(`\n❌ ${colors.red}winget update failed. Please update Node.js manually at https://nodejs.org/${colors.reset}\n`);
+          process.exit(1);
+        }
+      } else {
+        console.log(`\n❌ ${colors.red}winget package manager is not installed on this system.${colors.reset}`);
+        console.log(`${colors.bold}👉 To proceed, please either:${colors.reset}`);
+        console.log(`   1. Install winget (App Installer) from the Microsoft Store.`);
+        console.log(`   2. Or manually download and install Node.js (v18+) from: https://nodejs.org/\n`);
+        process.exit(1);
+      }
+    } else if (isMac) {
+      if (hasCommand('brew')) {
+        console.log(`\n📦 ${colors.green}Homebrew package manager found! Installing Node.js v18+ in background...${colors.reset}`);
+        const success = runCommandSync('brew', ['install', 'node']);
+        if (success) {
+          console.log(`\n✔ ${colors.green}Node.js installed successfully via Homebrew.${colors.reset}\n`);
+        } else {
+          console.log(`\n❌ ${colors.red}Homebrew installation failed. Please install Node.js manually at https://nodejs.org/${colors.reset}\n`);
+          process.exit(1);
+        }
+      } else {
+        console.log(`\n❌ ${colors.red}Homebrew package manager (brew) is not installed on this system.${colors.reset}`);
+        console.log(`${colors.bold}👉 To proceed, please either:${colors.reset}`);
+        console.log(`   1. Install Homebrew by running the following command in your terminal:`);
+        console.log(`      ${colors.cyan}/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"${colors.reset}`);
+        console.log(`   2. Or manually download and install Node.js (v18+) from: https://nodejs.org/\n`);
+        process.exit(1);
+      }
+    } else {
+      console.log(`\n❌ ${colors.red}Please install or update Node.js to v18+ using your system's package manager.${colors.reset}\n`);
+      process.exit(1);
+    }
+  } else {
+    console.log(`✔ ${colors.green}Node.js version (v${majorVersion}) is sufficient.${colors.reset}`);
+  }
+
+  // --- STEP 2: VERCEL CLI VERIFICATION ---
+  console.log(`\n${colors.dim}Step 2/4: Checking Vercel CLI...${colors.reset}`);
+  let vercelCmd = 'vercel';
+  let useNpx = false;
+
+  if (!hasCommand('vercel')) {
+    console.log(`❓ ${colors.yellow}Vercel CLI was not found on your system.${colors.reset}`);
+    const answer = await askQuestion(`👉 Would you like to install Vercel CLI globally? (Y/n): `);
+    
+    if (answer.toLowerCase() === 'y' || answer === '') {
+      console.log(`\n📥 ${colors.cyan}Installing Vercel CLI globally... (npm install -g vercel)${colors.reset}`);
+      const success = runCommandSync('npm', ['install', '-g', 'vercel']);
+      if (success && hasCommand('vercel')) {
+        console.log(`✔ ${colors.green}Vercel CLI installed successfully!${colors.reset}`);
+      } else {
+        console.log(`\n⚠️  ${colors.yellow}Global installation failed or permissions restricted.${colors.reset}`);
+        console.log(`ℹ ${colors.dim}Falling back: Running Vercel dynamically via npx.${colors.reset}`);
+        vercelCmd = 'npx --yes vercel';
+        useNpx = true;
+      }
+    } else {
+      console.log(`ℹ ${colors.dim}Skipping global installation. Running Vercel dynamically via npx.${colors.reset}`);
+      vercelCmd = 'npx --yes vercel';
+      useNpx = true;
+    }
+  } else {
+    console.log(`✔ ${colors.green}Vercel CLI is installed!${colors.reset}`);
+  }
+
+  // --- STEP 3: VERCEL LOGIN CHECK ---
+  console.log(`\n${colors.dim}Step 3/4: Checking Vercel Login...${colors.reset}`);
+  
+  // Use VERCEL_TOKEN if available
+  const hasToken = !!process.env.VERCEL_TOKEN;
+  let loggedIn = false;
+
+  if (hasToken) {
+    console.log(`✔ ${colors.green}VERCEL_TOKEN environment variable detected. Skipping login check.${colors.reset}`);
+    loggedIn = true;
+  } else {
+    try {
+      // Execute vercel whoami to check active session
+      const checkCmd = useNpx ? 'npx --yes vercel whoami' : 'vercel whoami';
+      execSync(checkCmd, { stdio: 'ignore', shell: true } as any);
+      loggedIn = true;
+      console.log(`✔ ${colors.green}Logged in!${colors.reset}`);
+    } catch {
+      loggedIn = false;
+    }
+  }
+
+  if (!loggedIn) {
+    console.log(`🔑 ${colors.yellow}Not logged in to Vercel.${colors.reset}`);
+    await askQuestion(`👉 Press [Enter] to login to Vercel... `);
+
+    const loginArgs = ['login'];
+    const loginCmd = useNpx ? 'npx' : 'vercel';
+    const finalArgs = useNpx ? ['--yes', 'vercel', ...loginArgs] : loginArgs;
+
+    const exitCode = await runCommandInteractive(loginCmd, finalArgs);
+    if (exitCode !== 0) {
+      throw new Error('Vercel login failed or was aborted.');
+    }
+    console.log(`\n✔ ${colors.green}Logged in successfully!${colors.reset}`);
+  }
+
+  // --- STEP 4: PRODUCTION DEPLOYMENT ---
+  console.log(`\n${colors.dim}Step 4/4: Deploying project to production...${colors.reset}`);
+  
+  const deployArgs = ['--prod', '--yes'];
+  if (hasToken) {
+    deployArgs.push('--token', process.env.VERCEL_TOKEN!);
+  }
+
+  const deployCmd = useNpx ? 'npx' : 'vercel';
+  const finalDeployArgs = useNpx ? ['--yes', 'vercel', ...deployArgs] : deployArgs;
+
+  console.log(`${colors.cyan}⚡ Running deployment in: ${process.cwd()}${colors.reset}\n`);
+
+  const deployExitCode = await runCommandInteractive(deployCmd, finalDeployArgs);
+  if (deployExitCode !== 0) {
+    throw new Error('Vercel deployment failed.');
+  }
+
+  console.log(`\n${colors.bold}${colors.green}🎉 Deployment completed successfully!${colors.reset}\n`);
+}

package/src/cli/index.ts

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+
+import { runDeployment } from './deploy';
+
+const args = process.argv.slice(2);
+const command = args[0];
+
+const colors = {
+  reset: '\x1b[0m',
+  bold: '\x1b[1m',
+  green: '\x1b[32m',
+  red: '\x1b[31m',
+  cyan: '\x1b[36m',
+  yellow: '\x1b[33m',
+};
+
+async function main() {
+  if (command === 'deploy') {
+    try {
+      await runDeployment();
+    } catch (error: any) {
+      console.error(`\n${colors.red}❌ Error: ${error.message || error}${colors.reset}`);
+      process.exit(1);
+    }
+  } else {
+    console.log(`\n${colors.bold}${colors.cyan}CFM SDK CLI Tool${colors.reset}`);
+    console.log(`\nUsage:`);
+    console.log(`  npx cfm-sdk deploy   - Deploy the current project to Vercel`);
+    process.exit(0);
+  }
+}
+
+main();

package/src/fetchSurvey/internalTypes.ts

@@ -0,0 +1,80 @@
+/**
+ * Raw API option/answer detail received from the remote survey config service.
+ */
+export type ApiAnswerDetail = {
+  // Option text label
+  answerText?: string;
+  // Whether the option should be hidden from UI render
+  hidden?: boolean;
+  // Additional metadata, such as hint/label flags for the scale boundaries
+  additional?: { isHintText?: boolean };
+  // Translations keyed by language code
+  translations?: Record<
+    string,
+    {
+      answerText?: string;
+    }
+  >;
+};
+
+/**
+ * Raw API question model representing the survey structure returned by the remote service.
+ */
+export type ApiQuestion = {
+  // Backend question unique ID
+  id?: string;
+  // Type identifier from API (e.g. "RATING", "SCALE", "TEXTFIELD", "MCQ")
+  answerType?: string;
+  // Primary text string for the question
+  questionText?: string;
+  // Rich HTML content representing the question text (fallback)
+  questionRichText?: string;
+  // List of answer options and scale hints
+  answerDetails?: ApiAnswerDetail[];
+  // Translations keyed by language code
+  translations?: Record<
+    string,
+    {
+      questionText?: string;
+      questionRichText?: string;
+    }
+  >;
+  // Configuration details for validation and other key-value settings
+  questionConfigs?: {
+    key: string;
+    value?: string[];
+    childConfigs?: {
+      key: string;
+      value?: string[];
+    }[];
+    translations?: Record<
+      string,
+      {
+        value?: string[];
+        valueRichText?: string[];
+      }
+    >;
+  }[];
+};
+
+/**
+ * Root envelope returned by the remote survey API endpoint.
+ */
+export type ApiResponse = {
+  // Unique distribution instance token/identifier
+  instanceId?: string;
+  // Localized survey language code
+  surveyLanguage?: string;
+  // Flat questions list if provided directly
+  questions?: ApiQuestion[];
+  // Multi-page survey page/question configurations
+  pages?: { questions?: ApiQuestion[] }[];
+  // Direct Data Transfer Object wrapping the full details from custom survey service
+  cfmSurveyDTO?: {
+    id?: string;
+    baseLanguage?: string;
+    surveyPages?: {
+      questionHolders?: { question?: ApiQuestion }[];
+    }[];
+  };
+};

package/src/fetchSurvey/logger/fetchLogger.ts

@@ -0,0 +1,34 @@
+import { sdkLogger } from '../../logger/logger';
+
+export function logFetchStart(url: string): void {
+  sdkLogger.info('Starting survey layout API fetch...', { url });
+}
+
+export function logFetchPerfFailure(durationMs: number, status: number | string, url: string): void {
+  sdkLogger.perf({
+    apiName: 'GET Survey Layout',
+    durationMs,
+    status,
+    url,
+    success: false,
+  });
+}
+
+export function logFetchPerfSuccess(durationMs: number, status: number, url: string, payloadSize: string): void {
+  sdkLogger.perf({
+    apiName: 'GET Survey Layout',
+    durationMs,
+    status,
+    url,
+    payloadSize,
+    success: true,
+  });
+}
+
+export function logFetchSuccess(apiResponse: any): void {
+  sdkLogger.success('Raw survey layout fetched successfully', apiResponse);
+}
+
+export function logFetchError(err: any): void {
+  sdkLogger.error('Failed to fetch raw survey layout', err);
+}

package/src/fetchSurvey/logger/mapperLogger.ts

@@ -0,0 +1,13 @@
+import { sdkLogger } from '../../logger/logger';
+
+export function logMapWarning(): void {
+  sdkLogger.warn('Cannot map survey: apiResponse is null or undefined');
+}
+
+export function logMapSuccess(mappedSurvey: any): void {
+  sdkLogger.success('Mapped survey layout successfully', mappedSurvey);
+}
+
+export function logMapError(err: any): void {
+  sdkLogger.error('Failed to map survey layout', err);
+}