@explorer02/cfm-survey-sdk 0.0.1 → 0.0.2

package/src/fetchSurvey/useFetchSurvey.ts

@@ -1,126 +0,0 @@
-import { useMemo } from 'react';
-import { useQuery } from '@tanstack/react-query';
-import { sdkQueryClient } from '../queryClient';
-import type { Survey, SurveySession } from './types';
-import type { ApiResponse } from './internalTypes';
-import { buildSurveyUrl, mapSurvey, extractSession } from './utils';
-import {
-  logFetchStart,
-  logFetchPerfFailure,
-  logFetchPerfSuccess,
-  logFetchSuccess,
-  logFetchError,
-} from './logger/fetchLogger';
-import { logMapWarning, logMapSuccess, logMapError } from './logger/mapperLogger';
-import { trackFetchLatency, trackFetchError } from './telemetry/fetchTelemetry';
-
-// Re-export all type definitions (domain entities and API response models)
-export * from './types';
-
-// Re-export all utility functions and configuration constants
-export * from './utils';
-
-/**
- * Performs the network request and returns the raw API response.
- */
-async function fetchRawSurveyData(url: string): Promise<ApiResponse> {
-  const startTime = performance.now();
-  logFetchStart(url);
-  try {
-    const response = await fetch(url, {
-      method: 'GET',
-      headers: { Accept: 'application/json' },
-      cache: 'force-cache',
-    });
-
-    const durationMs = performance.now() - startTime;
-
-    if (!response.ok) {
-      logFetchPerfFailure(durationMs, response.status, url);
-      trackFetchError(response.status, url, `Survey fetch failed (${response.status})`);
-      throw new Error(`Survey fetch failed (${response.status})`);
-    }
-    const apiResponse = (await response.json()) as ApiResponse;
-    const responseString = JSON.stringify(apiResponse);
-    const sizeInBytes = new Blob([responseString]).size;
-    const payloadSize = `${(sizeInBytes / 1024).toFixed(2)} KB`;
-    logFetchPerfSuccess(durationMs, response.status, url, payloadSize);
-
-    trackFetchLatency(durationMs, response.status, url, payloadSize);
-
-    logFetchSuccess(apiResponse);
-    return apiResponse;
-  } catch (err: any) {
-    const durationMs = performance.now() - startTime;
-    logFetchPerfFailure(durationMs, 'FAILED', url);
-    trackFetchError('FAILED', url, err?.message || String(err));
-    logFetchError(err);
-    throw err;
-  }
-}
-
-/**
- * A custom React hook that manages fetching survey configurations, mapping the API response,
- * and maintaining state for survey data, session tokens, loading states, and error handling.
- * Uses TanStack Query with a singleton QueryClient to run independently of client providers.
- *
- * @param options Optional settings including active language code and placeholders mapping.
- * @returns Object holding survey, session, loading status, and error references.
- */
-export function useFetchSurvey(options?: { language?: string; placeholders?: Record<string, string> }) {
-  const url = buildSurveyUrl();
-  const targetLanguage = options?.language;
-  const placeholders = options?.placeholders;
-
-  // The query is keyed purely by url, meaning we fetch the survey layout only once.
-  // refetch on window focus, check all refetch policies
-  const {
-    data: apiResponse,
-    error,
-    isLoading,
-    isSuccess,
-  } = useQuery(
-    {
-      queryKey: ['survey', url],
-      queryFn: () => fetchRawSurveyData(url),
-      enabled: !!url,
-    },
-    sdkQueryClient
-  );
-
-  // Map the raw data to the active language context dynamically on the client side using useMemo
-  const mapped = useMemo(() => {
-    // Only map the survey if it has successfully fetched
-    if (!isSuccess) {
-      return { survey: null, session: null };
-    }
-
-    if (!apiResponse) {
-      logMapWarning();
-      return { survey: null, session: null };
-    }
-
-    try {
-      const mappedSurvey = mapSurvey(apiResponse, targetLanguage, placeholders);
-      const surveySession = extractSession(apiResponse);
-      const updatedSession = surveySession ? { ...surveySession, language: mappedSurvey.language } : null;
-
-      logMapSuccess(mappedSurvey);
-
-      return {
-        survey: mappedSurvey,
-        session: updatedSession,
-      };
-    } catch (err) {
-      logMapError(err);
-      return { survey: null, session: null };
-    }
-  }, [apiResponse, isSuccess, targetLanguage]);
-
-  return {
-    survey: mapped.survey,
-    session: mapped.session,
-    fetching: isLoading,
-    fetchError: error,
-  };
-}

