@charzing/vehicle-utils 0.2.2 → 0.2.3

package/dist/cjs/index.d.ts

@@ -321,13 +321,18 @@ interface FirebaseStorageConfig {
 }
 /**
  * 차량 이미지 파라미터
+ *
+ * ✅ 통일된 필드명 사용:
+ * - brandId (brand ❌)
+ * - modelId (model ❌)
+ * - year (number 타입)
  */
 interface VehicleImageParams {
     /** 브랜드 ID (소문자) */
-    brand: BrandId | string;
-    /** 모델 슬러그 (소문자, 하이픈) */
-    model: ModelSlug | string;
-    /** 연식 */
+    brandId: BrandId | string;
+    /** 모델 ID (소문자, 하이픈) */
+    modelId: ModelSlug | string;
+    /** 연식 (number 타입) */
     year: number;
     /** 트림 슬러그 (선택적, 소문자, 하이픈) */
     trim?: TrimSlug | string;
@@ -375,6 +380,76 @@ interface ImageFallbackOptions {
     defaultImageUrl?: string;
 }
 
+/**
+ * Year Template 관련 타입 정의
+ *
+ * Year Template은 여러 연도를 하나로 묶어 관리하는 시스템입니다.
+ * 동일한 스펙을 가진 여러 연도의 차량을 효율적으로 관리합니다.
+ */
+
+/**
+ * Year Template 이미지 정보
+ */
+interface YearTemplateImages {
+    /** 메인 이미지 URL */
+    main: string;
+    /** 추가 이미지 URL 목록 (선택적) */
+    additional?: string[];
+}
+/**
+ * Year Template
+ *
+ * 여러 연도를 하나로 묶어 관리하는 템플릿
+ *
+ * @example
+ * {
+ *   id: 'ioniq-5-exclusive-2023-2025',
+ *   name: 'Exclusive 2023-2025',
+ *   trimId: 'exclusive',
+ *   trimName: 'Exclusive',
+ *   years: [2023, 2024, 2025],
+ *   images: {
+ *     main: 'https://.../.../2024/hyundai__ioniq-5__2024__exclusive.png'
+ *   }
+ * }
+ */
+interface YearTemplate {
+    /** 템플릿 ID */
+    id: string;
+    /** 템플릿명 */
+    name: string;
+    /** 트림 ID */
+    trimId: TrimId;
+    /** 트림명 */
+    trimName: string;
+    /** 포함된 연도들 (✅ number[] 타입) */
+    years: number[];
+    /** 이미지 정보 (선택적) */
+    images?: YearTemplateImages;
+    /** 생성일 */
+    createdAt?: Date;
+    /** 수정일 */
+    updatedAt?: Date;
+}
+/**
+ * Year Document (개별 연도 문서)
+ *
+ * Template에 속하지 않은 개별 연도 또는
+ * Template과 연결된 연도 문서
+ */
+interface YearDocument {
+    /** 연도 (✅ number 타입) */
+    year: number;
+    /** 소속 템플릿 ID (선택적) */
+    templateId?: string;
+    /** 이 연도만의 이미지 URL (선택적) */
+    imageUrl?: string;
+    /** 생성일 */
+    createdAt?: Date;
+    /** 수정일 */
+    updatedAt?: Date;
+}
+
 /**
  * 브랜드 매핑 유틸리티
  *
@@ -690,25 +765,49 @@ declare function getCachedModelCount(): number;
  * ⚠️ 주의: 이 파일은 순수 함수만 포함합니다.
  * Firebase SDK나 업로드 로직은 포함하지 않습니다.
  */
-interface ImagePathParams {
-    brandId: string;
-    modelId: string;
-    year: number;
-    trim?: string;
-}
+
 /**
  * 차량 이미지 파일명 생성
- * 예: kia__niro-ev__2022__standard.png
+ *
+ * @example
+ * generateImageFilename({
+ *   brandId: 'kia',
+ *   modelId: 'niro-ev',
+ *   year: 2022,
+ *   trim: 'standard'
+ * })
+ * // Returns: 'kia__niro-ev__2022__standard.png'
  */
-declare function generateImageFilename(params: ImagePathParams): string;
+declare function generateImageFilename(params: VehicleImageParams): string;
 /**
  * Storage 경로 생성 (업로드용)
- * 예: vehicle-images/KIA/NIRO-EV/2022/kia__niro-ev__2022__standard.png
+ *
+ * @example
+ * generateStoragePath({
+ *   brandId: 'kia',
+ *   modelId: 'niro-ev',
+ *   year: 2022,
+ *   trim: 'standard'
+ * })
+ * // Returns: 'vehicle-images/KIA/NIRO-EV/2022/kia__niro-ev__2022__standard.png'
  */
-declare function generateStoragePath(params: ImagePathParams): string;
+declare function generateStoragePath(params: VehicleImageParams): string;
 /**
  * 완전한 Firebase Storage URL 생성 (읽기용)
- */
-declare function generateVehicleImageUrl(params: ImagePathParams): string;
+ *
+ * ✅ 파라미터 검증: brandId, modelId, year 필수
+ * ❌ Fallback 금지: 잘못된 파라미터 시 에러 throw
+ *
+ * @throws {Error} brandId, modelId, year가 없으면 에러
+ *
+ * @example
+ * generateVehicleImageUrl({
+ *   brandId: 'kia',
+ *   modelId: 'niro-ev',
+ *   year: 2022
+ * })
+ * // Returns: 'https://firebasestorage.googleapis.com/.../vehicle-images%2FKIA%2FNIRO-EV%2F2022%2Fkia__niro-ev__2022.png?alt=media'
+ */
+declare function generateVehicleImageUrl(params: VehicleImageParams): string;
 
-export { type BatteryInfo, type Brand, type BrandId, type BrandMapping, type CompletedVehicle, type DriveType, type FirebaseStorageConfig, type ImageFallbackOptions, type ImageFallbackStrategy, type ImageFilename, type ImagePath, type ImagePathParams, type ImageUrlOptions, type Model, type ModelId, type ModelMapping$1 as ModelMapping, type ModelSlug, SUPPORTED_BRANDS, type StorageBrandName, type TrimId, type TrimMapping, type TrimSlug, type UserVehicle, type VehicleDetails, type VehicleImageParams, type VehicleModel, type VehicleTrim, type VehicleVariant, convertKoreanToEnglish, findBestModelMatch, generateImageFilename, generateStoragePath, generateVehicleImageUrl, getBrandMapping$1 as getBrandMapping, getBrandModels, getBrandNameEnglish, getBrandNameKorean, getCachedBrandCount, getCachedModelCount, getBrandMapping as getDynamicBrandMapping, getModelMapping as getDynamicModelMapping, getModelMapping$1 as getModelMapping, getModelSlug, getStorageBrandName, initializeBrandMappings, initializeModelMappings, isInitialized$1 as isBrandMappingInitialized, isInitialized as isModelMappingInitialized, normalizeBrandId, normalizeModelId, resetCache$1 as resetBrandCache, resetCache as resetModelCache, toSlug };
+export { type BatteryInfo, type Brand, type BrandId, type BrandMapping, type CompletedVehicle, type DriveType, type FirebaseStorageConfig, type ImageFallbackOptions, type ImageFallbackStrategy, type ImageFilename, type ImagePath, type ImageUrlOptions, type Model, type ModelId, type ModelMapping$1 as ModelMapping, type ModelSlug, SUPPORTED_BRANDS, type StorageBrandName, type TrimId, type TrimMapping, type TrimSlug, type UserVehicle, type VehicleDetails, type VehicleImageParams, type VehicleModel, type VehicleTrim, type VehicleVariant, type YearDocument, type YearTemplate, type YearTemplateImages, convertKoreanToEnglish, findBestModelMatch, generateImageFilename, generateStoragePath, generateVehicleImageUrl, getBrandMapping$1 as getBrandMapping, getBrandModels, getBrandNameEnglish, getBrandNameKorean, getCachedBrandCount, getCachedModelCount, getBrandMapping as getDynamicBrandMapping, getModelMapping as getDynamicModelMapping, getModelMapping$1 as getModelMapping, getModelSlug, getStorageBrandName, initializeBrandMappings, initializeModelMappings, isInitialized$1 as isBrandMappingInitialized, isInitialized as isModelMappingInitialized, normalizeBrandId, normalizeModelId, resetCache$1 as resetBrandCache, resetCache as resetModelCache, toSlug };

package/dist/cjs/index.js

@@ -459,6 +459,15 @@ function generateStoragePath(params) {
   return `vehicle-images/${storageBrand}/${storageModel}/${year}/${filename}`;
 }
 function generateVehicleImageUrl(params) {
+  if (!params.brandId) {
+    throw new Error("brandId is required");
+  }
+  if (!params.modelId) {
+    throw new Error("modelId is required");
+  }
+  if (!params.year) {
+    throw new Error("year is required");
+  }
   const path = generateStoragePath(params);
   const encodedPath = encodeURIComponent(path);
   return `${FIREBASE_STORAGE_BASE}/${encodedPath}?alt=media`;

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/index.ts","../../src/brand/mapping.ts","../../src/brand/dynamic-mapping.ts","../../src/model/mapping.ts","../../src/model/dynamic-mapping.ts","../../src/image/url-generator.ts"],"sourcesContent":["/**\n * @charzing/vehicle-utils\n *\n * 차징 플랫폼 전체에서 사용하는 차량 데이터 유틸리티\n */\n\n// ===== 타입 =====\nexport type * from './types';\n\n// ===== 브랜드 관련 (정적) =====\nexport {\n  normalizeBrandId,\n  getBrandNameKorean,\n  getBrandNameEnglish,\n  getStorageBrandName,\n  getBrandMapping,\n  SUPPORTED_BRANDS\n} from './brand/mapping';\n\n// ===== 브랜드 관련 (동적) ⭐ NEW =====\nexport {\n  initializeBrandMappings,\n  getBrandMapping as getDynamicBrandMapping,\n  isInitialized as isBrandMappingInitialized,\n  resetCache as resetBrandCache,\n  getCachedBrandCount\n} from './brand/dynamic-mapping';\n\n// ===== 모델 관련 (정적) =====\nexport {\n  toSlug,\n  convertKoreanToEnglish,\n  normalizeModelId,\n  findBestModelMatch,\n  getModelSlug,\n  getModelMapping\n} from './model/mapping';\n\n// ===== 모델 관련 (동적) ⭐ NEW =====\nexport {\n  initializeModelMappings,\n  getModelMapping as getDynamicModelMapping,\n  getBrandModels,\n  isInitialized as isModelMappingInitialized,\n  resetCache as resetModelCache,\n  getCachedModelCount\n} from './model/dynamic-mapping';\n\n// ===== 이미지 URL/경로 생성 (순수 함수만) ⭐ UPDATED =====\nexport {\n  generateImageFilename,\n  generateStoragePath,\n  generateVehicleImageUrl,\n  type ImagePathParams\n} from './image/url-generator';\n","/**\n * 브랜드 매핑 유틸리티\n *\n * 한글/영문 브랜드명 변환, Firestore ID 정규화, Storage 브랜드명 매핑\n */\n\nimport type { BrandId, BrandMapping, StorageBrandName } from '../types/brand';\n\n/**\n * 한글 → Firestore ID 매핑 테이블\n */\nconst KOREAN_TO_ID: Record<string, BrandId> = {\n  '현대': 'hyundai',\n  'HYUNDAI': 'hyundai',\n  'Hyundai': 'hyundai',\n\n  '기아': 'kia',\n  'KIA': 'kia',\n  'Kia': 'kia',\n\n  '테슬라': 'tesla',\n  'TESLA': 'tesla',\n  'Tesla': 'tesla',\n\n  'BMW': 'bmw',\n  'bmw': 'bmw',\n  '비엠더블유': 'bmw',\n\n  '메르세데스-벤츠': 'mercedes-benz',\n  'Mercedes-Benz': 'mercedes-benz',\n  'MERCEDES-BENZ': 'mercedes-benz',\n  '벤츠': 'mercedes-benz',\n  'Benz': 'mercedes-benz',\n  'BENZ': 'mercedes-benz',\n\n  '메르세데스-마이바흐': 'mercedes-maybach',\n  'Mercedes-Maybach': 'mercedes-maybach',\n  'MERCEDES-MAYBACH': 'mercedes-maybach',\n  '마이바흐': 'mercedes-maybach',\n  'Maybach': 'mercedes-maybach',\n  'MAYBACH': 'mercedes-maybach',\n\n  '아우디': 'audi',\n  'AUDI': 'audi',\n  'Audi': 'audi',\n\n  '포르쉐': 'porsche',\n  '포르셰': 'porsche',\n  'PORSCHE': 'porsche',\n  'Porsche': 'porsche',\n\n  'MINI': 'mini',\n  'Mini': 'mini',\n  'mini': 'mini',\n  '미니': 'mini'\n};\n\n/**\n * Firestore ID → 한글 브랜드명 매핑\n */\nconst ID_TO_KOREAN: Record<BrandId, string> = {\n  'hyundai': '현대',\n  'kia': '기아',\n  'tesla': '테슬라',\n  'bmw': 'BMW',\n  'mercedes-benz': '메르세데스-벤츠',\n  'mercedes-maybach': '메르세데스-마이바흐',\n  'audi': '아우디',\n  'porsche': '포르쉐',\n  'mini': '미니'\n};\n\n/**\n * Firestore ID → 영문 브랜드명 매핑\n */\nconst ID_TO_ENGLISH: Record<BrandId, string> = {\n  'hyundai': 'HYUNDAI',\n  'kia': 'KIA',\n  'tesla': 'TESLA',\n  'bmw': 'BMW',\n  'mercedes-benz': 'Mercedes-Benz',\n  'mercedes-maybach': 'Mercedes-Maybach',\n  'audi': 'AUDI',\n  'porsche': 'PORSCHE',\n  'mini': 'MINI'\n};\n\n/**\n * Firestore ID → Firebase Storage 브랜드명 매핑\n * Mercedes-Benz와 Mercedes-Maybach는 'BENZ'로 통합\n */\nconst ID_TO_STORAGE: Record<BrandId, StorageBrandName> = {\n  'hyundai': 'HYUNDAI',\n  'kia': 'KIA',\n  'tesla': 'TESLA',\n  'bmw': 'BMW',\n  'mercedes-benz': 'BENZ',        // ⚠️ BENZ로 통합\n  'mercedes-maybach': 'BENZ',     // ⚠️ BENZ로 통합\n  'audi': 'AUDI',\n  'porsche': 'PORSCHE',\n  'mini': 'MINI'\n};\n\n/**\n * 브랜드 ID 정규화 (소문자 통일)\n *\n * @param brandInput - 브랜드명 (한글, 영문, 대소문자 무관)\n * @returns Firestore 브랜드 ID (소문자, 하이픈)\n *\n * @example\n * ```typescript\n * normalizeBrandId('현대'); // 'hyundai'\n * normalizeBrandId('BMW'); // 'bmw'\n * normalizeBrandId('Mercedes-Benz'); // 'mercedes-benz'\n * ```\n */\nexport function normalizeBrandId(brandInput: string): BrandId {\n  // 1. 매핑 테이블에서 직접 찾기\n  if (brandInput in KOREAN_TO_ID) {\n    return KOREAN_TO_ID[brandInput];\n  }\n\n  // 2. 소문자 변환 후 확인\n  const lowercased = brandInput.toLowerCase().trim();\n  if (lowercased in KOREAN_TO_ID) {\n    return KOREAN_TO_ID[lowercased];\n  }\n\n  // 3. 이미 올바른 Firestore ID인 경우\n  if (Object.values(KOREAN_TO_ID).includes(lowercased as BrandId)) {\n    return lowercased as BrandId;\n  }\n\n  // 4. 매칭 실패 시 소문자 변환 결과 반환 (fallback)\n  console.warn(`[normalizeBrandId] 알 수 없는 브랜드: \"${brandInput}\", fallback: \"${lowercased}\"`);\n  return lowercased as BrandId;\n}\n\n/**\n * 한글 브랜드명 가져오기\n *\n * @param brandId - Firestore 브랜드 ID\n * @returns 한글 브랜드명\n *\n * @example\n * ```typescript\n * getBrandNameKorean('hyundai'); // '현대'\n * getBrandNameKorean('bmw'); // 'BMW'\n * ```\n */\nexport function getBrandNameKorean(brandId: BrandId): string {\n  return ID_TO_KOREAN[brandId] || brandId;\n}\n\n/**\n * 영문 브랜드명 가져오기\n *\n * @param brandId - Firestore 브랜드 ID\n * @returns 영문 브랜드명\n *\n * @example\n * ```typescript\n * getBrandNameEnglish('hyundai'); // 'HYUNDAI'\n * getBrandNameEnglish('mercedes-benz'); // 'Mercedes-Benz'\n * ```\n */\nexport function getBrandNameEnglish(brandId: BrandId): string {\n  return ID_TO_ENGLISH[brandId] || brandId.toUpperCase();\n}\n\n/**\n * Firebase Storage 브랜드명 가져오기\n *\n * @param brandId - Firestore 브랜드 ID\n * @returns Storage 브랜드명 (대문자)\n *\n * @example\n * ```typescript\n * getStorageBrandName('hyundai'); // 'HYUNDAI'\n * getStorageBrandName('mercedes-benz'); // 'BENZ'\n * getStorageBrandName('mercedes-maybach'); // 'BENZ'\n * ```\n */\nexport function getStorageBrandName(brandId: BrandId): StorageBrandName {\n  return ID_TO_STORAGE[brandId] || brandId.toUpperCase() as StorageBrandName;\n}\n\n/**\n * 브랜드 매핑 정보 가져오기 (통합 함수)\n *\n * @param brandInput - 브랜드명 (한글, 영문, 대소문자 무관)\n * @returns 브랜드 매핑 정보\n *\n * @example\n * ```typescript\n * getBrandMapping('현대');\n * // {\n * //   firestoreId: 'hyundai',\n * //   koreanName: '현대',\n * //   englishName: 'HYUNDAI',\n * //   storageName: 'HYUNDAI'\n * // }\n * ```\n */\nexport function getBrandMapping(brandInput: string): BrandMapping {\n  const firestoreId = normalizeBrandId(brandInput);\n\n  return {\n    firestoreId,\n    koreanName: getBrandNameKorean(firestoreId),\n    englishName: getBrandNameEnglish(firestoreId),\n    storageName: getStorageBrandName(firestoreId)\n  };\n}\n\n/**\n * 지원되는 모든 브랜드 ID 목록\n */\nexport const SUPPORTED_BRANDS: BrandId[] = [\n  'hyundai',\n  'kia',\n  'tesla',\n  'bmw',\n  'mini',\n  'audi',\n  'mercedes-benz',\n  'mercedes-maybach',\n  'porsche'\n];\n","/**\n * 동적 브랜드 매핑 시스템\n *\n * Firestore에서 실시간으로 브랜드 정보를 조회하여 캐싱\n * 새로운 브랜드 추가 시 코드 수정 불필요\n */\n\nimport type { Firestore } from 'firebase/firestore';\nimport { collection, getDocs } from 'firebase/firestore';\nimport type { BrandId, BrandMapping } from '../types/brand';\n\n/**\n * 브랜드 정보 캐시\n *\n * Key: 브랜드명 (한글/영문/ID 모두)\n * Value: 브랜드 매핑 정보\n */\nconst brandCache = new Map<string, BrandMapping>();\n\n/**\n * 초기화 상태\n */\nlet initialized = false;\n\n/**\n * Firestore에서 브랜드 정보를 조회하여 캐시 초기화\n *\n * @param firestore - Firestore 인스턴스\n *\n * @example\n * ```typescript\n * import { initializeBrandMappings } from '@charzing/vehicle-utils';\n * import { db } from './firebase';\n *\n * // 앱 시작 시 한 번만 호출\n * await initializeBrandMappings(db);\n * ```\n */\nexport async function initializeBrandMappings(firestore: Firestore): Promise<void> {\n  if (initialized) {\n    console.log('[Brand Mapping] Already initialized');\n    return;\n  }\n\n  console.log('[Brand Mapping] Initializing from Firestore...');\n\n  try {\n    const vehiclesRef = collection(firestore, 'vehicles');\n    const snapshot = await getDocs(vehiclesRef);\n\n    snapshot.docs.forEach(doc => {\n      const data = doc.data();\n\n      // Storage 브랜드명 특별 처리\n      let storageName = data.englishName?.toUpperCase() || doc.id.toUpperCase();\n\n      // Mercedes-Benz/Maybach는 'BENZ'로 통합\n      if (doc.id === 'mercedes-benz' || doc.id === 'mercedes-maybach') {\n        storageName = 'BENZ';\n      }\n\n      const mapping: BrandMapping = {\n        firestoreId: doc.id as BrandId,\n        koreanName: data.name || doc.id,\n        englishName: data.englishName || doc.id.toUpperCase(),\n        storageName: storageName as any\n      };\n\n      // 여러 키로 등록 (대소문자 구분 없이 조회 가능)\n      brandCache.set(doc.id, mapping);                                    // 'hyundai'\n      brandCache.set(doc.id.toUpperCase(), mapping);                      // 'HYUNDAI'\n      brandCache.set(doc.id.toLowerCase(), mapping);                      // 'hyundai'\n      brandCache.set(data.name, mapping);                                 // '현대'\n      brandCache.set(data.englishName, mapping);                          // 'HYUNDAI'\n      brandCache.set(data.englishName?.toUpperCase(), mapping);           // 'HYUNDAI'\n      brandCache.set(data.englishName?.toLowerCase(), mapping);           // 'hyundai'\n    });\n\n    initialized = true;\n    console.log(`[Brand Mapping] ✅ Initialized with ${snapshot.docs.length} brands`);\n  } catch (error) {\n    console.error('[Brand Mapping] ❌ Initialization failed:', error);\n    throw error;\n  }\n}\n\n/**\n * 브랜드 매핑 정보 조회\n *\n * @param brandInput - 브랜드명 (한글/영문/ID 모두 가능)\n * @returns 브랜드 매핑 정보 또는 null\n *\n * @throws {Error} 초기화되지 않은 경우\n *\n * @example\n * ```typescript\n * getBrandMapping('현대');    // { firestoreId: 'hyundai', ... }\n * getBrandMapping('HYUNDAI'); // { firestoreId: 'hyundai', ... }\n * getBrandMapping('hyundai'); // { firestoreId: 'hyundai', ... }\n * ```\n */\nexport function getBrandMapping(brandInput: string): BrandMapping | null {\n  if (!initialized) {\n    throw new Error(\n      '[Brand Mapping] Not initialized. Call initializeBrandMappings() first.'\n    );\n  }\n\n  // 직접 매칭 시도\n  let mapping = brandCache.get(brandInput);\n  if (mapping) return mapping;\n\n  // 대소문자 구분 없이 재시도\n  mapping = brandCache.get(brandInput.toLowerCase());\n  if (mapping) return mapping;\n\n  mapping = brandCache.get(brandInput.toUpperCase());\n  if (mapping) return mapping;\n\n  // 공백 제거 후 재시도\n  const trimmed = brandInput.trim();\n  mapping = brandCache.get(trimmed);\n  if (mapping) return mapping;\n\n  console.warn(`[Brand Mapping] Unknown brand: \"${brandInput}\"`);\n  return null;\n}\n\n/**\n * 초기화 상태 확인\n */\nexport function isInitialized(): boolean {\n  return initialized;\n}\n\n/**\n * 캐시 초기화 (테스트용)\n */\nexport function resetCache(): void {\n  brandCache.clear();\n  initialized = false;\n  console.log('[Brand Mapping] Cache reset');\n}\n\n/**\n * 캐시된 브랜드 수\n */\nexport function getCachedBrandCount(): number {\n  return brandCache.size;\n}\n","/**\n * 모델 매핑 유틸리티\n *\n * 한글/영문 모델명 변환, 모델 ID 정규화, 유사도 기반 매칭\n */\n\nimport type { ModelId, ModelSlug, ModelMapping } from '../types/model';\n\n/**\n * 한글 → 영문 모델명 매핑 테이블\n */\nconst KOREAN_TO_ENGLISH_MODEL: Record<string, string> = {\n  // MINI\n  '쿠퍼': 'COOPER',\n  '컨트리맨': 'COUNTRYMAN',\n  '에이스맨': 'ACEMAN',\n\n  // Hyundai\n  '아이오닉': 'IONIQ',\n  '코나': 'KONA',\n  '넥소': 'NEXO',\n  '캐스퍼': 'CASPER',\n\n  // Kia\n  '니로': 'NIRO',\n  '레이': 'RAY',\n\n  // Tesla\n  '모델': 'MODEL',\n\n  // Common words\n  '일렉트릭': 'ELECTRIC',\n  'E': 'E',\n  'EV': 'EV'\n};\n\n/**\n * 문자열을 슬러그로 변환\n * - 소문자 변환\n * - 공백/언더바 → 하이픈\n * - 연속 하이픈 제거\n * - 앞뒤 하이픈 제거\n *\n * @param str - 변환할 문자열\n * @returns 슬러그 문자열\n *\n * @example\n * ```typescript\n * toSlug('IONIQ 5'); // 'ioniq-5'\n * toSlug('Model S'); // 'model-s'\n * toSlug('Cooper  JCW'); // 'cooper-jcw'\n * ```\n */\nexport function toSlug(str: string): string {\n  return str\n    .toLowerCase()\n    .trim()\n    .replace(/[\\s_]+/g, '-')   // 공백/언더바 → 하이픈\n    .replace(/-+/g, '-')       // 연속 하이픈 제거\n    .replace(/^-+|-+$/g, '');  // 앞뒤 하이픈 제거\n}\n\n/**\n * 한글 모델명을 영문으로 변환\n *\n * @param koreanModel - 한글 모델명\n * @returns 영문 모델명\n *\n * @example\n * ```typescript\n * convertKoreanToEnglish('아이오닉 5'); // 'IONIQ 5'\n * convertKoreanToEnglish('니로 EV'); // 'NIRO EV'\n * convertKoreanToEnglish('쿠퍼'); // 'COOPER'\n * ```\n */\nexport function convertKoreanToEnglish(koreanModel: string): string {\n  let result = koreanModel;\n\n  // 각 한글 단어를 영문으로 치환\n  for (const [korean, english] of Object.entries(KOREAN_TO_ENGLISH_MODEL)) {\n    const regex = new RegExp(korean, 'gi');\n    result = result.replace(regex, english);\n  }\n\n  return result;\n}\n\n/**\n * 모델 ID 정규화 (소문자, 하이픈)\n *\n * @param modelInput - 모델명 (한글, 영문, 대소문자 무관)\n * @returns Firestore 모델 ID (소문자, 하이픈)\n *\n * @example\n * ```typescript\n * normalizeModelId('아이오닉 5'); // 'ioniq-5'\n * normalizeModelId('Model S'); // 'model-s'\n * normalizeModelId('COOPER JCW'); // 'cooper-jcw'\n * ```\n */\nexport function normalizeModelId(modelInput: string): ModelId {\n  // 1. 한글 → 영문 변환 시도\n  const englishModel = convertKoreanToEnglish(modelInput);\n\n  // 2. 슬러그 변환\n  return toSlug(englishModel);\n}\n\n/**\n * 두 문자열의 유사도 점수 계산\n * - 정확한 매칭: 2점\n * - 부분 매칭: 1점\n *\n * @param input - 입력 문자열\n * @param target - 비교 대상 문자열\n * @returns 유사도 점수 (높을수록 유사)\n */\nfunction calculateSimilarity(input: string, target: string): number {\n  const inputWords = input.toLowerCase().replace(/[\\s\\-]/g, ' ').split(' ').filter(w => w.length > 0);\n  const targetWords = target.toLowerCase().replace(/[\\s\\-]/g, ' ').split(' ').filter(w => w.length > 0);\n\n  let score = 0;\n\n  for (const inputWord of inputWords) {\n    for (const targetWord of targetWords) {\n      if (inputWord === targetWord) {\n        score += 2; // 정확한 단어 매칭\n      } else if (inputWord.includes(targetWord) || targetWord.includes(inputWord)) {\n        score += 1; // 부분 매칭\n      }\n    }\n  }\n\n  return score;\n}\n\n/**\n * 가능한 모델 목록에서 최적 매칭 찾기\n * - 정확한 매칭 우선\n * - 없으면 유사도 점수 기반 매칭\n *\n * @param inputModel - 입력 모델명\n * @param availableModels - 가능한 모델 ID 목록\n * @returns 매칭된 모델 ID 또는 null\n *\n * @example\n * ```typescript\n * findBestModelMatch('아이오닉5', ['ioniq-5', 'ioniq-6', 'kona-electric']);\n * // 'ioniq-5'\n *\n * findBestModelMatch('NEXSO', ['ioniq-5', 'nexo', 'kona-electric']);\n * // 'nexo' (유사도 매칭)\n * ```\n */\nexport function findBestModelMatch(inputModel: string, availableModels: string[]): string | null {\n  // 1. 정확한 매칭 시도\n  const normalizedInput = normalizeModelId(inputModel);\n\n  const exactMatch = availableModels.find(model => {\n    const normalizedModel = normalizeModelId(model);\n    return normalizedModel === normalizedInput;\n  });\n\n  if (exactMatch) {\n    return exactMatch;\n  }\n\n  // 2. 유사도 점수 기반 매칭\n  let bestMatch: string | null = null;\n  let bestScore = 0;\n\n  for (const model of availableModels) {\n    const score = calculateSimilarity(inputModel, model);\n\n    if (score > bestScore) {\n      bestScore = score;\n      bestMatch = model;\n    }\n  }\n\n  // 최소 점수 임계값 (0보다 커야 함)\n  return (bestMatch && bestScore > 0) ? bestMatch : null;\n}\n\n/**\n * 모델 슬러그 생성 (URL/파일명용)\n *\n * @param modelInput - 모델명\n * @returns 모델 슬러그\n *\n * @example\n * ```typescript\n * getModelSlug('아이오닉 5'); // 'ioniq-5'\n * getModelSlug('Model 3'); // 'model-3'\n * ```\n */\nexport function getModelSlug(modelInput: string): ModelSlug {\n  return normalizeModelId(modelInput);\n}\n\n/**\n * 모델 매핑 정보 가져오기\n *\n * @param modelInput - 모델명 (한글 또는 영문)\n * @param englishName - 영문 모델명 (선택적)\n * @param koreanName - 한글 모델명 (선택적)\n * @returns 모델 매핑 정보\n *\n * @example\n * ```typescript\n * getModelMapping('아이오닉 5', 'IONIQ-5', '아이오닉 5');\n * // {\n * //   firestoreId: 'ioniq-5',\n * //   koreanName: '아이오닉 5',\n * //   englishName: 'IONIQ-5',\n * //   slug: 'ioniq-5'\n * // }\n * ```\n */\nexport function getModelMapping(\n  modelInput: string,\n  englishName?: string,\n  koreanName?: string\n): ModelMapping {\n  const firestoreId = normalizeModelId(modelInput);\n  const slug = getModelSlug(modelInput);\n\n  return {\n    firestoreId,\n    koreanName: koreanName || modelInput,\n    englishName: englishName || convertKoreanToEnglish(modelInput),\n    slug\n  };\n}\n","/**\n * 동적 모델 매핑 시스템\n *\n * Firestore에서 실시간으로 모델 정보를 조회하여 캐싱\n * 새로운 모델 추가 시 코드 수정 불필요\n */\n\nimport type { Firestore } from 'firebase/firestore';\nimport { collection, getDocs } from 'firebase/firestore';\n\n/**\n * 모델 매핑 정보\n */\nexport interface ModelMapping {\n  firestoreId: string;     // Firestore 모델 ID (예: \"ioniq-5\")\n  koreanName: string;      // 한글 모델명 (예: \"아이오닉 5\")\n  englishName: string;     // 영문 모델명 (예: \"IONIQ-5\")\n  storageName: string;     // Storage 모델명 (예: \"IONIQ-5\")\n  brandId: string;         // 소속 브랜드 ID\n}\n\n/**\n * 모델 정보 캐시\n *\n * Key: `{brandId}:{modelName}` 형식\n * Value: 모델 매핑 정보\n */\nconst modelCache = new Map<string, ModelMapping>();\n\n/**\n * 브랜드별 모델 목록 캐시\n *\n * Key: brandId\n * Value: 해당 브랜드의 모든 모델 매핑 배열\n */\nconst brandModelsCache = new Map<string, ModelMapping[]>();\n\n/**\n * 초기화 상태\n */\nlet initialized = false;\n\n/**\n * Firestore에서 모델 정보를 조회하여 캐시 초기화\n *\n * @param firestore - Firestore 인스턴스\n * @param brandIds - 초기화할 브랜드 ID 목록 (생략 시 모든 브랜드)\n *\n * @example\n * ```typescript\n * // 모든 브랜드의 모델 초기화\n * await initializeModelMappings(db);\n *\n * // 특정 브랜드만 초기화\n * await initializeModelMappings(db, ['hyundai', 'kia']);\n * ```\n */\nexport async function initializeModelMappings(\n  firestore: Firestore,\n  brandIds?: string[]\n): Promise<void> {\n  console.log('[Model Mapping] Initializing from Firestore...');\n\n  try {\n    // 브랜드 목록 조회\n    const vehiclesRef = collection(firestore, 'vehicles');\n    const brandsSnapshot = await getDocs(vehiclesRef);\n\n    let processedBrands = 0;\n    let processedModels = 0;\n\n    for (const brandDoc of brandsSnapshot.docs) {\n      const brandId = brandDoc.id;\n\n      // 특정 브랜드만 초기화하는 경우\n      if (brandIds && !brandIds.includes(brandId)) {\n        continue;\n      }\n\n      // 해당 브랜드의 모델 조회\n      const modelsRef = collection(firestore, 'vehicles', brandId, 'models');\n      const modelsSnapshot = await getDocs(modelsRef);\n\n      const brandModels: ModelMapping[] = [];\n\n      modelsSnapshot.docs.forEach(modelDoc => {\n        const data = modelDoc.data();\n\n        const mapping: ModelMapping = {\n          firestoreId: modelDoc.id,\n          koreanName: data.name || modelDoc.id,\n          englishName: data.englishName || modelDoc.id.toUpperCase(),\n          storageName: data.englishName?.toUpperCase() || modelDoc.id.toUpperCase(),\n          brandId: brandId\n        };\n\n        brandModels.push(mapping);\n        processedModels++;\n\n        // 여러 키로 등록\n        const keys = [\n          `${brandId}:${modelDoc.id}`,                            // \"hyundai:ioniq-5\"\n          `${brandId}:${data.name}`,                              // \"hyundai:아이오닉 5\"\n          `${brandId}:${data.englishName}`,                       // \"hyundai:IONIQ-5\"\n          `${brandId}:${data.englishName?.toLowerCase()}`,        // \"hyundai:ioniq-5\"\n          `${brandId}:${modelDoc.id.toUpperCase()}`,             // \"hyundai:IONIQ-5\"\n        ];\n\n        keys.forEach(key => {\n          if (key && !key.includes('undefined')) {\n            modelCache.set(key, mapping);\n          }\n        });\n      });\n\n      brandModelsCache.set(brandId, brandModels);\n      processedBrands++;\n    }\n\n    initialized = true;\n    console.log(\n      `[Model Mapping] ✅ Initialized: ${processedBrands} brands, ${processedModels} models`\n    );\n  } catch (error) {\n    console.error('[Model Mapping] ❌ Initialization failed:', error);\n    throw error;\n  }\n}\n\n/**\n * 모델 매핑 정보 조회\n *\n * @param brandId - 브랜드 ID\n * @param modelInput - 모델명 (한글/영문/ID 모두 가능)\n * @returns 모델 매핑 정보 또는 null\n *\n * @throws {Error} 초기화되지 않은 경우\n *\n * @example\n * ```typescript\n * getModelMapping('hyundai', '아이오닉 5');   // { firestoreId: 'ioniq-5', ... }\n * getModelMapping('hyundai', 'IONIQ-5');     // { firestoreId: 'ioniq-5', ... }\n * getModelMapping('hyundai', 'ioniq-5');     // { firestoreId: 'ioniq-5', ... }\n * ```\n */\nexport function getModelMapping(\n  brandId: string,\n  modelInput: string\n): ModelMapping | null {\n  if (!initialized) {\n    throw new Error(\n      '[Model Mapping] Not initialized. Call initializeModelMappings() first.'\n    );\n  }\n\n  // 직접 매칭 시도\n  const keys = [\n    `${brandId}:${modelInput}`,\n    `${brandId}:${modelInput.toLowerCase()}`,\n    `${brandId}:${modelInput.toUpperCase()}`,\n    `${brandId}:${modelInput.trim()}`,\n  ];\n\n  for (const key of keys) {\n    const mapping = modelCache.get(key);\n    if (mapping) return mapping;\n  }\n\n  // 유사도 매칭 (Fallback)\n  const brandModels = brandModelsCache.get(brandId);\n  if (brandModels) {\n    const normalizedInput = modelInput.toLowerCase().replace(/[\\s\\-]/g, '');\n\n    for (const model of brandModels) {\n      const normalizedModel = model.englishName.toLowerCase().replace(/[\\s\\-]/g, '');\n      if (normalizedModel === normalizedInput) {\n        return model;\n      }\n    }\n  }\n\n  console.warn(`[Model Mapping] Unknown model: ${brandId}:${modelInput}`);\n  return null;\n}\n\n/**\n * 브랜드의 모든 모델 조회\n *\n * @param brandId - 브랜드 ID\n * @returns 모델 매핑 배열\n */\nexport function getBrandModels(brandId: string): ModelMapping[] {\n  if (!initialized) {\n    throw new Error(\n      '[Model Mapping] Not initialized. Call initializeModelMappings() first.'\n    );\n  }\n\n  return brandModelsCache.get(brandId) || [];\n}\n\n/**\n * 초기화 상태 확인\n */\nexport function isInitialized(): boolean {\n  return initialized;\n}\n\n/**\n * 캐시 초기화 (테스트용)\n */\nexport function resetCache(): void {\n  modelCache.clear();\n  brandModelsCache.clear();\n  initialized = false;\n  console.log('[Model Mapping] Cache reset');\n}\n\n/**\n * 캐시된 모델 수\n */\nexport function getCachedModelCount(): number {\n  return modelCache.size;\n}\n","/**\n * Firebase Storage 차량 이미지 URL/경로 생성 유틸리티\n * \n * ⚠️ 주의: 이 파일은 순수 함수만 포함합니다.\n * Firebase SDK나 업로드 로직은 포함하지 않습니다.\n */\n\nconst FIREBASE_STORAGE_BASE = 'https://firebasestorage.googleapis.com/v0/b/charzing-d1600.firebasestorage.app/o';\n\n/**\n * 브랜드명을 Storage 경로용으로 정규화\n * ✅ 완전 동적 처리: Firestore ID → Storage 폴더\n *\n * 규칙: 하이픈(-)을 언더스코어(_)로 변환 후 대문자\n * - mercedes-benz → MERCEDES_BENZ\n * - mercedes-maybach → MERCEDES_MAYBACH\n * - hyundai → HYUNDAI\n * - kia → KIA\n */\nfunction normalizeStorageBrand(firestoreBrandId: string): string {\n  // ✅ 완전 동적 변환: 하이픈 → 언더스코어, 대문자\n  return firestoreBrandId.toUpperCase().replace(/-/g, '_');\n}\n\n/**\n * 모델명을 Storage 경로용으로 정규화\n * ✅ 동적 처리: Firestore ID → Storage 폴더 (대문자)\n */\nfunction normalizeStorageModel(firestoreModelId: string): string {\n  return firestoreModelId.toUpperCase();\n}\n\n/**\n * 트림명을 파일명용으로 정규화\n */\nfunction normalizeStorageTrim(trim?: string): string {\n  if (!trim) return '';\n  return trim.toLowerCase().replace(/[\\s\\-]/g, '_').replace(/[^a-z0-9_]/g, '');\n}\n\nexport interface ImagePathParams {\n  brandId: string;\n  modelId: string;\n  year: number;\n  trim?: string;\n}\n\n/**\n * 차량 이미지 파일명 생성\n * 예: kia__niro-ev__2022__standard.png\n */\nexport function generateImageFilename(params: ImagePathParams): string {\n  const { brandId, modelId, year, trim } = params;\n  const brandLower = brandId.toLowerCase();\n  const modelLower = modelId.toLowerCase().replace(/[\\s]/g, '-');\n  const trimPart = trim ? `__${normalizeStorageTrim(trim)}` : '';\n  return `${brandLower}__${modelLower}__${year}${trimPart}.png`;\n}\n\n/**\n * Storage 경로 생성 (업로드용)\n * 예: vehicle-images/KIA/NIRO-EV/2022/kia__niro-ev__2022__standard.png\n */\nexport function generateStoragePath(params: ImagePathParams): string {\n  const { brandId, modelId, year } = params;\n  const storageBrand = normalizeStorageBrand(brandId);\n  const storageModel = normalizeStorageModel(modelId);\n  const filename = generateImageFilename(params);\n  return `vehicle-images/${storageBrand}/${storageModel}/${year}/${filename}`;\n}\n\n/**\n * 완전한 Firebase Storage URL 생성 (읽기용)\n */\nexport function generateVehicleImageUrl(params: ImagePathParams): string {\n  const path = generateStoragePath(params);\n  const encodedPath = encodeURIComponent(path);\n  return `${FIREBASE_STORAGE_BASE}/${encodedPath}?alt=media`;\n}\n"],"mappings":"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","names":["getBrandMapping","getModelMapping","isInitialized","resetCache","getBrandMapping","import_firestore","initialized","getModelMapping","isInitialized","resetCache"]}
+{"version":3,"sources":["../../src/index.ts","../../src/brand/mapping.ts","../../src/brand/dynamic-mapping.ts","../../src/model/mapping.ts","../../src/model/dynamic-mapping.ts","../../src/image/url-generator.ts"],"sourcesContent":["/**\n * @charzing/vehicle-utils\n *\n * 차징 플랫폼 전체에서 사용하는 차량 데이터 유틸리티\n */\n\n// ===== 타입 =====\nexport type * from './types';\n\n// ===== 브랜드 관련 (정적) =====\nexport {\n  normalizeBrandId,\n  getBrandNameKorean,\n  getBrandNameEnglish,\n  getStorageBrandName,\n  getBrandMapping,\n  SUPPORTED_BRANDS\n} from './brand/mapping';\n\n// ===== 브랜드 관련 (동적) ⭐ NEW =====\nexport {\n  initializeBrandMappings,\n  getBrandMapping as getDynamicBrandMapping,\n  isInitialized as isBrandMappingInitialized,\n  resetCache as resetBrandCache,\n  getCachedBrandCount\n} from './brand/dynamic-mapping';\n\n// ===== 모델 관련 (정적) =====\nexport {\n  toSlug,\n  convertKoreanToEnglish,\n  normalizeModelId,\n  findBestModelMatch,\n  getModelSlug,\n  getModelMapping\n} from './model/mapping';\n\n// ===== 모델 관련 (동적) ⭐ NEW =====\nexport {\n  initializeModelMappings,\n  getModelMapping as getDynamicModelMapping,\n  getBrandModels,\n  isInitialized as isModelMappingInitialized,\n  resetCache as resetModelCache,\n  getCachedModelCount\n} from './model/dynamic-mapping';\n\n// ===== 이미지 URL/경로 생성 (순수 함수만) ⭐ UPDATED =====\nexport {\n  generateImageFilename,\n  generateStoragePath,\n  generateVehicleImageUrl\n} from './image/url-generator';\n","/**\n * 브랜드 매핑 유틸리티\n *\n * 한글/영문 브랜드명 변환, Firestore ID 정규화, Storage 브랜드명 매핑\n */\n\nimport type { BrandId, BrandMapping, StorageBrandName } from '../types/brand';\n\n/**\n * 한글 → Firestore ID 매핑 테이블\n */\nconst KOREAN_TO_ID: Record<string, BrandId> = {\n  '현대': 'hyundai',\n  'HYUNDAI': 'hyundai',\n  'Hyundai': 'hyundai',\n\n  '기아': 'kia',\n  'KIA': 'kia',\n  'Kia': 'kia',\n\n  '테슬라': 'tesla',\n  'TESLA': 'tesla',\n  'Tesla': 'tesla',\n\n  'BMW': 'bmw',\n  'bmw': 'bmw',\n  '비엠더블유': 'bmw',\n\n  '메르세데스-벤츠': 'mercedes-benz',\n  'Mercedes-Benz': 'mercedes-benz',\n  'MERCEDES-BENZ': 'mercedes-benz',\n  '벤츠': 'mercedes-benz',\n  'Benz': 'mercedes-benz',\n  'BENZ': 'mercedes-benz',\n\n  '메르세데스-마이바흐': 'mercedes-maybach',\n  'Mercedes-Maybach': 'mercedes-maybach',\n  'MERCEDES-MAYBACH': 'mercedes-maybach',\n  '마이바흐': 'mercedes-maybach',\n  'Maybach': 'mercedes-maybach',\n  'MAYBACH': 'mercedes-maybach',\n\n  '아우디': 'audi',\n  'AUDI': 'audi',\n  'Audi': 'audi',\n\n  '포르쉐': 'porsche',\n  '포르셰': 'porsche',\n  'PORSCHE': 'porsche',\n  'Porsche': 'porsche',\n\n  'MINI': 'mini',\n  'Mini': 'mini',\n  'mini': 'mini',\n  '미니': 'mini'\n};\n\n/**\n * Firestore ID → 한글 브랜드명 매핑\n */\nconst ID_TO_KOREAN: Record<BrandId, string> = {\n  'hyundai': '현대',\n  'kia': '기아',\n  'tesla': '테슬라',\n  'bmw': 'BMW',\n  'mercedes-benz': '메르세데스-벤츠',\n  'mercedes-maybach': '메르세데스-마이바흐',\n  'audi': '아우디',\n  'porsche': '포르쉐',\n  'mini': '미니'\n};\n\n/**\n * Firestore ID → 영문 브랜드명 매핑\n */\nconst ID_TO_ENGLISH: Record<BrandId, string> = {\n  'hyundai': 'HYUNDAI',\n  'kia': 'KIA',\n  'tesla': 'TESLA',\n  'bmw': 'BMW',\n  'mercedes-benz': 'Mercedes-Benz',\n  'mercedes-maybach': 'Mercedes-Maybach',\n  'audi': 'AUDI',\n  'porsche': 'PORSCHE',\n  'mini': 'MINI'\n};\n\n/**\n * Firestore ID → Firebase Storage 브랜드명 매핑\n * Mercedes-Benz와 Mercedes-Maybach는 'BENZ'로 통합\n */\nconst ID_TO_STORAGE: Record<BrandId, StorageBrandName> = {\n  'hyundai': 'HYUNDAI',\n  'kia': 'KIA',\n  'tesla': 'TESLA',\n  'bmw': 'BMW',\n  'mercedes-benz': 'BENZ',        // ⚠️ BENZ로 통합\n  'mercedes-maybach': 'BENZ',     // ⚠️ BENZ로 통합\n  'audi': 'AUDI',\n  'porsche': 'PORSCHE',\n  'mini': 'MINI'\n};\n\n/**\n * 브랜드 ID 정규화 (소문자 통일)\n *\n * @param brandInput - 브랜드명 (한글, 영문, 대소문자 무관)\n * @returns Firestore 브랜드 ID (소문자, 하이픈)\n *\n * @example\n * ```typescript\n * normalizeBrandId('현대'); // 'hyundai'\n * normalizeBrandId('BMW'); // 'bmw'\n * normalizeBrandId('Mercedes-Benz'); // 'mercedes-benz'\n * ```\n */\nexport function normalizeBrandId(brandInput: string): BrandId {\n  // 1. 매핑 테이블에서 직접 찾기\n  if (brandInput in KOREAN_TO_ID) {\n    return KOREAN_TO_ID[brandInput];\n  }\n\n  // 2. 소문자 변환 후 확인\n  const lowercased = brandInput.toLowerCase().trim();\n  if (lowercased in KOREAN_TO_ID) {\n    return KOREAN_TO_ID[lowercased];\n  }\n\n  // 3. 이미 올바른 Firestore ID인 경우\n  if (Object.values(KOREAN_TO_ID).includes(lowercased as BrandId)) {\n    return lowercased as BrandId;\n  }\n\n  // 4. 매칭 실패 시 소문자 변환 결과 반환 (fallback)\n  console.warn(`[normalizeBrandId] 알 수 없는 브랜드: \"${brandInput}\", fallback: \"${lowercased}\"`);\n  return lowercased as BrandId;\n}\n\n/**\n * 한글 브랜드명 가져오기\n *\n * @param brandId - Firestore 브랜드 ID\n * @returns 한글 브랜드명\n *\n * @example\n * ```typescript\n * getBrandNameKorean('hyundai'); // '현대'\n * getBrandNameKorean('bmw'); // 'BMW'\n * ```\n */\nexport function getBrandNameKorean(brandId: BrandId): string {\n  return ID_TO_KOREAN[brandId] || brandId;\n}\n\n/**\n * 영문 브랜드명 가져오기\n *\n * @param brandId - Firestore 브랜드 ID\n * @returns 영문 브랜드명\n *\n * @example\n * ```typescript\n * getBrandNameEnglish('hyundai'); // 'HYUNDAI'\n * getBrandNameEnglish('mercedes-benz'); // 'Mercedes-Benz'\n * ```\n */\nexport function getBrandNameEnglish(brandId: BrandId): string {\n  return ID_TO_ENGLISH[brandId] || brandId.toUpperCase();\n}\n\n/**\n * Firebase Storage 브랜드명 가져오기\n *\n * @param brandId - Firestore 브랜드 ID\n * @returns Storage 브랜드명 (대문자)\n *\n * @example\n * ```typescript\n * getStorageBrandName('hyundai'); // 'HYUNDAI'\n * getStorageBrandName('mercedes-benz'); // 'BENZ'\n * getStorageBrandName('mercedes-maybach'); // 'BENZ'\n * ```\n */\nexport function getStorageBrandName(brandId: BrandId): StorageBrandName {\n  return ID_TO_STORAGE[brandId] || brandId.toUpperCase() as StorageBrandName;\n}\n\n/**\n * 브랜드 매핑 정보 가져오기 (통합 함수)\n *\n * @param brandInput - 브랜드명 (한글, 영문, 대소문자 무관)\n * @returns 브랜드 매핑 정보\n *\n * @example\n * ```typescript\n * getBrandMapping('현대');\n * // {\n * //   firestoreId: 'hyundai',\n * //   koreanName: '현대',\n * //   englishName: 'HYUNDAI',\n * //   storageName: 'HYUNDAI'\n * // }\n * ```\n */\nexport function getBrandMapping(brandInput: string): BrandMapping {\n  const firestoreId = normalizeBrandId(brandInput);\n\n  return {\n    firestoreId,\n    koreanName: getBrandNameKorean(firestoreId),\n    englishName: getBrandNameEnglish(firestoreId),\n    storageName: getStorageBrandName(firestoreId)\n  };\n}\n\n/**\n * 지원되는 모든 브랜드 ID 목록\n */\nexport const SUPPORTED_BRANDS: BrandId[] = [\n  'hyundai',\n  'kia',\n  'tesla',\n  'bmw',\n  'mini',\n  'audi',\n  'mercedes-benz',\n  'mercedes-maybach',\n  'porsche'\n];\n","/**\n * 동적 브랜드 매핑 시스템\n *\n * Firestore에서 실시간으로 브랜드 정보를 조회하여 캐싱\n * 새로운 브랜드 추가 시 코드 수정 불필요\n */\n\nimport type { Firestore } from 'firebase/firestore';\nimport { collection, getDocs } from 'firebase/firestore';\nimport type { BrandId, BrandMapping } from '../types/brand';\n\n/**\n * 브랜드 정보 캐시\n *\n * Key: 브랜드명 (한글/영문/ID 모두)\n * Value: 브랜드 매핑 정보\n */\nconst brandCache = new Map<string, BrandMapping>();\n\n/**\n * 초기화 상태\n */\nlet initialized = false;\n\n/**\n * Firestore에서 브랜드 정보를 조회하여 캐시 초기화\n *\n * @param firestore - Firestore 인스턴스\n *\n * @example\n * ```typescript\n * import { initializeBrandMappings } from '@charzing/vehicle-utils';\n * import { db } from './firebase';\n *\n * // 앱 시작 시 한 번만 호출\n * await initializeBrandMappings(db);\n * ```\n */\nexport async function initializeBrandMappings(firestore: Firestore): Promise<void> {\n  if (initialized) {\n    console.log('[Brand Mapping] Already initialized');\n    return;\n  }\n\n  console.log('[Brand Mapping] Initializing from Firestore...');\n\n  try {\n    const vehiclesRef = collection(firestore, 'vehicles');\n    const snapshot = await getDocs(vehiclesRef);\n\n    snapshot.docs.forEach(doc => {\n      const data = doc.data();\n\n      // Storage 브랜드명 특별 처리\n      let storageName = data.englishName?.toUpperCase() || doc.id.toUpperCase();\n\n      // Mercedes-Benz/Maybach는 'BENZ'로 통합\n      if (doc.id === 'mercedes-benz' || doc.id === 'mercedes-maybach') {\n        storageName = 'BENZ';\n      }\n\n      const mapping: BrandMapping = {\n        firestoreId: doc.id as BrandId,\n        koreanName: data.name || doc.id,\n        englishName: data.englishName || doc.id.toUpperCase(),\n        storageName: storageName as any\n      };\n\n      // 여러 키로 등록 (대소문자 구분 없이 조회 가능)\n      brandCache.set(doc.id, mapping);                                    // 'hyundai'\n      brandCache.set(doc.id.toUpperCase(), mapping);                      // 'HYUNDAI'\n      brandCache.set(doc.id.toLowerCase(), mapping);                      // 'hyundai'\n      brandCache.set(data.name, mapping);                                 // '현대'\n      brandCache.set(data.englishName, mapping);                          // 'HYUNDAI'\n      brandCache.set(data.englishName?.toUpperCase(), mapping);           // 'HYUNDAI'\n      brandCache.set(data.englishName?.toLowerCase(), mapping);           // 'hyundai'\n    });\n\n    initialized = true;\n    console.log(`[Brand Mapping] ✅ Initialized with ${snapshot.docs.length} brands`);\n  } catch (error) {\n    console.error('[Brand Mapping] ❌ Initialization failed:', error);\n    throw error;\n  }\n}\n\n/**\n * 브랜드 매핑 정보 조회\n *\n * @param brandInput - 브랜드명 (한글/영문/ID 모두 가능)\n * @returns 브랜드 매핑 정보 또는 null\n *\n * @throws {Error} 초기화되지 않은 경우\n *\n * @example\n * ```typescript\n * getBrandMapping('현대');    // { firestoreId: 'hyundai', ... }\n * getBrandMapping('HYUNDAI'); // { firestoreId: 'hyundai', ... }\n * getBrandMapping('hyundai'); // { firestoreId: 'hyundai', ... }\n * ```\n */\nexport function getBrandMapping(brandInput: string): BrandMapping | null {\n  if (!initialized) {\n    throw new Error(\n      '[Brand Mapping] Not initialized. Call initializeBrandMappings() first.'\n    );\n  }\n\n  // 직접 매칭 시도\n  let mapping = brandCache.get(brandInput);\n  if (mapping) return mapping;\n\n  // 대소문자 구분 없이 재시도\n  mapping = brandCache.get(brandInput.toLowerCase());\n  if (mapping) return mapping;\n\n  mapping = brandCache.get(brandInput.toUpperCase());\n  if (mapping) return mapping;\n\n  // 공백 제거 후 재시도\n  const trimmed = brandInput.trim();\n  mapping = brandCache.get(trimmed);\n  if (mapping) return mapping;\n\n  console.warn(`[Brand Mapping] Unknown brand: \"${brandInput}\"`);\n  return null;\n}\n\n/**\n * 초기화 상태 확인\n */\nexport function isInitialized(): boolean {\n  return initialized;\n}\n\n/**\n * 캐시 초기화 (테스트용)\n */\nexport function resetCache(): void {\n  brandCache.clear();\n  initialized = false;\n  console.log('[Brand Mapping] Cache reset');\n}\n\n/**\n * 캐시된 브랜드 수\n */\nexport function getCachedBrandCount(): number {\n  return brandCache.size;\n}\n","/**\n * 모델 매핑 유틸리티\n *\n * 한글/영문 모델명 변환, 모델 ID 정규화, 유사도 기반 매칭\n */\n\nimport type { ModelId, ModelSlug, ModelMapping } from '../types/model';\n\n/**\n * 한글 → 영문 모델명 매핑 테이블\n */\nconst KOREAN_TO_ENGLISH_MODEL: Record<string, string> = {\n  // MINI\n  '쿠퍼': 'COOPER',\n  '컨트리맨': 'COUNTRYMAN',\n  '에이스맨': 'ACEMAN',\n\n  // Hyundai\n  '아이오닉': 'IONIQ',\n  '코나': 'KONA',\n  '넥소': 'NEXO',\n  '캐스퍼': 'CASPER',\n\n  // Kia\n  '니로': 'NIRO',\n  '레이': 'RAY',\n\n  // Tesla\n  '모델': 'MODEL',\n\n  // Common words\n  '일렉트릭': 'ELECTRIC',\n  'E': 'E',\n  'EV': 'EV'\n};\n\n/**\n * 문자열을 슬러그로 변환\n * - 소문자 변환\n * - 공백/언더바 → 하이픈\n * - 연속 하이픈 제거\n * - 앞뒤 하이픈 제거\n *\n * @param str - 변환할 문자열\n * @returns 슬러그 문자열\n *\n * @example\n * ```typescript\n * toSlug('IONIQ 5'); // 'ioniq-5'\n * toSlug('Model S'); // 'model-s'\n * toSlug('Cooper  JCW'); // 'cooper-jcw'\n * ```\n */\nexport function toSlug(str: string): string {\n  return str\n    .toLowerCase()\n    .trim()\n    .replace(/[\\s_]+/g, '-')   // 공백/언더바 → 하이픈\n    .replace(/-+/g, '-')       // 연속 하이픈 제거\n    .replace(/^-+|-+$/g, '');  // 앞뒤 하이픈 제거\n}\n\n/**\n * 한글 모델명을 영문으로 변환\n *\n * @param koreanModel - 한글 모델명\n * @returns 영문 모델명\n *\n * @example\n * ```typescript\n * convertKoreanToEnglish('아이오닉 5'); // 'IONIQ 5'\n * convertKoreanToEnglish('니로 EV'); // 'NIRO EV'\n * convertKoreanToEnglish('쿠퍼'); // 'COOPER'\n * ```\n */\nexport function convertKoreanToEnglish(koreanModel: string): string {\n  let result = koreanModel;\n\n  // 각 한글 단어를 영문으로 치환\n  for (const [korean, english] of Object.entries(KOREAN_TO_ENGLISH_MODEL)) {\n    const regex = new RegExp(korean, 'gi');\n    result = result.replace(regex, english);\n  }\n\n  return result;\n}\n\n/**\n * 모델 ID 정규화 (소문자, 하이픈)\n *\n * @param modelInput - 모델명 (한글, 영문, 대소문자 무관)\n * @returns Firestore 모델 ID (소문자, 하이픈)\n *\n * @example\n * ```typescript\n * normalizeModelId('아이오닉 5'); // 'ioniq-5'\n * normalizeModelId('Model S'); // 'model-s'\n * normalizeModelId('COOPER JCW'); // 'cooper-jcw'\n * ```\n */\nexport function normalizeModelId(modelInput: string): ModelId {\n  // 1. 한글 → 영문 변환 시도\n  const englishModel = convertKoreanToEnglish(modelInput);\n\n  // 2. 슬러그 변환\n  return toSlug(englishModel);\n}\n\n/**\n * 두 문자열의 유사도 점수 계산\n * - 정확한 매칭: 2점\n * - 부분 매칭: 1점\n *\n * @param input - 입력 문자열\n * @param target - 비교 대상 문자열\n * @returns 유사도 점수 (높을수록 유사)\n */\nfunction calculateSimilarity(input: string, target: string): number {\n  const inputWords = input.toLowerCase().replace(/[\\s\\-]/g, ' ').split(' ').filter(w => w.length > 0);\n  const targetWords = target.toLowerCase().replace(/[\\s\\-]/g, ' ').split(' ').filter(w => w.length > 0);\n\n  let score = 0;\n\n  for (const inputWord of inputWords) {\n    for (const targetWord of targetWords) {\n      if (inputWord === targetWord) {\n        score += 2; // 정확한 단어 매칭\n      } else if (inputWord.includes(targetWord) || targetWord.includes(inputWord)) {\n        score += 1; // 부분 매칭\n      }\n    }\n  }\n\n  return score;\n}\n\n/**\n * 가능한 모델 목록에서 최적 매칭 찾기\n * - 정확한 매칭 우선\n * - 없으면 유사도 점수 기반 매칭\n *\n * @param inputModel - 입력 모델명\n * @param availableModels - 가능한 모델 ID 목록\n * @returns 매칭된 모델 ID 또는 null\n *\n * @example\n * ```typescript\n * findBestModelMatch('아이오닉5', ['ioniq-5', 'ioniq-6', 'kona-electric']);\n * // 'ioniq-5'\n *\n * findBestModelMatch('NEXSO', ['ioniq-5', 'nexo', 'kona-electric']);\n * // 'nexo' (유사도 매칭)\n * ```\n */\nexport function findBestModelMatch(inputModel: string, availableModels: string[]): string | null {\n  // 1. 정확한 매칭 시도\n  const normalizedInput = normalizeModelId(inputModel);\n\n  const exactMatch = availableModels.find(model => {\n    const normalizedModel = normalizeModelId(model);\n    return normalizedModel === normalizedInput;\n  });\n\n  if (exactMatch) {\n    return exactMatch;\n  }\n\n  // 2. 유사도 점수 기반 매칭\n  let bestMatch: string | null = null;\n  let bestScore = 0;\n\n  for (const model of availableModels) {\n    const score = calculateSimilarity(inputModel, model);\n\n    if (score > bestScore) {\n      bestScore = score;\n      bestMatch = model;\n    }\n  }\n\n  // 최소 점수 임계값 (0보다 커야 함)\n  return (bestMatch && bestScore > 0) ? bestMatch : null;\n}\n\n/**\n * 모델 슬러그 생성 (URL/파일명용)\n *\n * @param modelInput - 모델명\n * @returns 모델 슬러그\n *\n * @example\n * ```typescript\n * getModelSlug('아이오닉 5'); // 'ioniq-5'\n * getModelSlug('Model 3'); // 'model-3'\n * ```\n */\nexport function getModelSlug(modelInput: string): ModelSlug {\n  return normalizeModelId(modelInput);\n}\n\n/**\n * 모델 매핑 정보 가져오기\n *\n * @param modelInput - 모델명 (한글 또는 영문)\n * @param englishName - 영문 모델명 (선택적)\n * @param koreanName - 한글 모델명 (선택적)\n * @returns 모델 매핑 정보\n *\n * @example\n * ```typescript\n * getModelMapping('아이오닉 5', 'IONIQ-5', '아이오닉 5');\n * // {\n * //   firestoreId: 'ioniq-5',\n * //   koreanName: '아이오닉 5',\n * //   englishName: 'IONIQ-5',\n * //   slug: 'ioniq-5'\n * // }\n * ```\n */\nexport function getModelMapping(\n  modelInput: string,\n  englishName?: string,\n  koreanName?: string\n): ModelMapping {\n  const firestoreId = normalizeModelId(modelInput);\n  const slug = getModelSlug(modelInput);\n\n  return {\n    firestoreId,\n    koreanName: koreanName || modelInput,\n    englishName: englishName || convertKoreanToEnglish(modelInput),\n    slug\n  };\n}\n","/**\n * 동적 모델 매핑 시스템\n *\n * Firestore에서 실시간으로 모델 정보를 조회하여 캐싱\n * 새로운 모델 추가 시 코드 수정 불필요\n */\n\nimport type { Firestore } from 'firebase/firestore';\nimport { collection, getDocs } from 'firebase/firestore';\n\n/**\n * 모델 매핑 정보\n */\nexport interface ModelMapping {\n  firestoreId: string;     // Firestore 모델 ID (예: \"ioniq-5\")\n  koreanName: string;      // 한글 모델명 (예: \"아이오닉 5\")\n  englishName: string;     // 영문 모델명 (예: \"IONIQ-5\")\n  storageName: string;     // Storage 모델명 (예: \"IONIQ-5\")\n  brandId: string;         // 소속 브랜드 ID\n}\n\n/**\n * 모델 정보 캐시\n *\n * Key: `{brandId}:{modelName}` 형식\n * Value: 모델 매핑 정보\n */\nconst modelCache = new Map<string, ModelMapping>();\n\n/**\n * 브랜드별 모델 목록 캐시\n *\n * Key: brandId\n * Value: 해당 브랜드의 모든 모델 매핑 배열\n */\nconst brandModelsCache = new Map<string, ModelMapping[]>();\n\n/**\n * 초기화 상태\n */\nlet initialized = false;\n\n/**\n * Firestore에서 모델 정보를 조회하여 캐시 초기화\n *\n * @param firestore - Firestore 인스턴스\n * @param brandIds - 초기화할 브랜드 ID 목록 (생략 시 모든 브랜드)\n *\n * @example\n * ```typescript\n * // 모든 브랜드의 모델 초기화\n * await initializeModelMappings(db);\n *\n * // 특정 브랜드만 초기화\n * await initializeModelMappings(db, ['hyundai', 'kia']);\n * ```\n */\nexport async function initializeModelMappings(\n  firestore: Firestore,\n  brandIds?: string[]\n): Promise<void> {\n  console.log('[Model Mapping] Initializing from Firestore...');\n\n  try {\n    // 브랜드 목록 조회\n    const vehiclesRef = collection(firestore, 'vehicles');\n    const brandsSnapshot = await getDocs(vehiclesRef);\n\n    let processedBrands = 0;\n    let processedModels = 0;\n\n    for (const brandDoc of brandsSnapshot.docs) {\n      const brandId = brandDoc.id;\n\n      // 특정 브랜드만 초기화하는 경우\n      if (brandIds && !brandIds.includes(brandId)) {\n        continue;\n      }\n\n      // 해당 브랜드의 모델 조회\n      const modelsRef = collection(firestore, 'vehicles', brandId, 'models');\n      const modelsSnapshot = await getDocs(modelsRef);\n\n      const brandModels: ModelMapping[] = [];\n\n      modelsSnapshot.docs.forEach(modelDoc => {\n        const data = modelDoc.data();\n\n        const mapping: ModelMapping = {\n          firestoreId: modelDoc.id,\n          koreanName: data.name || modelDoc.id,\n          englishName: data.englishName || modelDoc.id.toUpperCase(),\n          storageName: data.englishName?.toUpperCase() || modelDoc.id.toUpperCase(),\n          brandId: brandId\n        };\n\n        brandModels.push(mapping);\n        processedModels++;\n\n        // 여러 키로 등록\n        const keys = [\n          `${brandId}:${modelDoc.id}`,                            // \"hyundai:ioniq-5\"\n          `${brandId}:${data.name}`,                              // \"hyundai:아이오닉 5\"\n          `${brandId}:${data.englishName}`,                       // \"hyundai:IONIQ-5\"\n          `${brandId}:${data.englishName?.toLowerCase()}`,        // \"hyundai:ioniq-5\"\n          `${brandId}:${modelDoc.id.toUpperCase()}`,             // \"hyundai:IONIQ-5\"\n        ];\n\n        keys.forEach(key => {\n          if (key && !key.includes('undefined')) {\n            modelCache.set(key, mapping);\n          }\n        });\n      });\n\n      brandModelsCache.set(brandId, brandModels);\n      processedBrands++;\n    }\n\n    initialized = true;\n    console.log(\n      `[Model Mapping] ✅ Initialized: ${processedBrands} brands, ${processedModels} models`\n    );\n  } catch (error) {\n    console.error('[Model Mapping] ❌ Initialization failed:', error);\n    throw error;\n  }\n}\n\n/**\n * 모델 매핑 정보 조회\n *\n * @param brandId - 브랜드 ID\n * @param modelInput - 모델명 (한글/영문/ID 모두 가능)\n * @returns 모델 매핑 정보 또는 null\n *\n * @throws {Error} 초기화되지 않은 경우\n *\n * @example\n * ```typescript\n * getModelMapping('hyundai', '아이오닉 5');   // { firestoreId: 'ioniq-5', ... }\n * getModelMapping('hyundai', 'IONIQ-5');     // { firestoreId: 'ioniq-5', ... }\n * getModelMapping('hyundai', 'ioniq-5');     // { firestoreId: 'ioniq-5', ... }\n * ```\n */\nexport function getModelMapping(\n  brandId: string,\n  modelInput: string\n): ModelMapping | null {\n  if (!initialized) {\n    throw new Error(\n      '[Model Mapping] Not initialized. Call initializeModelMappings() first.'\n    );\n  }\n\n  // 직접 매칭 시도\n  const keys = [\n    `${brandId}:${modelInput}`,\n    `${brandId}:${modelInput.toLowerCase()}`,\n    `${brandId}:${modelInput.toUpperCase()}`,\n    `${brandId}:${modelInput.trim()}`,\n  ];\n\n  for (const key of keys) {\n    const mapping = modelCache.get(key);\n    if (mapping) return mapping;\n  }\n\n  // 유사도 매칭 (Fallback)\n  const brandModels = brandModelsCache.get(brandId);\n  if (brandModels) {\n    const normalizedInput = modelInput.toLowerCase().replace(/[\\s\\-]/g, '');\n\n    for (const model of brandModels) {\n      const normalizedModel = model.englishName.toLowerCase().replace(/[\\s\\-]/g, '');\n      if (normalizedModel === normalizedInput) {\n        return model;\n      }\n    }\n  }\n\n  console.warn(`[Model Mapping] Unknown model: ${brandId}:${modelInput}`);\n  return null;\n}\n\n/**\n * 브랜드의 모든 모델 조회\n *\n * @param brandId - 브랜드 ID\n * @returns 모델 매핑 배열\n */\nexport function getBrandModels(brandId: string): ModelMapping[] {\n  if (!initialized) {\n    throw new Error(\n      '[Model Mapping] Not initialized. Call initializeModelMappings() first.'\n    );\n  }\n\n  return brandModelsCache.get(brandId) || [];\n}\n\n/**\n * 초기화 상태 확인\n */\nexport function isInitialized(): boolean {\n  return initialized;\n}\n\n/**\n * 캐시 초기화 (테스트용)\n */\nexport function resetCache(): void {\n  modelCache.clear();\n  brandModelsCache.clear();\n  initialized = false;\n  console.log('[Model Mapping] Cache reset');\n}\n\n/**\n * 캐시된 모델 수\n */\nexport function getCachedModelCount(): number {\n  return modelCache.size;\n}\n","/**\n * Firebase Storage 차량 이미지 URL/경로 생성 유틸리티\n *\n * ⚠️ 주의: 이 파일은 순수 함수만 포함합니다.\n * Firebase SDK나 업로드 로직은 포함하지 않습니다.\n */\n\nimport { VehicleImageParams } from '../types/image';\n\nconst FIREBASE_STORAGE_BASE = 'https://firebasestorage.googleapis.com/v0/b/charzing-d1600.firebasestorage.app/o';\n\n/**\n * 브랜드명을 Storage 경로용으로 정규화\n * ✅ 완전 동적 처리: Firestore ID → Storage 폴더\n *\n * 규칙: 하이픈(-)을 언더스코어(_)로 변환 후 대문자\n * - mercedes-benz → MERCEDES_BENZ\n * - mercedes-maybach → MERCEDES_MAYBACH\n * - hyundai → HYUNDAI\n * - kia → KIA\n */\nfunction normalizeStorageBrand(firestoreBrandId: string): string {\n  // ✅ 완전 동적 변환: 하이픈 → 언더스코어, 대문자\n  return firestoreBrandId.toUpperCase().replace(/-/g, '_');\n}\n\n/**\n * 모델명을 Storage 경로용으로 정규화\n * ✅ 동적 처리: Firestore ID → Storage 폴더 (대문자)\n */\nfunction normalizeStorageModel(firestoreModelId: string): string {\n  return firestoreModelId.toUpperCase();\n}\n\n/**\n * 트림명을 파일명용으로 정규화\n */\nfunction normalizeStorageTrim(trim?: string): string {\n  if (!trim) return '';\n  return trim.toLowerCase().replace(/[\\s\\-]/g, '_').replace(/[^a-z0-9_]/g, '');\n}\n\n/**\n * 차량 이미지 파일명 생성\n *\n * @example\n * generateImageFilename({\n *   brandId: 'kia',\n *   modelId: 'niro-ev',\n *   year: 2022,\n *   trim: 'standard'\n * })\n * // Returns: 'kia__niro-ev__2022__standard.png'\n */\nexport function generateImageFilename(params: VehicleImageParams): string {\n  const { brandId, modelId, year, trim } = params;\n  const brandLower = brandId.toLowerCase();\n  const modelLower = modelId.toLowerCase().replace(/[\\s]/g, '-');\n  const trimPart = trim ? `__${normalizeStorageTrim(trim)}` : '';\n  return `${brandLower}__${modelLower}__${year}${trimPart}.png`;\n}\n\n/**\n * Storage 경로 생성 (업로드용)\n *\n * @example\n * generateStoragePath({\n *   brandId: 'kia',\n *   modelId: 'niro-ev',\n *   year: 2022,\n *   trim: 'standard'\n * })\n * // Returns: 'vehicle-images/KIA/NIRO-EV/2022/kia__niro-ev__2022__standard.png'\n */\nexport function generateStoragePath(params: VehicleImageParams): string {\n  const { brandId, modelId, year } = params;\n  const storageBrand = normalizeStorageBrand(brandId);\n  const storageModel = normalizeStorageModel(modelId);\n  const filename = generateImageFilename(params);\n  return `vehicle-images/${storageBrand}/${storageModel}/${year}/${filename}`;\n}\n\n/**\n * 완전한 Firebase Storage URL 생성 (읽기용)\n *\n * ✅ 파라미터 검증: brandId, modelId, year 필수\n * ❌ Fallback 금지: 잘못된 파라미터 시 에러 throw\n *\n * @throws {Error} brandId, modelId, year가 없으면 에러\n *\n * @example\n * generateVehicleImageUrl({\n *   brandId: 'kia',\n *   modelId: 'niro-ev',\n *   year: 2022\n * })\n * // Returns: 'https://firebasestorage.googleapis.com/.../vehicle-images%2FKIA%2FNIRO-EV%2F2022%2Fkia__niro-ev__2022.png?alt=media'\n */\nexport function generateVehicleImageUrl(params: VehicleImageParams): string {\n  // ✅ 필수 파라미터 검증 (fallback 금지)\n  if (!params.brandId) {\n    throw new Error('brandId is required');\n  }\n  if (!params.modelId) {\n    throw new Error('modelId is required');\n  }\n  if (!params.year) {\n    throw new Error('year is required');\n  }\n\n  const path = generateStoragePath(params);\n  const encodedPath = encodeURIComponent(path);\n  return `${FIREBASE_STORAGE_BASE}/${encodedPath}?alt=media`;\n}\n"],"mappings":"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","names":["getBrandMapping","getModelMapping","isInitialized","resetCache","getBrandMapping","import_firestore","initialized","getModelMapping","isInitialized","resetCache"]}

package/dist/esm/index.d.mts

@@ -321,13 +321,18 @@ interface FirebaseStorageConfig {
 }
 /**
  * 차량 이미지 파라미터
+ *
+ * ✅ 통일된 필드명 사용:
+ * - brandId (brand ❌)
+ * - modelId (model ❌)
+ * - year (number 타입)
  */
 interface VehicleImageParams {
     /** 브랜드 ID (소문자) */
-    brand: BrandId | string;
-    /** 모델 슬러그 (소문자, 하이픈) */
-    model: ModelSlug | string;
-    /** 연식 */
+    brandId: BrandId | string;
+    /** 모델 ID (소문자, 하이픈) */
+    modelId: ModelSlug | string;
+    /** 연식 (number 타입) */
     year: number;
     /** 트림 슬러그 (선택적, 소문자, 하이픈) */
     trim?: TrimSlug | string;
@@ -375,6 +380,76 @@ interface ImageFallbackOptions {
     defaultImageUrl?: string;
 }
 
+/**
+ * Year Template 관련 타입 정의
+ *
+ * Year Template은 여러 연도를 하나로 묶어 관리하는 시스템입니다.
+ * 동일한 스펙을 가진 여러 연도의 차량을 효율적으로 관리합니다.
+ */
+
+/**
+ * Year Template 이미지 정보
+ */
+interface YearTemplateImages {
+    /** 메인 이미지 URL */
+    main: string;
+    /** 추가 이미지 URL 목록 (선택적) */
+    additional?: string[];
+}
+/**
+ * Year Template
+ *
+ * 여러 연도를 하나로 묶어 관리하는 템플릿
+ *
+ * @example
+ * {
+ *   id: 'ioniq-5-exclusive-2023-2025',
+ *   name: 'Exclusive 2023-2025',
+ *   trimId: 'exclusive',
+ *   trimName: 'Exclusive',
+ *   years: [2023, 2024, 2025],
+ *   images: {
+ *     main: 'https://.../.../2024/hyundai__ioniq-5__2024__exclusive.png'
+ *   }
+ * }
+ */
+interface YearTemplate {
+    /** 템플릿 ID */
+    id: string;
+    /** 템플릿명 */
+    name: string;
+    /** 트림 ID */
+    trimId: TrimId;
+    /** 트림명 */
+    trimName: string;
+    /** 포함된 연도들 (✅ number[] 타입) */
+    years: number[];
+    /** 이미지 정보 (선택적) */
+    images?: YearTemplateImages;
+    /** 생성일 */
+    createdAt?: Date;
+    /** 수정일 */
+    updatedAt?: Date;
+}
+/**
+ * Year Document (개별 연도 문서)
+ *
+ * Template에 속하지 않은 개별 연도 또는
+ * Template과 연결된 연도 문서
+ */
+interface YearDocument {
+    /** 연도 (✅ number 타입) */
+    year: number;
+    /** 소속 템플릿 ID (선택적) */
+    templateId?: string;
+    /** 이 연도만의 이미지 URL (선택적) */
+    imageUrl?: string;
+    /** 생성일 */
+    createdAt?: Date;
+    /** 수정일 */
+    updatedAt?: Date;
+}
+
 /**
  * 브랜드 매핑 유틸리티
  *
@@ -690,25 +765,49 @@ declare function getCachedModelCount(): number;
  * ⚠️ 주의: 이 파일은 순수 함수만 포함합니다.
  * Firebase SDK나 업로드 로직은 포함하지 않습니다.
  */
-interface ImagePathParams {
-    brandId: string;
-    modelId: string;
-    year: number;
-    trim?: string;
-}
+
 /**
  * 차량 이미지 파일명 생성
- * 예: kia__niro-ev__2022__standard.png
+ *
+ * @example
+ * generateImageFilename({
+ *   brandId: 'kia',
+ *   modelId: 'niro-ev',
+ *   year: 2022,
+ *   trim: 'standard'
+ * })
+ * // Returns: 'kia__niro-ev__2022__standard.png'
  */
-declare function generateImageFilename(params: ImagePathParams): string;
+declare function generateImageFilename(params: VehicleImageParams): string;
 /**
  * Storage 경로 생성 (업로드용)
- * 예: vehicle-images/KIA/NIRO-EV/2022/kia__niro-ev__2022__standard.png
+ *
+ * @example
+ * generateStoragePath({
+ *   brandId: 'kia',
+ *   modelId: 'niro-ev',
+ *   year: 2022,
+ *   trim: 'standard'
+ * })
+ * // Returns: 'vehicle-images/KIA/NIRO-EV/2022/kia__niro-ev__2022__standard.png'
  */
-declare function generateStoragePath(params: ImagePathParams): string;
+declare function generateStoragePath(params: VehicleImageParams): string;
 /**
  * 완전한 Firebase Storage URL 생성 (읽기용)
- */
-declare function generateVehicleImageUrl(params: ImagePathParams): string;
+ *
+ * ✅ 파라미터 검증: brandId, modelId, year 필수
+ * ❌ Fallback 금지: 잘못된 파라미터 시 에러 throw
+ *
+ * @throws {Error} brandId, modelId, year가 없으면 에러
+ *
+ * @example
+ * generateVehicleImageUrl({
+ *   brandId: 'kia',
+ *   modelId: 'niro-ev',
+ *   year: 2022
+ * })
+ * // Returns: 'https://firebasestorage.googleapis.com/.../vehicle-images%2FKIA%2FNIRO-EV%2F2022%2Fkia__niro-ev__2022.png?alt=media'
+ */
+declare function generateVehicleImageUrl(params: VehicleImageParams): string;
 
-export { type BatteryInfo, type Brand, type BrandId, type BrandMapping, type CompletedVehicle, type DriveType, type FirebaseStorageConfig, type ImageFallbackOptions, type ImageFallbackStrategy, type ImageFilename, type ImagePath, type ImagePathParams, type ImageUrlOptions, type Model, type ModelId, type ModelMapping$1 as ModelMapping, type ModelSlug, SUPPORTED_BRANDS, type StorageBrandName, type TrimId, type TrimMapping, type TrimSlug, type UserVehicle, type VehicleDetails, type VehicleImageParams, type VehicleModel, type VehicleTrim, type VehicleVariant, convertKoreanToEnglish, findBestModelMatch, generateImageFilename, generateStoragePath, generateVehicleImageUrl, getBrandMapping$1 as getBrandMapping, getBrandModels, getBrandNameEnglish, getBrandNameKorean, getCachedBrandCount, getCachedModelCount, getBrandMapping as getDynamicBrandMapping, getModelMapping as getDynamicModelMapping, getModelMapping$1 as getModelMapping, getModelSlug, getStorageBrandName, initializeBrandMappings, initializeModelMappings, isInitialized$1 as isBrandMappingInitialized, isInitialized as isModelMappingInitialized, normalizeBrandId, normalizeModelId, resetCache$1 as resetBrandCache, resetCache as resetModelCache, toSlug };
+export { type BatteryInfo, type Brand, type BrandId, type BrandMapping, type CompletedVehicle, type DriveType, type FirebaseStorageConfig, type ImageFallbackOptions, type ImageFallbackStrategy, type ImageFilename, type ImagePath, type ImageUrlOptions, type Model, type ModelId, type ModelMapping$1 as ModelMapping, type ModelSlug, SUPPORTED_BRANDS, type StorageBrandName, type TrimId, type TrimMapping, type TrimSlug, type UserVehicle, type VehicleDetails, type VehicleImageParams, type VehicleModel, type VehicleTrim, type VehicleVariant, type YearDocument, type YearTemplate, type YearTemplateImages, convertKoreanToEnglish, findBestModelMatch, generateImageFilename, generateStoragePath, generateVehicleImageUrl, getBrandMapping$1 as getBrandMapping, getBrandModels, getBrandNameEnglish, getBrandNameKorean, getCachedBrandCount, getCachedModelCount, getBrandMapping as getDynamicBrandMapping, getModelMapping as getDynamicModelMapping, getModelMapping$1 as getModelMapping, getModelSlug, getStorageBrandName, initializeBrandMappings, initializeModelMappings, isInitialized$1 as isBrandMappingInitialized, isInitialized as isModelMappingInitialized, normalizeBrandId, normalizeModelId, resetCache$1 as resetBrandCache, resetCache as resetModelCache, toSlug };

package/dist/esm/index.mjs

@@ -408,6 +408,15 @@ function generateStoragePath(params) {
   return `vehicle-images/${storageBrand}/${storageModel}/${year}/${filename}`;
 }
 function generateVehicleImageUrl(params) {
+  if (!params.brandId) {
+    throw new Error("brandId is required");
+  }
+  if (!params.modelId) {
+    throw new Error("modelId is required");
+  }
+  if (!params.year) {
+    throw new Error("year is required");
+  }
   const path = generateStoragePath(params);
   const encodedPath = encodeURIComponent(path);
   return `${FIREBASE_STORAGE_BASE}/${encodedPath}?alt=media`;

package/dist/esm/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/brand/mapping.ts","../../src/brand/dynamic-mapping.ts","../../src/model/mapping.ts","../../src/model/dynamic-mapping.ts","../../src/image/url-generator.ts"],"sourcesContent":["/**\n * 브랜드 매핑 유틸리티\n *\n * 한글/영문 브랜드명 변환, Firestore ID 정규화, Storage 브랜드명 매핑\n */\n\nimport type { BrandId, BrandMapping, StorageBrandName } from '../types/brand';\n\n/**\n * 한글 → Firestore ID 매핑 테이블\n */\nconst KOREAN_TO_ID: Record<string, BrandId> = {\n  '현대': 'hyundai',\n  'HYUNDAI': 'hyundai',\n  'Hyundai': 'hyundai',\n\n  '기아': 'kia',\n  'KIA': 'kia',\n  'Kia': 'kia',\n\n  '테슬라': 'tesla',\n  'TESLA': 'tesla',\n  'Tesla': 'tesla',\n\n  'BMW': 'bmw',\n  'bmw': 'bmw',\n  '비엠더블유': 'bmw',\n\n  '메르세데스-벤츠': 'mercedes-benz',\n  'Mercedes-Benz': 'mercedes-benz',\n  'MERCEDES-BENZ': 'mercedes-benz',\n  '벤츠': 'mercedes-benz',\n  'Benz': 'mercedes-benz',\n  'BENZ': 'mercedes-benz',\n\n  '메르세데스-마이바흐': 'mercedes-maybach',\n  'Mercedes-Maybach': 'mercedes-maybach',\n  'MERCEDES-MAYBACH': 'mercedes-maybach',\n  '마이바흐': 'mercedes-maybach',\n  'Maybach': 'mercedes-maybach',\n  'MAYBACH': 'mercedes-maybach',\n\n  '아우디': 'audi',\n  'AUDI': 'audi',\n  'Audi': 'audi',\n\n  '포르쉐': 'porsche',\n  '포르셰': 'porsche',\n  'PORSCHE': 'porsche',\n  'Porsche': 'porsche',\n\n  'MINI': 'mini',\n  'Mini': 'mini',\n  'mini': 'mini',\n  '미니': 'mini'\n};\n\n/**\n * Firestore ID → 한글 브랜드명 매핑\n */\nconst ID_TO_KOREAN: Record<BrandId, string> = {\n  'hyundai': '현대',\n  'kia': '기아',\n  'tesla': '테슬라',\n  'bmw': 'BMW',\n  'mercedes-benz': '메르세데스-벤츠',\n  'mercedes-maybach': '메르세데스-마이바흐',\n  'audi': '아우디',\n  'porsche': '포르쉐',\n  'mini': '미니'\n};\n\n/**\n * Firestore ID → 영문 브랜드명 매핑\n */\nconst ID_TO_ENGLISH: Record<BrandId, string> = {\n  'hyundai': 'HYUNDAI',\n  'kia': 'KIA',\n  'tesla': 'TESLA',\n  'bmw': 'BMW',\n  'mercedes-benz': 'Mercedes-Benz',\n  'mercedes-maybach': 'Mercedes-Maybach',\n  'audi': 'AUDI',\n  'porsche': 'PORSCHE',\n  'mini': 'MINI'\n};\n\n/**\n * Firestore ID → Firebase Storage 브랜드명 매핑\n * Mercedes-Benz와 Mercedes-Maybach는 'BENZ'로 통합\n */\nconst ID_TO_STORAGE: Record<BrandId, StorageBrandName> = {\n  'hyundai': 'HYUNDAI',\n  'kia': 'KIA',\n  'tesla': 'TESLA',\n  'bmw': 'BMW',\n  'mercedes-benz': 'BENZ',        // ⚠️ BENZ로 통합\n  'mercedes-maybach': 'BENZ',     // ⚠️ BENZ로 통합\n  'audi': 'AUDI',\n  'porsche': 'PORSCHE',\n  'mini': 'MINI'\n};\n\n/**\n * 브랜드 ID 정규화 (소문자 통일)\n *\n * @param brandInput - 브랜드명 (한글, 영문, 대소문자 무관)\n * @returns Firestore 브랜드 ID (소문자, 하이픈)\n *\n * @example\n * ```typescript\n * normalizeBrandId('현대'); // 'hyundai'\n * normalizeBrandId('BMW'); // 'bmw'\n * normalizeBrandId('Mercedes-Benz'); // 'mercedes-benz'\n * ```\n */\nexport function normalizeBrandId(brandInput: string): BrandId {\n  // 1. 매핑 테이블에서 직접 찾기\n  if (brandInput in KOREAN_TO_ID) {\n    return KOREAN_TO_ID[brandInput];\n  }\n\n  // 2. 소문자 변환 후 확인\n  const lowercased = brandInput.toLowerCase().trim();\n  if (lowercased in KOREAN_TO_ID) {\n    return KOREAN_TO_ID[lowercased];\n  }\n\n  // 3. 이미 올바른 Firestore ID인 경우\n  if (Object.values(KOREAN_TO_ID).includes(lowercased as BrandId)) {\n    return lowercased as BrandId;\n  }\n\n  // 4. 매칭 실패 시 소문자 변환 결과 반환 (fallback)\n  console.warn(`[normalizeBrandId] 알 수 없는 브랜드: \"${brandInput}\", fallback: \"${lowercased}\"`);\n  return lowercased as BrandId;\n}\n\n/**\n * 한글 브랜드명 가져오기\n *\n * @param brandId - Firestore 브랜드 ID\n * @returns 한글 브랜드명\n *\n * @example\n * ```typescript\n * getBrandNameKorean('hyundai'); // '현대'\n * getBrandNameKorean('bmw'); // 'BMW'\n * ```\n */\nexport function getBrandNameKorean(brandId: BrandId): string {\n  return ID_TO_KOREAN[brandId] || brandId;\n}\n\n/**\n * 영문 브랜드명 가져오기\n *\n * @param brandId - Firestore 브랜드 ID\n * @returns 영문 브랜드명\n *\n * @example\n * ```typescript\n * getBrandNameEnglish('hyundai'); // 'HYUNDAI'\n * getBrandNameEnglish('mercedes-benz'); // 'Mercedes-Benz'\n * ```\n */\nexport function getBrandNameEnglish(brandId: BrandId): string {\n  return ID_TO_ENGLISH[brandId] || brandId.toUpperCase();\n}\n\n/**\n * Firebase Storage 브랜드명 가져오기\n *\n * @param brandId - Firestore 브랜드 ID\n * @returns Storage 브랜드명 (대문자)\n *\n * @example\n * ```typescript\n * getStorageBrandName('hyundai'); // 'HYUNDAI'\n * getStorageBrandName('mercedes-benz'); // 'BENZ'\n * getStorageBrandName('mercedes-maybach'); // 'BENZ'\n * ```\n */\nexport function getStorageBrandName(brandId: BrandId): StorageBrandName {\n  return ID_TO_STORAGE[brandId] || brandId.toUpperCase() as StorageBrandName;\n}\n\n/**\n * 브랜드 매핑 정보 가져오기 (통합 함수)\n *\n * @param brandInput - 브랜드명 (한글, 영문, 대소문자 무관)\n * @returns 브랜드 매핑 정보\n *\n * @example\n * ```typescript\n * getBrandMapping('현대');\n * // {\n * //   firestoreId: 'hyundai',\n * //   koreanName: '현대',\n * //   englishName: 'HYUNDAI',\n * //   storageName: 'HYUNDAI'\n * // }\n * ```\n */\nexport function getBrandMapping(brandInput: string): BrandMapping {\n  const firestoreId = normalizeBrandId(brandInput);\n\n  return {\n    firestoreId,\n    koreanName: getBrandNameKorean(firestoreId),\n    englishName: getBrandNameEnglish(firestoreId),\n    storageName: getStorageBrandName(firestoreId)\n  };\n}\n\n/**\n * 지원되는 모든 브랜드 ID 목록\n */\nexport const SUPPORTED_BRANDS: BrandId[] = [\n  'hyundai',\n  'kia',\n  'tesla',\n  'bmw',\n  'mini',\n  'audi',\n  'mercedes-benz',\n  'mercedes-maybach',\n  'porsche'\n];\n","/**\n * 동적 브랜드 매핑 시스템\n *\n * Firestore에서 실시간으로 브랜드 정보를 조회하여 캐싱\n * 새로운 브랜드 추가 시 코드 수정 불필요\n */\n\nimport type { Firestore } from 'firebase/firestore';\nimport { collection, getDocs } from 'firebase/firestore';\nimport type { BrandId, BrandMapping } from '../types/brand';\n\n/**\n * 브랜드 정보 캐시\n *\n * Key: 브랜드명 (한글/영문/ID 모두)\n * Value: 브랜드 매핑 정보\n */\nconst brandCache = new Map<string, BrandMapping>();\n\n/**\n * 초기화 상태\n */\nlet initialized = false;\n\n/**\n * Firestore에서 브랜드 정보를 조회하여 캐시 초기화\n *\n * @param firestore - Firestore 인스턴스\n *\n * @example\n * ```typescript\n * import { initializeBrandMappings } from '@charzing/vehicle-utils';\n * import { db } from './firebase';\n *\n * // 앱 시작 시 한 번만 호출\n * await initializeBrandMappings(db);\n * ```\n */\nexport async function initializeBrandMappings(firestore: Firestore): Promise<void> {\n  if (initialized) {\n    console.log('[Brand Mapping] Already initialized');\n    return;\n  }\n\n  console.log('[Brand Mapping] Initializing from Firestore...');\n\n  try {\n    const vehiclesRef = collection(firestore, 'vehicles');\n    const snapshot = await getDocs(vehiclesRef);\n\n    snapshot.docs.forEach(doc => {\n      const data = doc.data();\n\n      // Storage 브랜드명 특별 처리\n      let storageName = data.englishName?.toUpperCase() || doc.id.toUpperCase();\n\n      // Mercedes-Benz/Maybach는 'BENZ'로 통합\n      if (doc.id === 'mercedes-benz' || doc.id === 'mercedes-maybach') {\n        storageName = 'BENZ';\n      }\n\n      const mapping: BrandMapping = {\n        firestoreId: doc.id as BrandId,\n        koreanName: data.name || doc.id,\n        englishName: data.englishName || doc.id.toUpperCase(),\n        storageName: storageName as any\n      };\n\n      // 여러 키로 등록 (대소문자 구분 없이 조회 가능)\n      brandCache.set(doc.id, mapping);                                    // 'hyundai'\n      brandCache.set(doc.id.toUpperCase(), mapping);                      // 'HYUNDAI'\n      brandCache.set(doc.id.toLowerCase(), mapping);                      // 'hyundai'\n      brandCache.set(data.name, mapping);                                 // '현대'\n      brandCache.set(data.englishName, mapping);                          // 'HYUNDAI'\n      brandCache.set(data.englishName?.toUpperCase(), mapping);           // 'HYUNDAI'\n      brandCache.set(data.englishName?.toLowerCase(), mapping);           // 'hyundai'\n    });\n\n    initialized = true;\n    console.log(`[Brand Mapping] ✅ Initialized with ${snapshot.docs.length} brands`);\n  } catch (error) {\n    console.error('[Brand Mapping] ❌ Initialization failed:', error);\n    throw error;\n  }\n}\n\n/**\n * 브랜드 매핑 정보 조회\n *\n * @param brandInput - 브랜드명 (한글/영문/ID 모두 가능)\n * @returns 브랜드 매핑 정보 또는 null\n *\n * @throws {Error} 초기화되지 않은 경우\n *\n * @example\n * ```typescript\n * getBrandMapping('현대');    // { firestoreId: 'hyundai', ... }\n * getBrandMapping('HYUNDAI'); // { firestoreId: 'hyundai', ... }\n * getBrandMapping('hyundai'); // { firestoreId: 'hyundai', ... }\n * ```\n */\nexport function getBrandMapping(brandInput: string): BrandMapping | null {\n  if (!initialized) {\n    throw new Error(\n      '[Brand Mapping] Not initialized. Call initializeBrandMappings() first.'\n    );\n  }\n\n  // 직접 매칭 시도\n  let mapping = brandCache.get(brandInput);\n  if (mapping) return mapping;\n\n  // 대소문자 구분 없이 재시도\n  mapping = brandCache.get(brandInput.toLowerCase());\n  if (mapping) return mapping;\n\n  mapping = brandCache.get(brandInput.toUpperCase());\n  if (mapping) return mapping;\n\n  // 공백 제거 후 재시도\n  const trimmed = brandInput.trim();\n  mapping = brandCache.get(trimmed);\n  if (mapping) return mapping;\n\n  console.warn(`[Brand Mapping] Unknown brand: \"${brandInput}\"`);\n  return null;\n}\n\n/**\n * 초기화 상태 확인\n */\nexport function isInitialized(): boolean {\n  return initialized;\n}\n\n/**\n * 캐시 초기화 (테스트용)\n */\nexport function resetCache(): void {\n  brandCache.clear();\n  initialized = false;\n  console.log('[Brand Mapping] Cache reset');\n}\n\n/**\n * 캐시된 브랜드 수\n */\nexport function getCachedBrandCount(): number {\n  return brandCache.size;\n}\n","/**\n * 모델 매핑 유틸리티\n *\n * 한글/영문 모델명 변환, 모델 ID 정규화, 유사도 기반 매칭\n */\n\nimport type { ModelId, ModelSlug, ModelMapping } from '../types/model';\n\n/**\n * 한글 → 영문 모델명 매핑 테이블\n */\nconst KOREAN_TO_ENGLISH_MODEL: Record<string, string> = {\n  // MINI\n  '쿠퍼': 'COOPER',\n  '컨트리맨': 'COUNTRYMAN',\n  '에이스맨': 'ACEMAN',\n\n  // Hyundai\n  '아이오닉': 'IONIQ',\n  '코나': 'KONA',\n  '넥소': 'NEXO',\n  '캐스퍼': 'CASPER',\n\n  // Kia\n  '니로': 'NIRO',\n  '레이': 'RAY',\n\n  // Tesla\n  '모델': 'MODEL',\n\n  // Common words\n  '일렉트릭': 'ELECTRIC',\n  'E': 'E',\n  'EV': 'EV'\n};\n\n/**\n * 문자열을 슬러그로 변환\n * - 소문자 변환\n * - 공백/언더바 → 하이픈\n * - 연속 하이픈 제거\n * - 앞뒤 하이픈 제거\n *\n * @param str - 변환할 문자열\n * @returns 슬러그 문자열\n *\n * @example\n * ```typescript\n * toSlug('IONIQ 5'); // 'ioniq-5'\n * toSlug('Model S'); // 'model-s'\n * toSlug('Cooper  JCW'); // 'cooper-jcw'\n * ```\n */\nexport function toSlug(str: string): string {\n  return str\n    .toLowerCase()\n    .trim()\n    .replace(/[\\s_]+/g, '-')   // 공백/언더바 → 하이픈\n    .replace(/-+/g, '-')       // 연속 하이픈 제거\n    .replace(/^-+|-+$/g, '');  // 앞뒤 하이픈 제거\n}\n\n/**\n * 한글 모델명을 영문으로 변환\n *\n * @param koreanModel - 한글 모델명\n * @returns 영문 모델명\n *\n * @example\n * ```typescript\n * convertKoreanToEnglish('아이오닉 5'); // 'IONIQ 5'\n * convertKoreanToEnglish('니로 EV'); // 'NIRO EV'\n * convertKoreanToEnglish('쿠퍼'); // 'COOPER'\n * ```\n */\nexport function convertKoreanToEnglish(koreanModel: string): string {\n  let result = koreanModel;\n\n  // 각 한글 단어를 영문으로 치환\n  for (const [korean, english] of Object.entries(KOREAN_TO_ENGLISH_MODEL)) {\n    const regex = new RegExp(korean, 'gi');\n    result = result.replace(regex, english);\n  }\n\n  return result;\n}\n\n/**\n * 모델 ID 정규화 (소문자, 하이픈)\n *\n * @param modelInput - 모델명 (한글, 영문, 대소문자 무관)\n * @returns Firestore 모델 ID (소문자, 하이픈)\n *\n * @example\n * ```typescript\n * normalizeModelId('아이오닉 5'); // 'ioniq-5'\n * normalizeModelId('Model S'); // 'model-s'\n * normalizeModelId('COOPER JCW'); // 'cooper-jcw'\n * ```\n */\nexport function normalizeModelId(modelInput: string): ModelId {\n  // 1. 한글 → 영문 변환 시도\n  const englishModel = convertKoreanToEnglish(modelInput);\n\n  // 2. 슬러그 변환\n  return toSlug(englishModel);\n}\n\n/**\n * 두 문자열의 유사도 점수 계산\n * - 정확한 매칭: 2점\n * - 부분 매칭: 1점\n *\n * @param input - 입력 문자열\n * @param target - 비교 대상 문자열\n * @returns 유사도 점수 (높을수록 유사)\n */\nfunction calculateSimilarity(input: string, target: string): number {\n  const inputWords = input.toLowerCase().replace(/[\\s\\-]/g, ' ').split(' ').filter(w => w.length > 0);\n  const targetWords = target.toLowerCase().replace(/[\\s\\-]/g, ' ').split(' ').filter(w => w.length > 0);\n\n  let score = 0;\n\n  for (const inputWord of inputWords) {\n    for (const targetWord of targetWords) {\n      if (inputWord === targetWord) {\n        score += 2; // 정확한 단어 매칭\n      } else if (inputWord.includes(targetWord) || targetWord.includes(inputWord)) {\n        score += 1; // 부분 매칭\n      }\n    }\n  }\n\n  return score;\n}\n\n/**\n * 가능한 모델 목록에서 최적 매칭 찾기\n * - 정확한 매칭 우선\n * - 없으면 유사도 점수 기반 매칭\n *\n * @param inputModel - 입력 모델명\n * @param availableModels - 가능한 모델 ID 목록\n * @returns 매칭된 모델 ID 또는 null\n *\n * @example\n * ```typescript\n * findBestModelMatch('아이오닉5', ['ioniq-5', 'ioniq-6', 'kona-electric']);\n * // 'ioniq-5'\n *\n * findBestModelMatch('NEXSO', ['ioniq-5', 'nexo', 'kona-electric']);\n * // 'nexo' (유사도 매칭)\n * ```\n */\nexport function findBestModelMatch(inputModel: string, availableModels: string[]): string | null {\n  // 1. 정확한 매칭 시도\n  const normalizedInput = normalizeModelId(inputModel);\n\n  const exactMatch = availableModels.find(model => {\n    const normalizedModel = normalizeModelId(model);\n    return normalizedModel === normalizedInput;\n  });\n\n  if (exactMatch) {\n    return exactMatch;\n  }\n\n  // 2. 유사도 점수 기반 매칭\n  let bestMatch: string | null = null;\n  let bestScore = 0;\n\n  for (const model of availableModels) {\n    const score = calculateSimilarity(inputModel, model);\n\n    if (score > bestScore) {\n      bestScore = score;\n      bestMatch = model;\n    }\n  }\n\n  // 최소 점수 임계값 (0보다 커야 함)\n  return (bestMatch && bestScore > 0) ? bestMatch : null;\n}\n\n/**\n * 모델 슬러그 생성 (URL/파일명용)\n *\n * @param modelInput - 모델명\n * @returns 모델 슬러그\n *\n * @example\n * ```typescript\n * getModelSlug('아이오닉 5'); // 'ioniq-5'\n * getModelSlug('Model 3'); // 'model-3'\n * ```\n */\nexport function getModelSlug(modelInput: string): ModelSlug {\n  return normalizeModelId(modelInput);\n}\n\n/**\n * 모델 매핑 정보 가져오기\n *\n * @param modelInput - 모델명 (한글 또는 영문)\n * @param englishName - 영문 모델명 (선택적)\n * @param koreanName - 한글 모델명 (선택적)\n * @returns 모델 매핑 정보\n *\n * @example\n * ```typescript\n * getModelMapping('아이오닉 5', 'IONIQ-5', '아이오닉 5');\n * // {\n * //   firestoreId: 'ioniq-5',\n * //   koreanName: '아이오닉 5',\n * //   englishName: 'IONIQ-5',\n * //   slug: 'ioniq-5'\n * // }\n * ```\n */\nexport function getModelMapping(\n  modelInput: string,\n  englishName?: string,\n  koreanName?: string\n): ModelMapping {\n  const firestoreId = normalizeModelId(modelInput);\n  const slug = getModelSlug(modelInput);\n\n  return {\n    firestoreId,\n    koreanName: koreanName || modelInput,\n    englishName: englishName || convertKoreanToEnglish(modelInput),\n    slug\n  };\n}\n","/**\n * 동적 모델 매핑 시스템\n *\n * Firestore에서 실시간으로 모델 정보를 조회하여 캐싱\n * 새로운 모델 추가 시 코드 수정 불필요\n */\n\nimport type { Firestore } from 'firebase/firestore';\nimport { collection, getDocs } from 'firebase/firestore';\n\n/**\n * 모델 매핑 정보\n */\nexport interface ModelMapping {\n  firestoreId: string;     // Firestore 모델 ID (예: \"ioniq-5\")\n  koreanName: string;      // 한글 모델명 (예: \"아이오닉 5\")\n  englishName: string;     // 영문 모델명 (예: \"IONIQ-5\")\n  storageName: string;     // Storage 모델명 (예: \"IONIQ-5\")\n  brandId: string;         // 소속 브랜드 ID\n}\n\n/**\n * 모델 정보 캐시\n *\n * Key: `{brandId}:{modelName}` 형식\n * Value: 모델 매핑 정보\n */\nconst modelCache = new Map<string, ModelMapping>();\n\n/**\n * 브랜드별 모델 목록 캐시\n *\n * Key: brandId\n * Value: 해당 브랜드의 모든 모델 매핑 배열\n */\nconst brandModelsCache = new Map<string, ModelMapping[]>();\n\n/**\n * 초기화 상태\n */\nlet initialized = false;\n\n/**\n * Firestore에서 모델 정보를 조회하여 캐시 초기화\n *\n * @param firestore - Firestore 인스턴스\n * @param brandIds - 초기화할 브랜드 ID 목록 (생략 시 모든 브랜드)\n *\n * @example\n * ```typescript\n * // 모든 브랜드의 모델 초기화\n * await initializeModelMappings(db);\n *\n * // 특정 브랜드만 초기화\n * await initializeModelMappings(db, ['hyundai', 'kia']);\n * ```\n */\nexport async function initializeModelMappings(\n  firestore: Firestore,\n  brandIds?: string[]\n): Promise<void> {\n  console.log('[Model Mapping] Initializing from Firestore...');\n\n  try {\n    // 브랜드 목록 조회\n    const vehiclesRef = collection(firestore, 'vehicles');\n    const brandsSnapshot = await getDocs(vehiclesRef);\n\n    let processedBrands = 0;\n    let processedModels = 0;\n\n    for (const brandDoc of brandsSnapshot.docs) {\n      const brandId = brandDoc.id;\n\n      // 특정 브랜드만 초기화하는 경우\n      if (brandIds && !brandIds.includes(brandId)) {\n        continue;\n      }\n\n      // 해당 브랜드의 모델 조회\n      const modelsRef = collection(firestore, 'vehicles', brandId, 'models');\n      const modelsSnapshot = await getDocs(modelsRef);\n\n      const brandModels: ModelMapping[] = [];\n\n      modelsSnapshot.docs.forEach(modelDoc => {\n        const data = modelDoc.data();\n\n        const mapping: ModelMapping = {\n          firestoreId: modelDoc.id,\n          koreanName: data.name || modelDoc.id,\n          englishName: data.englishName || modelDoc.id.toUpperCase(),\n          storageName: data.englishName?.toUpperCase() || modelDoc.id.toUpperCase(),\n          brandId: brandId\n        };\n\n        brandModels.push(mapping);\n        processedModels++;\n\n        // 여러 키로 등록\n        const keys = [\n          `${brandId}:${modelDoc.id}`,                            // \"hyundai:ioniq-5\"\n          `${brandId}:${data.name}`,                              // \"hyundai:아이오닉 5\"\n          `${brandId}:${data.englishName}`,                       // \"hyundai:IONIQ-5\"\n          `${brandId}:${data.englishName?.toLowerCase()}`,        // \"hyundai:ioniq-5\"\n          `${brandId}:${modelDoc.id.toUpperCase()}`,             // \"hyundai:IONIQ-5\"\n        ];\n\n        keys.forEach(key => {\n          if (key && !key.includes('undefined')) {\n            modelCache.set(key, mapping);\n          }\n        });\n      });\n\n      brandModelsCache.set(brandId, brandModels);\n      processedBrands++;\n    }\n\n    initialized = true;\n    console.log(\n      `[Model Mapping] ✅ Initialized: ${processedBrands} brands, ${processedModels} models`\n    );\n  } catch (error) {\n    console.error('[Model Mapping] ❌ Initialization failed:', error);\n    throw error;\n  }\n}\n\n/**\n * 모델 매핑 정보 조회\n *\n * @param brandId - 브랜드 ID\n * @param modelInput - 모델명 (한글/영문/ID 모두 가능)\n * @returns 모델 매핑 정보 또는 null\n *\n * @throws {Error} 초기화되지 않은 경우\n *\n * @example\n * ```typescript\n * getModelMapping('hyundai', '아이오닉 5');   // { firestoreId: 'ioniq-5', ... }\n * getModelMapping('hyundai', 'IONIQ-5');     // { firestoreId: 'ioniq-5', ... }\n * getModelMapping('hyundai', 'ioniq-5');     // { firestoreId: 'ioniq-5', ... }\n * ```\n */\nexport function getModelMapping(\n  brandId: string,\n  modelInput: string\n): ModelMapping | null {\n  if (!initialized) {\n    throw new Error(\n      '[Model Mapping] Not initialized. Call initializeModelMappings() first.'\n    );\n  }\n\n  // 직접 매칭 시도\n  const keys = [\n    `${brandId}:${modelInput}`,\n    `${brandId}:${modelInput.toLowerCase()}`,\n    `${brandId}:${modelInput.toUpperCase()}`,\n    `${brandId}:${modelInput.trim()}`,\n  ];\n\n  for (const key of keys) {\n    const mapping = modelCache.get(key);\n    if (mapping) return mapping;\n  }\n\n  // 유사도 매칭 (Fallback)\n  const brandModels = brandModelsCache.get(brandId);\n  if (brandModels) {\n    const normalizedInput = modelInput.toLowerCase().replace(/[\\s\\-]/g, '');\n\n    for (const model of brandModels) {\n      const normalizedModel = model.englishName.toLowerCase().replace(/[\\s\\-]/g, '');\n      if (normalizedModel === normalizedInput) {\n        return model;\n      }\n    }\n  }\n\n  console.warn(`[Model Mapping] Unknown model: ${brandId}:${modelInput}`);\n  return null;\n}\n\n/**\n * 브랜드의 모든 모델 조회\n *\n * @param brandId - 브랜드 ID\n * @returns 모델 매핑 배열\n */\nexport function getBrandModels(brandId: string): ModelMapping[] {\n  if (!initialized) {\n    throw new Error(\n      '[Model Mapping] Not initialized. Call initializeModelMappings() first.'\n    );\n  }\n\n  return brandModelsCache.get(brandId) || [];\n}\n\n/**\n * 초기화 상태 확인\n */\nexport function isInitialized(): boolean {\n  return initialized;\n}\n\n/**\n * 캐시 초기화 (테스트용)\n */\nexport function resetCache(): void {\n  modelCache.clear();\n  brandModelsCache.clear();\n  initialized = false;\n  console.log('[Model Mapping] Cache reset');\n}\n\n/**\n * 캐시된 모델 수\n */\nexport function getCachedModelCount(): number {\n  return modelCache.size;\n}\n","/**\n * Firebase Storage 차량 이미지 URL/경로 생성 유틸리티\n * \n * ⚠️ 주의: 이 파일은 순수 함수만 포함합니다.\n * Firebase SDK나 업로드 로직은 포함하지 않습니다.\n */\n\nconst FIREBASE_STORAGE_BASE = 'https://firebasestorage.googleapis.com/v0/b/charzing-d1600.firebasestorage.app/o';\n\n/**\n * 브랜드명을 Storage 경로용으로 정규화\n * ✅ 완전 동적 처리: Firestore ID → Storage 폴더\n *\n * 규칙: 하이픈(-)을 언더스코어(_)로 변환 후 대문자\n * - mercedes-benz → MERCEDES_BENZ\n * - mercedes-maybach → MERCEDES_MAYBACH\n * - hyundai → HYUNDAI\n * - kia → KIA\n */\nfunction normalizeStorageBrand(firestoreBrandId: string): string {\n  // ✅ 완전 동적 변환: 하이픈 → 언더스코어, 대문자\n  return firestoreBrandId.toUpperCase().replace(/-/g, '_');\n}\n\n/**\n * 모델명을 Storage 경로용으로 정규화\n * ✅ 동적 처리: Firestore ID → Storage 폴더 (대문자)\n */\nfunction normalizeStorageModel(firestoreModelId: string): string {\n  return firestoreModelId.toUpperCase();\n}\n\n/**\n * 트림명을 파일명용으로 정규화\n */\nfunction normalizeStorageTrim(trim?: string): string {\n  if (!trim) return '';\n  return trim.toLowerCase().replace(/[\\s\\-]/g, '_').replace(/[^a-z0-9_]/g, '');\n}\n\nexport interface ImagePathParams {\n  brandId: string;\n  modelId: string;\n  year: number;\n  trim?: string;\n}\n\n/**\n * 차량 이미지 파일명 생성\n * 예: kia__niro-ev__2022__standard.png\n */\nexport function generateImageFilename(params: ImagePathParams): string {\n  const { brandId, modelId, year, trim } = params;\n  const brandLower = brandId.toLowerCase();\n  const modelLower = modelId.toLowerCase().replace(/[\\s]/g, '-');\n  const trimPart = trim ? `__${normalizeStorageTrim(trim)}` : '';\n  return `${brandLower}__${modelLower}__${year}${trimPart}.png`;\n}\n\n/**\n * Storage 경로 생성 (업로드용)\n * 예: vehicle-images/KIA/NIRO-EV/2022/kia__niro-ev__2022__standard.png\n */\nexport function generateStoragePath(params: ImagePathParams): string {\n  const { brandId, modelId, year } = params;\n  const storageBrand = normalizeStorageBrand(brandId);\n  const storageModel = normalizeStorageModel(modelId);\n  const filename = generateImageFilename(params);\n  return `vehicle-images/${storageBrand}/${storageModel}/${year}/${filename}`;\n}\n\n/**\n * 완전한 Firebase Storage URL 생성 (읽기용)\n */\nexport function generateVehicleImageUrl(params: ImagePathParams): string {\n  const path = generateStoragePath(params);\n  const encodedPath = encodeURIComponent(path);\n  return `${FIREBASE_STORAGE_BASE}/${encodedPath}?alt=media`;\n}\n"],"mappings":"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","names":["getBrandMapping","collection","getDocs","initialized","getModelMapping","isInitialized","resetCache"]}
+{"version":3,"sources":["../../src/brand/mapping.ts","../../src/brand/dynamic-mapping.ts","../../src/model/mapping.ts","../../src/model/dynamic-mapping.ts","../../src/image/url-generator.ts"],"sourcesContent":["/**\n * 브랜드 매핑 유틸리티\n *\n * 한글/영문 브랜드명 변환, Firestore ID 정규화, Storage 브랜드명 매핑\n */\n\nimport type { BrandId, BrandMapping, StorageBrandName } from '../types/brand';\n\n/**\n * 한글 → Firestore ID 매핑 테이블\n */\nconst KOREAN_TO_ID: Record<string, BrandId> = {\n  '현대': 'hyundai',\n  'HYUNDAI': 'hyundai',\n  'Hyundai': 'hyundai',\n\n  '기아': 'kia',\n  'KIA': 'kia',\n  'Kia': 'kia',\n\n  '테슬라': 'tesla',\n  'TESLA': 'tesla',\n  'Tesla': 'tesla',\n\n  'BMW': 'bmw',\n  'bmw': 'bmw',\n  '비엠더블유': 'bmw',\n\n  '메르세데스-벤츠': 'mercedes-benz',\n  'Mercedes-Benz': 'mercedes-benz',\n  'MERCEDES-BENZ': 'mercedes-benz',\n  '벤츠': 'mercedes-benz',\n  'Benz': 'mercedes-benz',\n  'BENZ': 'mercedes-benz',\n\n  '메르세데스-마이바흐': 'mercedes-maybach',\n  'Mercedes-Maybach': 'mercedes-maybach',\n  'MERCEDES-MAYBACH': 'mercedes-maybach',\n  '마이바흐': 'mercedes-maybach',\n  'Maybach': 'mercedes-maybach',\n  'MAYBACH': 'mercedes-maybach',\n\n  '아우디': 'audi',\n  'AUDI': 'audi',\n  'Audi': 'audi',\n\n  '포르쉐': 'porsche',\n  '포르셰': 'porsche',\n  'PORSCHE': 'porsche',\n  'Porsche': 'porsche',\n\n  'MINI': 'mini',\n  'Mini': 'mini',\n  'mini': 'mini',\n  '미니': 'mini'\n};\n\n/**\n * Firestore ID → 한글 브랜드명 매핑\n */\nconst ID_TO_KOREAN: Record<BrandId, string> = {\n  'hyundai': '현대',\n  'kia': '기아',\n  'tesla': '테슬라',\n  'bmw': 'BMW',\n  'mercedes-benz': '메르세데스-벤츠',\n  'mercedes-maybach': '메르세데스-마이바흐',\n  'audi': '아우디',\n  'porsche': '포르쉐',\n  'mini': '미니'\n};\n\n/**\n * Firestore ID → 영문 브랜드명 매핑\n */\nconst ID_TO_ENGLISH: Record<BrandId, string> = {\n  'hyundai': 'HYUNDAI',\n  'kia': 'KIA',\n  'tesla': 'TESLA',\n  'bmw': 'BMW',\n  'mercedes-benz': 'Mercedes-Benz',\n  'mercedes-maybach': 'Mercedes-Maybach',\n  'audi': 'AUDI',\n  'porsche': 'PORSCHE',\n  'mini': 'MINI'\n};\n\n/**\n * Firestore ID → Firebase Storage 브랜드명 매핑\n * Mercedes-Benz와 Mercedes-Maybach는 'BENZ'로 통합\n */\nconst ID_TO_STORAGE: Record<BrandId, StorageBrandName> = {\n  'hyundai': 'HYUNDAI',\n  'kia': 'KIA',\n  'tesla': 'TESLA',\n  'bmw': 'BMW',\n  'mercedes-benz': 'BENZ',        // ⚠️ BENZ로 통합\n  'mercedes-maybach': 'BENZ',     // ⚠️ BENZ로 통합\n  'audi': 'AUDI',\n  'porsche': 'PORSCHE',\n  'mini': 'MINI'\n};\n\n/**\n * 브랜드 ID 정규화 (소문자 통일)\n *\n * @param brandInput - 브랜드명 (한글, 영문, 대소문자 무관)\n * @returns Firestore 브랜드 ID (소문자, 하이픈)\n *\n * @example\n * ```typescript\n * normalizeBrandId('현대'); // 'hyundai'\n * normalizeBrandId('BMW'); // 'bmw'\n * normalizeBrandId('Mercedes-Benz'); // 'mercedes-benz'\n * ```\n */\nexport function normalizeBrandId(brandInput: string): BrandId {\n  // 1. 매핑 테이블에서 직접 찾기\n  if (brandInput in KOREAN_TO_ID) {\n    return KOREAN_TO_ID[brandInput];\n  }\n\n  // 2. 소문자 변환 후 확인\n  const lowercased = brandInput.toLowerCase().trim();\n  if (lowercased in KOREAN_TO_ID) {\n    return KOREAN_TO_ID[lowercased];\n  }\n\n  // 3. 이미 올바른 Firestore ID인 경우\n  if (Object.values(KOREAN_TO_ID).includes(lowercased as BrandId)) {\n    return lowercased as BrandId;\n  }\n\n  // 4. 매칭 실패 시 소문자 변환 결과 반환 (fallback)\n  console.warn(`[normalizeBrandId] 알 수 없는 브랜드: \"${brandInput}\", fallback: \"${lowercased}\"`);\n  return lowercased as BrandId;\n}\n\n/**\n * 한글 브랜드명 가져오기\n *\n * @param brandId - Firestore 브랜드 ID\n * @returns 한글 브랜드명\n *\n * @example\n * ```typescript\n * getBrandNameKorean('hyundai'); // '현대'\n * getBrandNameKorean('bmw'); // 'BMW'\n * ```\n */\nexport function getBrandNameKorean(brandId: BrandId): string {\n  return ID_TO_KOREAN[brandId] || brandId;\n}\n\n/**\n * 영문 브랜드명 가져오기\n *\n * @param brandId - Firestore 브랜드 ID\n * @returns 영문 브랜드명\n *\n * @example\n * ```typescript\n * getBrandNameEnglish('hyundai'); // 'HYUNDAI'\n * getBrandNameEnglish('mercedes-benz'); // 'Mercedes-Benz'\n * ```\n */\nexport function getBrandNameEnglish(brandId: BrandId): string {\n  return ID_TO_ENGLISH[brandId] || brandId.toUpperCase();\n}\n\n/**\n * Firebase Storage 브랜드명 가져오기\n *\n * @param brandId - Firestore 브랜드 ID\n * @returns Storage 브랜드명 (대문자)\n *\n * @example\n * ```typescript\n * getStorageBrandName('hyundai'); // 'HYUNDAI'\n * getStorageBrandName('mercedes-benz'); // 'BENZ'\n * getStorageBrandName('mercedes-maybach'); // 'BENZ'\n * ```\n */\nexport function getStorageBrandName(brandId: BrandId): StorageBrandName {\n  return ID_TO_STORAGE[brandId] || brandId.toUpperCase() as StorageBrandName;\n}\n\n/**\n * 브랜드 매핑 정보 가져오기 (통합 함수)\n *\n * @param brandInput - 브랜드명 (한글, 영문, 대소문자 무관)\n * @returns 브랜드 매핑 정보\n *\n * @example\n * ```typescript\n * getBrandMapping('현대');\n * // {\n * //   firestoreId: 'hyundai',\n * //   koreanName: '현대',\n * //   englishName: 'HYUNDAI',\n * //   storageName: 'HYUNDAI'\n * // }\n * ```\n */\nexport function getBrandMapping(brandInput: string): BrandMapping {\n  const firestoreId = normalizeBrandId(brandInput);\n\n  return {\n    firestoreId,\n    koreanName: getBrandNameKorean(firestoreId),\n    englishName: getBrandNameEnglish(firestoreId),\n    storageName: getStorageBrandName(firestoreId)\n  };\n}\n\n/**\n * 지원되는 모든 브랜드 ID 목록\n */\nexport const SUPPORTED_BRANDS: BrandId[] = [\n  'hyundai',\n  'kia',\n  'tesla',\n  'bmw',\n  'mini',\n  'audi',\n  'mercedes-benz',\n  'mercedes-maybach',\n  'porsche'\n];\n","/**\n * 동적 브랜드 매핑 시스템\n *\n * Firestore에서 실시간으로 브랜드 정보를 조회하여 캐싱\n * 새로운 브랜드 추가 시 코드 수정 불필요\n */\n\nimport type { Firestore } from 'firebase/firestore';\nimport { collection, getDocs } from 'firebase/firestore';\nimport type { BrandId, BrandMapping } from '../types/brand';\n\n/**\n * 브랜드 정보 캐시\n *\n * Key: 브랜드명 (한글/영문/ID 모두)\n * Value: 브랜드 매핑 정보\n */\nconst brandCache = new Map<string, BrandMapping>();\n\n/**\n * 초기화 상태\n */\nlet initialized = false;\n\n/**\n * Firestore에서 브랜드 정보를 조회하여 캐시 초기화\n *\n * @param firestore - Firestore 인스턴스\n *\n * @example\n * ```typescript\n * import { initializeBrandMappings } from '@charzing/vehicle-utils';\n * import { db } from './firebase';\n *\n * // 앱 시작 시 한 번만 호출\n * await initializeBrandMappings(db);\n * ```\n */\nexport async function initializeBrandMappings(firestore: Firestore): Promise<void> {\n  if (initialized) {\n    console.log('[Brand Mapping] Already initialized');\n    return;\n  }\n\n  console.log('[Brand Mapping] Initializing from Firestore...');\n\n  try {\n    const vehiclesRef = collection(firestore, 'vehicles');\n    const snapshot = await getDocs(vehiclesRef);\n\n    snapshot.docs.forEach(doc => {\n      const data = doc.data();\n\n      // Storage 브랜드명 특별 처리\n      let storageName = data.englishName?.toUpperCase() || doc.id.toUpperCase();\n\n      // Mercedes-Benz/Maybach는 'BENZ'로 통합\n      if (doc.id === 'mercedes-benz' || doc.id === 'mercedes-maybach') {\n        storageName = 'BENZ';\n      }\n\n      const mapping: BrandMapping = {\n        firestoreId: doc.id as BrandId,\n        koreanName: data.name || doc.id,\n        englishName: data.englishName || doc.id.toUpperCase(),\n        storageName: storageName as any\n      };\n\n      // 여러 키로 등록 (대소문자 구분 없이 조회 가능)\n      brandCache.set(doc.id, mapping);                                    // 'hyundai'\n      brandCache.set(doc.id.toUpperCase(), mapping);                      // 'HYUNDAI'\n      brandCache.set(doc.id.toLowerCase(), mapping);                      // 'hyundai'\n      brandCache.set(data.name, mapping);                                 // '현대'\n      brandCache.set(data.englishName, mapping);                          // 'HYUNDAI'\n      brandCache.set(data.englishName?.toUpperCase(), mapping);           // 'HYUNDAI'\n      brandCache.set(data.englishName?.toLowerCase(), mapping);           // 'hyundai'\n    });\n\n    initialized = true;\n    console.log(`[Brand Mapping] ✅ Initialized with ${snapshot.docs.length} brands`);\n  } catch (error) {\n    console.error('[Brand Mapping] ❌ Initialization failed:', error);\n    throw error;\n  }\n}\n\n/**\n * 브랜드 매핑 정보 조회\n *\n * @param brandInput - 브랜드명 (한글/영문/ID 모두 가능)\n * @returns 브랜드 매핑 정보 또는 null\n *\n * @throws {Error} 초기화되지 않은 경우\n *\n * @example\n * ```typescript\n * getBrandMapping('현대');    // { firestoreId: 'hyundai', ... }\n * getBrandMapping('HYUNDAI'); // { firestoreId: 'hyundai', ... }\n * getBrandMapping('hyundai'); // { firestoreId: 'hyundai', ... }\n * ```\n */\nexport function getBrandMapping(brandInput: string): BrandMapping | null {\n  if (!initialized) {\n    throw new Error(\n      '[Brand Mapping] Not initialized. Call initializeBrandMappings() first.'\n    );\n  }\n\n  // 직접 매칭 시도\n  let mapping = brandCache.get(brandInput);\n  if (mapping) return mapping;\n\n  // 대소문자 구분 없이 재시도\n  mapping = brandCache.get(brandInput.toLowerCase());\n  if (mapping) return mapping;\n\n  mapping = brandCache.get(brandInput.toUpperCase());\n  if (mapping) return mapping;\n\n  // 공백 제거 후 재시도\n  const trimmed = brandInput.trim();\n  mapping = brandCache.get(trimmed);\n  if (mapping) return mapping;\n\n  console.warn(`[Brand Mapping] Unknown brand: \"${brandInput}\"`);\n  return null;\n}\n\n/**\n * 초기화 상태 확인\n */\nexport function isInitialized(): boolean {\n  return initialized;\n}\n\n/**\n * 캐시 초기화 (테스트용)\n */\nexport function resetCache(): void {\n  brandCache.clear();\n  initialized = false;\n  console.log('[Brand Mapping] Cache reset');\n}\n\n/**\n * 캐시된 브랜드 수\n */\nexport function getCachedBrandCount(): number {\n  return brandCache.size;\n}\n","/**\n * 모델 매핑 유틸리티\n *\n * 한글/영문 모델명 변환, 모델 ID 정규화, 유사도 기반 매칭\n */\n\nimport type { ModelId, ModelSlug, ModelMapping } from '../types/model';\n\n/**\n * 한글 → 영문 모델명 매핑 테이블\n */\nconst KOREAN_TO_ENGLISH_MODEL: Record<string, string> = {\n  // MINI\n  '쿠퍼': 'COOPER',\n  '컨트리맨': 'COUNTRYMAN',\n  '에이스맨': 'ACEMAN',\n\n  // Hyundai\n  '아이오닉': 'IONIQ',\n  '코나': 'KONA',\n  '넥소': 'NEXO',\n  '캐스퍼': 'CASPER',\n\n  // Kia\n  '니로': 'NIRO',\n  '레이': 'RAY',\n\n  // Tesla\n  '모델': 'MODEL',\n\n  // Common words\n  '일렉트릭': 'ELECTRIC',\n  'E': 'E',\n  'EV': 'EV'\n};\n\n/**\n * 문자열을 슬러그로 변환\n * - 소문자 변환\n * - 공백/언더바 → 하이픈\n * - 연속 하이픈 제거\n * - 앞뒤 하이픈 제거\n *\n * @param str - 변환할 문자열\n * @returns 슬러그 문자열\n *\n * @example\n * ```typescript\n * toSlug('IONIQ 5'); // 'ioniq-5'\n * toSlug('Model S'); // 'model-s'\n * toSlug('Cooper  JCW'); // 'cooper-jcw'\n * ```\n */\nexport function toSlug(str: string): string {\n  return str\n    .toLowerCase()\n    .trim()\n    .replace(/[\\s_]+/g, '-')   // 공백/언더바 → 하이픈\n    .replace(/-+/g, '-')       // 연속 하이픈 제거\n    .replace(/^-+|-+$/g, '');  // 앞뒤 하이픈 제거\n}\n\n/**\n * 한글 모델명을 영문으로 변환\n *\n * @param koreanModel - 한글 모델명\n * @returns 영문 모델명\n *\n * @example\n * ```typescript\n * convertKoreanToEnglish('아이오닉 5'); // 'IONIQ 5'\n * convertKoreanToEnglish('니로 EV'); // 'NIRO EV'\n * convertKoreanToEnglish('쿠퍼'); // 'COOPER'\n * ```\n */\nexport function convertKoreanToEnglish(koreanModel: string): string {\n  let result = koreanModel;\n\n  // 각 한글 단어를 영문으로 치환\n  for (const [korean, english] of Object.entries(KOREAN_TO_ENGLISH_MODEL)) {\n    const regex = new RegExp(korean, 'gi');\n    result = result.replace(regex, english);\n  }\n\n  return result;\n}\n\n/**\n * 모델 ID 정규화 (소문자, 하이픈)\n *\n * @param modelInput - 모델명 (한글, 영문, 대소문자 무관)\n * @returns Firestore 모델 ID (소문자, 하이픈)\n *\n * @example\n * ```typescript\n * normalizeModelId('아이오닉 5'); // 'ioniq-5'\n * normalizeModelId('Model S'); // 'model-s'\n * normalizeModelId('COOPER JCW'); // 'cooper-jcw'\n * ```\n */\nexport function normalizeModelId(modelInput: string): ModelId {\n  // 1. 한글 → 영문 변환 시도\n  const englishModel = convertKoreanToEnglish(modelInput);\n\n  // 2. 슬러그 변환\n  return toSlug(englishModel);\n}\n\n/**\n * 두 문자열의 유사도 점수 계산\n * - 정확한 매칭: 2점\n * - 부분 매칭: 1점\n *\n * @param input - 입력 문자열\n * @param target - 비교 대상 문자열\n * @returns 유사도 점수 (높을수록 유사)\n */\nfunction calculateSimilarity(input: string, target: string): number {\n  const inputWords = input.toLowerCase().replace(/[\\s\\-]/g, ' ').split(' ').filter(w => w.length > 0);\n  const targetWords = target.toLowerCase().replace(/[\\s\\-]/g, ' ').split(' ').filter(w => w.length > 0);\n\n  let score = 0;\n\n  for (const inputWord of inputWords) {\n    for (const targetWord of targetWords) {\n      if (inputWord === targetWord) {\n        score += 2; // 정확한 단어 매칭\n      } else if (inputWord.includes(targetWord) || targetWord.includes(inputWord)) {\n        score += 1; // 부분 매칭\n      }\n    }\n  }\n\n  return score;\n}\n\n/**\n * 가능한 모델 목록에서 최적 매칭 찾기\n * - 정확한 매칭 우선\n * - 없으면 유사도 점수 기반 매칭\n *\n * @param inputModel - 입력 모델명\n * @param availableModels - 가능한 모델 ID 목록\n * @returns 매칭된 모델 ID 또는 null\n *\n * @example\n * ```typescript\n * findBestModelMatch('아이오닉5', ['ioniq-5', 'ioniq-6', 'kona-electric']);\n * // 'ioniq-5'\n *\n * findBestModelMatch('NEXSO', ['ioniq-5', 'nexo', 'kona-electric']);\n * // 'nexo' (유사도 매칭)\n * ```\n */\nexport function findBestModelMatch(inputModel: string, availableModels: string[]): string | null {\n  // 1. 정확한 매칭 시도\n  const normalizedInput = normalizeModelId(inputModel);\n\n  const exactMatch = availableModels.find(model => {\n    const normalizedModel = normalizeModelId(model);\n    return normalizedModel === normalizedInput;\n  });\n\n  if (exactMatch) {\n    return exactMatch;\n  }\n\n  // 2. 유사도 점수 기반 매칭\n  let bestMatch: string | null = null;\n  let bestScore = 0;\n\n  for (const model of availableModels) {\n    const score = calculateSimilarity(inputModel, model);\n\n    if (score > bestScore) {\n      bestScore = score;\n      bestMatch = model;\n    }\n  }\n\n  // 최소 점수 임계값 (0보다 커야 함)\n  return (bestMatch && bestScore > 0) ? bestMatch : null;\n}\n\n/**\n * 모델 슬러그 생성 (URL/파일명용)\n *\n * @param modelInput - 모델명\n * @returns 모델 슬러그\n *\n * @example\n * ```typescript\n * getModelSlug('아이오닉 5'); // 'ioniq-5'\n * getModelSlug('Model 3'); // 'model-3'\n * ```\n */\nexport function getModelSlug(modelInput: string): ModelSlug {\n  return normalizeModelId(modelInput);\n}\n\n/**\n * 모델 매핑 정보 가져오기\n *\n * @param modelInput - 모델명 (한글 또는 영문)\n * @param englishName - 영문 모델명 (선택적)\n * @param koreanName - 한글 모델명 (선택적)\n * @returns 모델 매핑 정보\n *\n * @example\n * ```typescript\n * getModelMapping('아이오닉 5', 'IONIQ-5', '아이오닉 5');\n * // {\n * //   firestoreId: 'ioniq-5',\n * //   koreanName: '아이오닉 5',\n * //   englishName: 'IONIQ-5',\n * //   slug: 'ioniq-5'\n * // }\n * ```\n */\nexport function getModelMapping(\n  modelInput: string,\n  englishName?: string,\n  koreanName?: string\n): ModelMapping {\n  const firestoreId = normalizeModelId(modelInput);\n  const slug = getModelSlug(modelInput);\n\n  return {\n    firestoreId,\n    koreanName: koreanName || modelInput,\n    englishName: englishName || convertKoreanToEnglish(modelInput),\n    slug\n  };\n}\n","/**\n * 동적 모델 매핑 시스템\n *\n * Firestore에서 실시간으로 모델 정보를 조회하여 캐싱\n * 새로운 모델 추가 시 코드 수정 불필요\n */\n\nimport type { Firestore } from 'firebase/firestore';\nimport { collection, getDocs } from 'firebase/firestore';\n\n/**\n * 모델 매핑 정보\n */\nexport interface ModelMapping {\n  firestoreId: string;     // Firestore 모델 ID (예: \"ioniq-5\")\n  koreanName: string;      // 한글 모델명 (예: \"아이오닉 5\")\n  englishName: string;     // 영문 모델명 (예: \"IONIQ-5\")\n  storageName: string;     // Storage 모델명 (예: \"IONIQ-5\")\n  brandId: string;         // 소속 브랜드 ID\n}\n\n/**\n * 모델 정보 캐시\n *\n * Key: `{brandId}:{modelName}` 형식\n * Value: 모델 매핑 정보\n */\nconst modelCache = new Map<string, ModelMapping>();\n\n/**\n * 브랜드별 모델 목록 캐시\n *\n * Key: brandId\n * Value: 해당 브랜드의 모든 모델 매핑 배열\n */\nconst brandModelsCache = new Map<string, ModelMapping[]>();\n\n/**\n * 초기화 상태\n */\nlet initialized = false;\n\n/**\n * Firestore에서 모델 정보를 조회하여 캐시 초기화\n *\n * @param firestore - Firestore 인스턴스\n * @param brandIds - 초기화할 브랜드 ID 목록 (생략 시 모든 브랜드)\n *\n * @example\n * ```typescript\n * // 모든 브랜드의 모델 초기화\n * await initializeModelMappings(db);\n *\n * // 특정 브랜드만 초기화\n * await initializeModelMappings(db, ['hyundai', 'kia']);\n * ```\n */\nexport async function initializeModelMappings(\n  firestore: Firestore,\n  brandIds?: string[]\n): Promise<void> {\n  console.log('[Model Mapping] Initializing from Firestore...');\n\n  try {\n    // 브랜드 목록 조회\n    const vehiclesRef = collection(firestore, 'vehicles');\n    const brandsSnapshot = await getDocs(vehiclesRef);\n\n    let processedBrands = 0;\n    let processedModels = 0;\n\n    for (const brandDoc of brandsSnapshot.docs) {\n      const brandId = brandDoc.id;\n\n      // 특정 브랜드만 초기화하는 경우\n      if (brandIds && !brandIds.includes(brandId)) {\n        continue;\n      }\n\n      // 해당 브랜드의 모델 조회\n      const modelsRef = collection(firestore, 'vehicles', brandId, 'models');\n      const modelsSnapshot = await getDocs(modelsRef);\n\n      const brandModels: ModelMapping[] = [];\n\n      modelsSnapshot.docs.forEach(modelDoc => {\n        const data = modelDoc.data();\n\n        const mapping: ModelMapping = {\n          firestoreId: modelDoc.id,\n          koreanName: data.name || modelDoc.id,\n          englishName: data.englishName || modelDoc.id.toUpperCase(),\n          storageName: data.englishName?.toUpperCase() || modelDoc.id.toUpperCase(),\n          brandId: brandId\n        };\n\n        brandModels.push(mapping);\n        processedModels++;\n\n        // 여러 키로 등록\n        const keys = [\n          `${brandId}:${modelDoc.id}`,                            // \"hyundai:ioniq-5\"\n          `${brandId}:${data.name}`,                              // \"hyundai:아이오닉 5\"\n          `${brandId}:${data.englishName}`,                       // \"hyundai:IONIQ-5\"\n          `${brandId}:${data.englishName?.toLowerCase()}`,        // \"hyundai:ioniq-5\"\n          `${brandId}:${modelDoc.id.toUpperCase()}`,             // \"hyundai:IONIQ-5\"\n        ];\n\n        keys.forEach(key => {\n          if (key && !key.includes('undefined')) {\n            modelCache.set(key, mapping);\n          }\n        });\n      });\n\n      brandModelsCache.set(brandId, brandModels);\n      processedBrands++;\n    }\n\n    initialized = true;\n    console.log(\n      `[Model Mapping] ✅ Initialized: ${processedBrands} brands, ${processedModels} models`\n    );\n  } catch (error) {\n    console.error('[Model Mapping] ❌ Initialization failed:', error);\n    throw error;\n  }\n}\n\n/**\n * 모델 매핑 정보 조회\n *\n * @param brandId - 브랜드 ID\n * @param modelInput - 모델명 (한글/영문/ID 모두 가능)\n * @returns 모델 매핑 정보 또는 null\n *\n * @throws {Error} 초기화되지 않은 경우\n *\n * @example\n * ```typescript\n * getModelMapping('hyundai', '아이오닉 5');   // { firestoreId: 'ioniq-5', ... }\n * getModelMapping('hyundai', 'IONIQ-5');     // { firestoreId: 'ioniq-5', ... }\n * getModelMapping('hyundai', 'ioniq-5');     // { firestoreId: 'ioniq-5', ... }\n * ```\n */\nexport function getModelMapping(\n  brandId: string,\n  modelInput: string\n): ModelMapping | null {\n  if (!initialized) {\n    throw new Error(\n      '[Model Mapping] Not initialized. Call initializeModelMappings() first.'\n    );\n  }\n\n  // 직접 매칭 시도\n  const keys = [\n    `${brandId}:${modelInput}`,\n    `${brandId}:${modelInput.toLowerCase()}`,\n    `${brandId}:${modelInput.toUpperCase()}`,\n    `${brandId}:${modelInput.trim()}`,\n  ];\n\n  for (const key of keys) {\n    const mapping = modelCache.get(key);\n    if (mapping) return mapping;\n  }\n\n  // 유사도 매칭 (Fallback)\n  const brandModels = brandModelsCache.get(brandId);\n  if (brandModels) {\n    const normalizedInput = modelInput.toLowerCase().replace(/[\\s\\-]/g, '');\n\n    for (const model of brandModels) {\n      const normalizedModel = model.englishName.toLowerCase().replace(/[\\s\\-]/g, '');\n      if (normalizedModel === normalizedInput) {\n        return model;\n      }\n    }\n  }\n\n  console.warn(`[Model Mapping] Unknown model: ${brandId}:${modelInput}`);\n  return null;\n}\n\n/**\n * 브랜드의 모든 모델 조회\n *\n * @param brandId - 브랜드 ID\n * @returns 모델 매핑 배열\n */\nexport function getBrandModels(brandId: string): ModelMapping[] {\n  if (!initialized) {\n    throw new Error(\n      '[Model Mapping] Not initialized. Call initializeModelMappings() first.'\n    );\n  }\n\n  return brandModelsCache.get(brandId) || [];\n}\n\n/**\n * 초기화 상태 확인\n */\nexport function isInitialized(): boolean {\n  return initialized;\n}\n\n/**\n * 캐시 초기화 (테스트용)\n */\nexport function resetCache(): void {\n  modelCache.clear();\n  brandModelsCache.clear();\n  initialized = false;\n  console.log('[Model Mapping] Cache reset');\n}\n\n/**\n * 캐시된 모델 수\n */\nexport function getCachedModelCount(): number {\n  return modelCache.size;\n}\n","/**\n * Firebase Storage 차량 이미지 URL/경로 생성 유틸리티\n *\n * ⚠️ 주의: 이 파일은 순수 함수만 포함합니다.\n * Firebase SDK나 업로드 로직은 포함하지 않습니다.\n */\n\nimport { VehicleImageParams } from '../types/image';\n\nconst FIREBASE_STORAGE_BASE = 'https://firebasestorage.googleapis.com/v0/b/charzing-d1600.firebasestorage.app/o';\n\n/**\n * 브랜드명을 Storage 경로용으로 정규화\n * ✅ 완전 동적 처리: Firestore ID → Storage 폴더\n *\n * 규칙: 하이픈(-)을 언더스코어(_)로 변환 후 대문자\n * - mercedes-benz → MERCEDES_BENZ\n * - mercedes-maybach → MERCEDES_MAYBACH\n * - hyundai → HYUNDAI\n * - kia → KIA\n */\nfunction normalizeStorageBrand(firestoreBrandId: string): string {\n  // ✅ 완전 동적 변환: 하이픈 → 언더스코어, 대문자\n  return firestoreBrandId.toUpperCase().replace(/-/g, '_');\n}\n\n/**\n * 모델명을 Storage 경로용으로 정규화\n * ✅ 동적 처리: Firestore ID → Storage 폴더 (대문자)\n */\nfunction normalizeStorageModel(firestoreModelId: string): string {\n  return firestoreModelId.toUpperCase();\n}\n\n/**\n * 트림명을 파일명용으로 정규화\n */\nfunction normalizeStorageTrim(trim?: string): string {\n  if (!trim) return '';\n  return trim.toLowerCase().replace(/[\\s\\-]/g, '_').replace(/[^a-z0-9_]/g, '');\n}\n\n/**\n * 차량 이미지 파일명 생성\n *\n * @example\n * generateImageFilename({\n *   brandId: 'kia',\n *   modelId: 'niro-ev',\n *   year: 2022,\n *   trim: 'standard'\n * })\n * // Returns: 'kia__niro-ev__2022__standard.png'\n */\nexport function generateImageFilename(params: VehicleImageParams): string {\n  const { brandId, modelId, year, trim } = params;\n  const brandLower = brandId.toLowerCase();\n  const modelLower = modelId.toLowerCase().replace(/[\\s]/g, '-');\n  const trimPart = trim ? `__${normalizeStorageTrim(trim)}` : '';\n  return `${brandLower}__${modelLower}__${year}${trimPart}.png`;\n}\n\n/**\n * Storage 경로 생성 (업로드용)\n *\n * @example\n * generateStoragePath({\n *   brandId: 'kia',\n *   modelId: 'niro-ev',\n *   year: 2022,\n *   trim: 'standard'\n * })\n * // Returns: 'vehicle-images/KIA/NIRO-EV/2022/kia__niro-ev__2022__standard.png'\n */\nexport function generateStoragePath(params: VehicleImageParams): string {\n  const { brandId, modelId, year } = params;\n  const storageBrand = normalizeStorageBrand(brandId);\n  const storageModel = normalizeStorageModel(modelId);\n  const filename = generateImageFilename(params);\n  return `vehicle-images/${storageBrand}/${storageModel}/${year}/${filename}`;\n}\n\n/**\n * 완전한 Firebase Storage URL 생성 (읽기용)\n *\n * ✅ 파라미터 검증: brandId, modelId, year 필수\n * ❌ Fallback 금지: 잘못된 파라미터 시 에러 throw\n *\n * @throws {Error} brandId, modelId, year가 없으면 에러\n *\n * @example\n * generateVehicleImageUrl({\n *   brandId: 'kia',\n *   modelId: 'niro-ev',\n *   year: 2022\n * })\n * // Returns: 'https://firebasestorage.googleapis.com/.../vehicle-images%2FKIA%2FNIRO-EV%2F2022%2Fkia__niro-ev__2022.png?alt=media'\n */\nexport function generateVehicleImageUrl(params: VehicleImageParams): string {\n  // ✅ 필수 파라미터 검증 (fallback 금지)\n  if (!params.brandId) {\n    throw new Error('brandId is required');\n  }\n  if (!params.modelId) {\n    throw new Error('modelId is required');\n  }\n  if (!params.year) {\n    throw new Error('year is required');\n  }\n\n  const path = generateStoragePath(params);\n  const encodedPath = encodeURIComponent(path);\n  return `${FIREBASE_STORAGE_BASE}/${encodedPath}?alt=media`;\n}\n"],"mappings":"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","names":["getBrandMapping","collection","getDocs","initialized","getModelMapping","isInitialized","resetCache"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@charzing/vehicle-utils",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "Shared utilities for Charzing vehicle data management across all platforms (with dynamic Firestore mapping)",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.mjs",