vin-origin-decoder 1.0.0

package/README.md

@@ -0,0 +1,12 @@
+# vin-origin-decoder
+
+Decode vehicle manufacturing origin from a VIN.
+
+## Installation
+npm install vin-origin-decoder
+
+## Usage
+```ts
+import { decodeVinOrigin } from 'vin-origin-decoder';
+
+decodeVinOrigin('WF0MXXGBWM8R43240');

package/dist/decode.d.ts

@@ -0,0 +1,2 @@
+import { VinOriginResult } from './types';
+export declare function decodeVinOrigin(vin: string): VinOriginResult;

package/dist/decode.js

@@ -0,0 +1,19 @@
+import { WMI_MAP } from './wmi-map';
+import { VIN_REGION_MAP } from './vin-region';
+export function decodeVinOrigin(vin) {
+    if (!vin || vin.length < 3) {
+        throw new Error('Invalid VIN supplied');
+    }
+    const normalizedVin = vin.toUpperCase();
+    const wmi = normalizedVin.substring(0, 3);
+    const region = VIN_REGION_MAP[normalizedVin[0]] ?? 'Unknown';
+    const knownWmi = WMI_MAP[wmi];
+    return {
+        vin: normalizedVin,
+        wmi,
+        manufacturer: knownWmi?.manufacturer ?? 'Unknown',
+        country: knownWmi?.country ?? 'Unknown',
+        region,
+        confidence: knownWmi ? 'high' : region !== 'Unknown' ? 'medium' : 'low',
+    };
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { decodeVinOrigin } from './decode';
+export type { VinOriginResult } from './types';

package/dist/index.js

@@ -0,0 +1,14 @@
+// export function decodeVinOrigin(vin: string) {
+//   if (!vin || vin.length < 3) {
+//     throw new Error('Invalid VIN');
+//   }
+//   const wmi = vin.substring(0, 3).toUpperCase();
+//   const data = WMI_MAP[wmi];
+//   return {
+//     vin,
+//     wmi,
+//     manufacturer: data?.manufacturer || 'Unknown',
+//     country: data?.country || 'Unknown',
+//   };
+// }
+export { decodeVinOrigin } from './decode';

package/dist/types.d.ts

@@ -0,0 +1,8 @@
+export interface VinOriginResult {
+    vin: string;
+    wmi: string;
+    manufacturer: string;
+    country: string;
+    region: string;
+    confidence: 'high' | 'medium' | 'low';
+}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/dist/vin-region.d.ts

@@ -0,0 +1 @@
+export declare const VIN_REGION_MAP: Record<string, string>;

package/dist/vin-region.js

@@ -0,0 +1,13 @@
+export const VIN_REGION_MAP = {
+    A: 'Africa', B: 'Africa', C: 'Africa', D: 'Africa',
+    E: 'Africa', F: 'Africa', G: 'Africa', H: 'Africa',
+    J: 'Asia', K: 'Asia', L: 'Asia', M: 'Asia',
+    N: 'Asia', P: 'Asia', R: 'Asia',
+    S: 'Europe', T: 'Europe', U: 'Europe', V: 'Europe',
+    W: 'Europe', X: 'Europe', Y: 'Europe', Z: 'Europe',
+    '1': 'North America', '4': 'North America', '5': 'North America',
+    '2': 'Canada',
+    '3': 'Mexico',
+    '6': 'Oceania', '7': 'Oceania',
+    '8': 'South America', '9': 'South America',
+};

package/dist/wmi-map.d.ts

@@ -0,0 +1,4 @@
+export declare const WMI_MAP: Record<string, {
+    manufacturer: string;
+    country: string;
+}>;

package/dist/wmi-map.js

@@ -0,0 +1,27 @@
+export const WMI_MAP = {
+    // Ford
+    WF0: { manufacturer: 'Ford', country: 'Germany' },
+    '1FA': { manufacturer: 'Ford', country: 'USA' }, // ← Quote this
+    '3FA': { manufacturer: 'Ford', country: 'Mexico' }, // ← Quote this
+    AFM: { manufacturer: 'Ford', country: 'South Africa' },
+    // BMW
+    WBA: { manufacturer: 'BMW', country: 'Germany' },
+    '5UX': { manufacturer: 'BMW', country: 'USA' }, // ← Quote this
+    // Mercedes-Benz
+    WDB: { manufacturer: 'Mercedes-Benz', country: 'Germany' },
+    WDC: { manufacturer: 'Mercedes-Benz', country: 'Germany' },
+    // Toyota
+    JT2: { manufacturer: 'Toyota', country: 'Japan' },
+    JTD: { manufacturer: 'Toyota', country: 'Japan' },
+    '4T1': { manufacturer: 'Toyota', country: 'USA' }, // ← Quote this
+    // Honda
+    JHM: { manufacturer: 'Honda', country: 'Japan' },
+    '1HG': { manufacturer: 'Honda', country: 'USA' }, // ← Quote this
+    // VW Group
+    WVW: { manufacturer: 'Volkswagen', country: 'Germany' },
+    WAU: { manufacturer: 'Audi', country: 'Germany' },
+    // Stellantis
+    ZFA: { manufacturer: 'Fiat', country: 'Italy' },
+    VF1: { manufacturer: 'Renault', country: 'France' },
+    SAL: { manufacturer: 'Land Rover', country: 'United Kingdom' },
+};

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "vin-origin-decoder",
+  "version": "1.0.0",
+  "description": "Decode vehicle origin and manufacturer from VIN",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "scripts": {
+    "build": "tsc"
+  },
+  "keywords": [
+    "vin",
+    "vehicle",
+    "car",
+    "decoder",
+    "origin"
+  ],
+  "author": "Ngoni Seremwe",
+  "license": "MIT",
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  }
+}

package/src/decode.ts

@@ -0,0 +1,24 @@
+import { WMI_MAP } from './wmi-map';
+import { VIN_REGION_MAP } from './vin-region';
+import { VinOriginResult } from './types';
+
+export function decodeVinOrigin(vin: string): VinOriginResult {
+  if (!vin || vin.length < 3) {
+    throw new Error('Invalid VIN supplied');
+  }
+
+  const normalizedVin = vin.toUpperCase();
+  const wmi = normalizedVin.substring(0, 3);
+  const region = VIN_REGION_MAP[normalizedVin[0]] ?? 'Unknown';
+
+  const knownWmi = WMI_MAP[wmi];
+
+  return {
+    vin: normalizedVin,
+    wmi,
+    manufacturer: knownWmi?.manufacturer ?? 'Unknown',
+    country: knownWmi?.country ?? 'Unknown',
+    region,
+    confidence: knownWmi ? 'high' : region !== 'Unknown' ? 'medium' : 'low',
+  };
+}

package/src/index.ts

@@ -0,0 +1,19 @@
+import { WMI_MAP } from './wmi-map';
+
+// export function decodeVinOrigin(vin: string) {
+//   if (!vin || vin.length < 3) {
+//     throw new Error('Invalid VIN');
+//   }
+
+//   const wmi = vin.substring(0, 3).toUpperCase();
+//   const data = WMI_MAP[wmi];
+
+//   return {
+//     vin,
+//     wmi,
+//     manufacturer: data?.manufacturer || 'Unknown',
+//     country: data?.country || 'Unknown',
+//   };
+// }
+export { decodeVinOrigin } from './decode';
+export type { VinOriginResult } from './types';

package/src/types.ts

@@ -0,0 +1,8 @@
+export interface VinOriginResult {
+  vin: string;
+  wmi: string;
+  manufacturer: string;
+  country: string;
+  region: string;
+  confidence: 'high' | 'medium' | 'low';
+}

package/src/vin-region.ts

@@ -0,0 +1,18 @@
+export const VIN_REGION_MAP: Record<string, string> = {
+  A: 'Africa', B: 'Africa', C: 'Africa', D: 'Africa',
+  E: 'Africa', F: 'Africa', G: 'Africa', H: 'Africa',
+
+  J: 'Asia', K: 'Asia', L: 'Asia', M: 'Asia',
+  N: 'Asia', P: 'Asia', R: 'Asia',
+
+  S: 'Europe', T: 'Europe', U: 'Europe', V: 'Europe',
+  W: 'Europe', X: 'Europe', Y: 'Europe', Z: 'Europe',
+
+  '1': 'North America', '4': 'North America', '5': 'North America',
+  '2': 'Canada',
+  '3': 'Mexico',
+
+  '6': 'Oceania', '7': 'Oceania',
+
+  '8': 'South America', '9': 'South America',
+};

package/src/wmi-map.ts

@@ -0,0 +1,36 @@
+export const WMI_MAP: Record<string, {
+  manufacturer: string;
+  country: string;
+}> = {
+  // Ford
+  WF0: { manufacturer: 'Ford', country: 'Germany' },
+  '1FA': { manufacturer: 'Ford', country: 'USA' },     // ← Quote this
+  '3FA': { manufacturer: 'Ford', country: 'Mexico' },   // ← Quote this
+  AFM: { manufacturer: 'Ford', country: 'South Africa' },
+
+  // BMW
+  WBA: { manufacturer: 'BMW', country: 'Germany' },
+  '5UX': { manufacturer: 'BMW', country: 'USA' },       // ← Quote this
+
+  // Mercedes-Benz
+  WDB: { manufacturer: 'Mercedes-Benz', country: 'Germany' },
+  WDC: { manufacturer: 'Mercedes-Benz', country: 'Germany' },
+
+  // Toyota
+  JT2: { manufacturer: 'Toyota', country: 'Japan' },
+  JTD: { manufacturer: 'Toyota', country: 'Japan' },
+  '4T1': { manufacturer: 'Toyota', country: 'USA' },    // ← Quote this
+
+  // Honda
+  JHM: { manufacturer: 'Honda', country: 'Japan' },
+  '1HG': { manufacturer: 'Honda', country: 'USA' },     // ← Quote this
+
+  // VW Group
+  WVW: { manufacturer: 'Volkswagen', country: 'Germany' },
+  WAU: { manufacturer: 'Audi', country: 'Germany' },
+
+  // Stellantis
+  ZFA: { manufacturer: 'Fiat', country: 'Italy' },
+  VF1: { manufacturer: 'Renault', country: 'France' },
+  SAL: { manufacturer: 'Land Rover', country: 'United Kingdom' },
+};

package/tsconfig.json

@@ -0,0 +1,12 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "ESNext",
+    "declaration": true,
+    "outDir": "dist",
+    "strict": true,
+    "moduleResolution": "node",
+    "esModuleInterop": true
+  },
+  "include": ["src"]
+}