package/src/fetchSurvey/utils/constants.ts

@@ -1,11 +0,0 @@
-/**
- * The API base URL for fetching survey configuration data.
- */
-export const SURVEY_BASE_URL = 'https://custom-p0.feedbook.me/api/feedback/survey/cfm';
-
-/**
- * Fallback Instance ID/JWT Token representing standard default configuration.
- * Used when no instanceId is provided or is invalid.
- */
-export const DEFAULT_INSTANCE_ID =
-  'eyJhbGciOiJSUzI1NiJ9.eyJzdWIiOiJBY2Nlc3MgVG9rZW4gR2VuZXJhdGVkIEJ5IFNwcmlua2xyIiwic3VydmV5SWQiOiI2YTJlNWM2NDFiOGRiMmY5MDQ2Nzg4ODUiLCJpc3MiOiJTUFJJTktMUiIsInR5cCI6IkpXVCIsInN1cnZleU1vZGUiOiJTVEFOREFSRCIsInN1cnZleUF1dGhlbnRpY2F0aW9uU3RhdGUiOiJOT1RfUkVRVUlSRUQiLCJkaXN0cmlidXRpb25FbnRpdHlJZCI6IjZhMmU1ZDEzNDRjYTkzZjc3YTVlMzcyNyIsImF1ZCI6IlNQUklOS0xSIiwibmJmIjoxNzgxNDIyMTc5LCJzY29wZSI6WyJSRUFEIiwiV1JJVEUiXSwic3RhdGljU3VydmV5IjoidHJ1ZSIsInN1cnZleVJlc3BvbmRlclNuVHlwZSI6IkVYVEVSTkFMX0FQUExJQ0FUSU9OIiwic3VydmV5TGFuZ3VhZ2UiOiJlbiIsInBhcnRuZXJJZCI6OTAwNCwidG9rZW5UeXBlIjoiQUNDRVNTIiwiYXV0aFR5cGUiOiJTVVJWRVlfUkVTUE9OU0UiLCJpYXQiOjE3ODE0MjMzNzksImp0aSI6InNwcmlua2xyIn0.B4ffi1szwM_xQKXTlr0kQc9mVOS4qVbB5e6ir4NFuCoOmNmsl3PB1QeFJ5jPaQ42s0KTpbufPam9ja0Z84CJ620l2WtuS1RModEv7ZtuMNLWOixzRxZMduC5-V7WV85H6gr1e-HzX7wgqrxTk2Z9iTr-8AVuczlwScarCfqLhA-JE_EXkFScHoehmH7QB5q5-BfcxU32iQNYOk5NyeEHGAAWkkyiGPdrbE27njPnhTunB3kKgCBvHHLq0KmgoN9x_KnrB53O_0Xai419TT5vkBWlu5a_uotZckX014eQpxYH02w_LeOF8iWEKYe6R9ge-6DSbelaJSt6U6O8Fq-aXw';

package/src/fetchSurvey/utils/extractSurveyLanguages.ts

@@ -1,63 +0,0 @@
-import type { SurveyLanguage } from '../types';
-import type { ApiResponse } from '../internalTypes';
-
-const LANGUAGE_DISPLAY_NAMES: Record<string, string> = {
-  en: 'English',
-  hi: 'Hindi',
-  de: 'Deutsch',
-  es: 'Español',
-  fr: 'Français',
-  bn: 'Bengali',
-  gu: 'Gujarati',
-  it: 'Italiano',
-  ja: '日本語',
-  ko: '한국어',
-  mr: 'Marathi',
-  pa: 'Punjabi',
-  ta: 'Tamil',
-  te: 'Telugu',
-  ur: 'Urdu',
-  zh: '中文',
-};
-
-/**
- * Resolves the full human-readable display name for a given language code.
- *
- * @param code The ISO language code (e.g. 'de', 'en').
- * @returns The resolved display name string.
- */
-export function getLanguageName(code: string): string {
-  const norm = code.toLowerCase().trim();
-  return LANGUAGE_DISPLAY_NAMES[norm] || code.toUpperCase();
-}
-
-/**
- * Traverses all questions and translations to gather all unique languages supported by the survey.
- *
- * @param api The raw API response envelope containing the DTO pages.
- * @returns List of supported language objects with code and resolved names.
- */
-export function extractSurveyLanguages(api: ApiResponse): SurveyLanguage[] {
-  const dto = api.cfmSurveyDTO;
-  const languagesSet = new Set<string>();
-  const defaultLanguage = dto?.baseLanguage ?? 'en';
-  languagesSet.add(defaultLanguage);
-
-  if (dto && Array.isArray(dto.surveyPages)) {
-    dto.surveyPages.forEach(page => {
-      (page.questionHolders ?? []).forEach(holder => {
-        const q = holder.question;
-        if (q && q.translations) {
-          Object.keys(q.translations).forEach(lang => {
-            languagesSet.add(lang);
-          });
-        }
-      });
-    });
-  }
-
-  return Array.from(languagesSet).map(lang => ({
-    code: lang,
-    name: getLanguageName(lang),
-  }));
-}

package/src/fetchSurvey/utils/index.ts

@@ -1,7 +0,0 @@
-export * from './constants';
-export * from './url';
-export * from './mappers';
-export * from './extractSurveyLanguages';
-export * from './mapSurveyPages';
-
-

package/src/fetchSurvey/utils/mapSurveyPages.ts

@@ -1,35 +0,0 @@
-import type { SurveyPageData } from '../types';
-import type { ApiQuestion, ApiResponse } from '../internalTypes';
-import { mapQuestion } from './mappers/questionMapper';
-
-/**
- * Maps the raw DTO survey pages and their questions into UI-friendly structure.
- *
- * @param api The raw API response envelope containing survey DTO pages.
- * @param surveyLanguage The resolved target language.
- * @param placeholders Optional dictionary mapping placeholder keys to replacement values.
- * @returns Array of mapped SurveyPageData objects.
- */
-export function mapSurveyPages(
-  api: ApiResponse,
-  surveyLanguage: string,
-  placeholders?: Record<string, string>
-): SurveyPageData[] {
-  const dto = api.cfmSurveyDTO;
-  if (!dto || !Array.isArray(dto.surveyPages)) {
-    return [];
-  }
-
-  return dto.surveyPages.map((page, index) => {
-    const questions = (page.questionHolders ?? [])
-      .map(holder => holder.question)
-      .filter((q): q is ApiQuestion => Boolean(q))
-      .map(q => mapQuestion(q, surveyLanguage, placeholders));
-
-    return {
-      id: `page_${index}`,
-      title: `Page ${index + 1}`,
-      questions,
-    };
-  });
-}

package/src/fetchSurvey/utils/mappers/index.ts

@@ -1,2 +0,0 @@
-export * from './questionMapper';
-export * from './surveyMapper';

package/src/fetchSurvey/utils/mappers/questionMapper.ts

@@ -1,213 +0,0 @@
-import type { SurveyOption, SurveyQuestion } from '../../types';
-import type { ApiAnswerDetail, ApiQuestion } from '../../internalTypes';
-
-/**
- * Normalizes different API string types to standardized UI question types.
- *
- * @param answerType The raw type string from the API.
- * @returns Standardized widget representation ("rating" or "radio").
- */
-export function normalizeType(answerType?: string): 'rating' | 'radio' | 'text' {
-  const type = (answerType ?? '').toUpperCase();
-  if (type === 'TEXTFIELD') {
-    return 'text';
-  }
-  // Group ratings, numeric scale questions, and matrix components into a rating widget.
-  if (type === 'RATING' || type === 'SCALE' || type === 'RATING_MATRIX') {
-    return 'rating';
-  }
-  // Fallback to standard multiple-choice radio option layout.
-  return 'radio';
-}
-
-const SCALE_COLORS = [
-  '#e2001a', // 0
-  '#e4251b', // 1
-  '#ec610a', // 2
-  '#f18b00', // 3
-  '#f7b200', // 4
-  '#fcd900', // 5
-  '#d2dc00', // 6
-  '#9fca00', // 7
-  '#6bb300', // 8
-  '#339a00', // 9
-  '#008000', // 10
-];
-
-/**
- * Retrieves color representation based on rating scores.
- * Matches client's 11-point NPS scale layout with a dynamic HSL fallback for other scale lengths.
- *
- * @param value Numerical score of the rating option.
- * @returns Hex or HSL color string.
- */
-export function getColor(value: number): string {
-  // If the value corresponds to our predefined 11-point scale, return the exact color.
-  return SCALE_COLORS[value] ?? '#e20074';
-}
-
-/**
- * Extracts helper boundaries / label text (e.g., "Not Likely" at min, "Neutral" at mid, and "Extremely Likely" at max)
- * from the list of raw answer options returned by the API.
- *
- * @param answerDetails The list of answer details containing hint definitions.
- * @param language Optional language code to fetch the translated label text.
- * @returns Object holding resolved labels.
- */
-export function extractHintLabels(
-  answerDetails: ApiAnswerDetail[] = [],
-  language?: string
-): { minLabel?: string; midLabel?: string; maxLabel?: string } {
-  // Filter answer details that are flagged as hint text and are not hidden.
-  const hints = answerDetails
-    .filter(a => a.additional?.isHintText && !a.hidden)
-    .map(a => (language && a.translations?.[language]?.answerText) || a.answerText || '')
-    .filter(Boolean);
-
-  if (hints.length >= 3) {
-    return {
-      minLabel: hints[0],
-      midLabel: hints[1],
-      maxLabel: hints[2],
-    };
-  }
-
-  return {
-    // The first hint represents the minimum bounds label.
-    minLabel: hints[0],
-    // The second hint represents the maximum bounds label.
-    maxLabel: hints[1],
-  };
-}
-
-/**
- * Builds option models that are safe for components to select and render.
- * Generates automated numerical sequences for ratings if the server doesn't explicitly define options.
- *
- * @param question Raw API Question data structure.
- * @param type The normalized UI question type.
- * @param language Optional language code to fetch translated labels.
- * @returns Mapped survey options list.
- */
-export function buildOptions(
-  question: ApiQuestion,
-  type: 'rating' | 'radio' | 'text',
-  language?: string
-): SurveyOption[] {
-  if (type === 'text') {
-    return [];
-  }
-
-  const answerDetails = question.answerDetails ?? [];
-  // Filter out any hidden entries and metadata labels (hints) to get selectable responses.
-  const selectable = answerDetails.filter(a => !a.hidden && !a.additional?.isHintText);
-
-  // If the API defines explicit selectable options, parse them.
-  if (selectable.length > 0) {
-    const options = selectable.map(a => {
-      const rawText = (language && a.translations?.[language]?.answerText) || a.answerText || '';
-      const rawValue = a.answerText ?? '';
-      const numeric = Number(rawValue);
-      // Determine if value should be treated as a pure number or string.
-      const value = Number.isFinite(numeric) && rawValue.trim() !== '' ? numeric : rawValue;
-
-      const option: SurveyOption = {
-        label: rawText,
-        value,
-      };
-
-      // Assign rating color styles if it is a rating scale question with numeric values.
-      if (type === 'rating' && typeof value === 'number') {
-        option.color = getColor(value);
-      }
-
-      return option;
-    });
-
-    return options;
-  }
-
-  // If no options are provided but the question is a rating, default to a standard 0 to 10 scale.
-  if (type === 'rating') {
-    const options = Array.from({ length: 11 }, (_, i) => ({
-      label: String(i),
-      value: i,
-      color: getColor(i),
-    }));
-    return options;
-  }
-
-  return [];
-}
-
-export function mapQuestion(
-  raw: ApiQuestion,
-  language?: string,
-  placeholders?: Record<string, string>
-): SurveyQuestion {
-  const type = normalizeType(raw.answerType);
-  const { minLabel, midLabel, maxLabel } = extractHintLabels(raw.answerDetails, language);
-  const options = buildOptions(raw, type, language);
-  const questionId = raw.id ?? '';
-
-  const configs = raw.questionConfigs ?? [];
-  const required = configs.find(c => c.key === 'REQUIRED')?.value?.[0] === 'true';
-
-  const reqErrConfig = configs.find(c => c.key === 'REQUIRED_ERROR_MESSAGE');
-  let requiredErrorMessage = reqErrConfig?.value?.[0];
-  if (language && reqErrConfig?.translations?.[language]?.value?.[0]) {
-    requiredErrorMessage = reqErrConfig.translations[language].value[0];
-  }
-
-  const contentTypeConfig = configs.find(c => c.key === 'CONTENT_TYPE');
-  const maxCharConfig = contentTypeConfig?.childConfigs?.find(cc => cc.key === 'MAX_CHARACTER_COUNT');
-  const maxCharacterCount = maxCharConfig?.value?.[0] ? Number(maxCharConfig.value[0]) : undefined;
-
-  let midLabelIndex: number | undefined = undefined;
-  if (type === 'rating' && midLabel) {
-    if (options.length === 11) {
-      midLabelIndex = 7.5;
-    } else {
-      midLabelIndex = (options.length - 1) / 2;
-    }
-  }
-
-  let text =
-    (language && raw.translations?.[language]?.questionRichText) ||
-    (language && raw.translations?.[language]?.questionText) ||
-    raw.questionRichText ||
-    raw.questionText ||
-    '';
-
-  if (placeholders) {
-    text = text.replace(/\{\{(\w+)\}\}/g, (match, key) => {
-      return placeholders[key] !== undefined ? placeholders[key] : match;
-    });
-  }
-
-  // Extract text input placeholder from answerDetails
-  let placeholder: string | undefined = undefined;
-  if (type === 'text') {
-    const textDetail = raw.answerDetails?.[0];
-    if (textDetail) {
-      placeholder = (language && textDetail.translations?.[language]?.answerText) || textDetail.answerText;
-    }
-  }
-
-  const question: SurveyQuestion = {
-    id: questionId,
-    text,
-    type,
-    options,
-    required,
-    ...(requiredErrorMessage ? { requiredErrorMessage } : {}),
-    ...(minLabel ? { minLabel } : {}),
-    ...(midLabel ? { midLabel } : {}),
-    ...(midLabelIndex !== undefined ? { midLabelIndex } : {}),
-    ...(maxLabel ? { maxLabel } : {}),
-    ...(maxCharacterCount !== undefined ? { maxCharacterCount } : {}),
-    ...(placeholder ? { placeholder } : {}),
-  };
-
-  return question;
-}

package/src/fetchSurvey/utils/mappers/surveyMapper.ts

@@ -1,69 +0,0 @@
-import type { Survey, SurveyLanguage, SurveySession, SurveyPageData } from '../../types';
-import type { ApiQuestion, ApiResponse } from '../../internalTypes';
-import { extractSurveyLanguages } from '../extractSurveyLanguages';
-import { mapSurveyPages } from '../mapSurveyPages';
-
-/**
- * Traverses different possible nesting structures of the Survey API configuration
- * to extract a flat list of questions.
- *
- * @param api The root API response envelope.
- * @returns Array of Raw API Questions.
- */
-export function extractQuestions(api: ApiResponse): ApiQuestion[] {
-  const surveyPages = api.cfmSurveyDTO?.surveyPages ?? [];
-  return surveyPages.flatMap(
-    page => page.questionHolders?.map(holder => holder.question).filter((q): q is ApiQuestion => Boolean(q)) ?? []
-  );
-}
-
-/**
- * Extracts and initializes the session tracking metadata if the API returns a valid instance ID.
- *
- * @param api The root API response envelope.
- * @returns SurveySession details or null if invalid.
- */
-export function extractSession(api: ApiResponse): SurveySession | null {
-  if (!api.instanceId?.trim()) return null;
-
-  return {
-    instanceId: api.instanceId.trim(),
-    // Resolve survey language, falling back to base language configuration.
-    language: api.surveyLanguage ?? api.cfmSurveyDTO?.baseLanguage ?? 'en',
-  };
-}
-
-/**
- * Resolves the primary survey language based on input selection and API fallback values.
- *
- * @param api The raw API response envelope.
- * @param language Optional target language selection override.
- * @returns The resolved language code.
- */
-export function resolveSurveyLanguage(api: ApiResponse, language?: string): string {
-  return language ?? api.surveyLanguage ?? api.cfmSurveyDTO?.baseLanguage ?? 'en';
-}
-
-/**
- * Maps the raw API response layout configuration into a clean Survey data structure.
- * Handles localization language setup and placeholder parsing.
- *
- * @param api The raw API response envelope.
- * @param language Optional language locale string override.
- * @param placeholders Optional dictionary mapping placeholder keys to replacement values.
- * @returns The fully mapped Survey object.
- */
-export function mapSurvey(api: ApiResponse, language?: string, placeholders?: Record<string, string>): Survey {
-  const surveyLanguage = resolveSurveyLanguage(api, language);
-  const languages = extractSurveyLanguages(api);
-  const pages = mapSurveyPages(api, surveyLanguage, placeholders);
-
-  return {
-    id: api.cfmSurveyDTO?.id ?? '',
-    language: surveyLanguage,
-    languages,
-    pages,
-  };
-}
-
-

package/src/fetchSurvey/utils/url.ts

@@ -1,21 +0,0 @@
-import { SURVEY_BASE_URL, DEFAULT_INSTANCE_ID } from './constants';
-
-/**
- * Constructs the external URL used to call the remote survey service api.
- *
- * @param instanceId The instance identifier token.
- * @returns Fully constructed target URL.
- */
-export function buildExternalSurveyUrl(instanceId: string): string {
-  return `${SURVEY_BASE_URL}?instanceId=${encodeURIComponent(instanceId)}&draftPreview=false`;
-}
-
-/**
- * High-level function that constructs the survey fetch URL.
- *
- * @returns Target URL for fetch requests.
- */
-export function buildSurveyUrl(): string {
-  return buildExternalSurveyUrl(DEFAULT_INSTANCE_ID);
-}
-

package/src/index.ts

@@ -1,6 +0,0 @@
-export { useSurveySDK } from './surveySDK/useSurveySDK';
-export {
-  type SurveyQuestion,
-  type SurveyLanguage,
-} from './fetchSurvey/useFetchSurvey';
-

package/src/logger/logger.ts

@@ -1,71 +0,0 @@
-export type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'success' | 'perf' | 'analytics';
-
-let loggingEnabled = false;
-
-// CSS styles for console log level badges
-const BADGE_STYLES: Record<LogLevel, string> = {
-  debug: 'background: #7f8c8d; color: #fff; padding: 2px 5px; border-radius: 3px; font-weight: bold;',
-  info: 'background: #2980b9; color: #fff; padding: 2px 5px; border-radius: 3px; font-weight: bold;',
-  warn: 'background: #f1c40f; color: #000; padding: 2px 5px; border-radius: 3px; font-weight: bold;',
-  error: 'background: #e74c3c; color: #fff; padding: 2px 5px; border-radius: 3px; font-weight: bold;',
-  success: 'background: #2ecc71; color: #fff; padding: 2px 5px; border-radius: 3px; font-weight: bold;',
-  perf: 'background: #9b59b6; color: #fff; padding: 2px 5px; border-radius: 3px; font-weight: bold;',
-  analytics: 'background: #e20074; color: #fff; padding: 2px 5px; border-radius: 3px; font-weight: bold;',
-};
-
-/**
- * Writes formatted badges and log details into the console if logging is enabled.
- * Note: analytics level logs are always printed regardless of debug settings.
- *
- * @param level Logging categorization level (debug, info, warn, error, success, analytics).
- * @param message Description message text.
- * @param meta Optional auxiliary metadata/payload.
- */
-function writeLog(level: LogLevel, message: string, meta?: any) {
-  if (!loggingEnabled && level !== 'analytics') return;
-
-  const timestamp = new Date().toLocaleTimeString();
-  const badge = `%c[SDK:${level.toUpperCase()}]`;
-  const style = BADGE_STYLES[level];
-
-  if (meta !== undefined) {
-    console.log(`[${timestamp}] ${badge}`, style, message, meta);
-  } else {
-    console.log(`[${timestamp}] ${badge}`, style, message);
-  }
-}
-
-/**
- * A central namespace containing logging helpers for debugging, warnings, success,
- * and API monitoring. Output logs are formatted with custom browser styles.
- */
-export const sdkLogger = {
-  setEnabled: (val: boolean) => {
-    loggingEnabled = val;
-  },
-  isEnabled: () => {
-    return loggingEnabled;
-  },
-  debug: (msg: string, meta?: any) => writeLog('debug', msg, meta),
-  info: (msg: string, meta?: any) => writeLog('info', msg, meta),
-  warn: (msg: string, meta?: any) => writeLog('warn', msg, meta),
-  error: (msg: string, meta?: any) => writeLog('error', msg, meta),
-  success: (msg: string, meta?: any) => writeLog('success', msg, meta),
-  analytics: (msg: string, meta?: any) => writeLog('analytics', msg, meta),
-  perf: (metric: {
-    apiName: string;
-    durationMs: number;
-    status: number | string;
-    url: string;
-    requestSize?: string;
-    responseSize?: string;
-    payloadSize?: string;
-    success: boolean;
-  }) => {
-    writeLog(
-      'perf',
-      `${metric.apiName} completed in ${metric.durationMs.toFixed(2)}ms | Status: ${metric.status}`,
-      metric
-    );
-  },
-};