chassi

Offline VIN decoder library.

Installation

npm install chassi

Usage

Library

import { decodeVin, validateVin } from "chassi";

decodeVin("WVWZZZ3CZWE123456");
// {
//   vin: 'WVWZZZ3CZWE123456',
//   valid: true,
//   manufacturer: 'Volkswagen',
//   country: 'Germany',
//   countryCode: 'DE',
//   year: 2014,
//   possibleYears: [1984, 2014],
//   model: 'Golf',
//   confidence: 1,
//   disclaimer: '...'
// }

validateVin("WVWZZZ3CZWE123456");
// {
//   valid: true,
//   vin: 'WVWZZZ3CZWE123456',
//   normalizedVin: 'WVWZZZ3CZWE123456',
//   errors: [],
//   details: {
//     lengthValid: true,
//     charactersValid: true,
//     checkDigitValid: true,
//     providedCheckDigit: 'Z',
//     calculatedCheckDigit: 'Z'
//   }
// }

CLI

npx chassi decode WVWZZZ3CZWE123456

# === VIN Decode Result ===
#
# VIN:          WVWZZZ3CZWE123456
# Valid:        Yes
# Manufacturer: Volkswagen
# Country:      Germany
# Year:         2014
# Model:        Golf
# Confidence:   100%
#
# Components:
#   WMI:        WVW
#   VDS:        ZZZ3CZ
#   VIS:        WE123456

npx chassi validate 5YJ3E1EA5LF123456

# === VIN Validation Result ===
#
# VIN:           5YJ3E1EA5LF123456
# Valid:         Yes
# Length:        Valid (17 characters)
# Characters:    Valid
# Check Digit:   Valid (5)

VIN Structure

| Position | Name | Description | | -------- | ----- | ----------------------------- | | 1-3 | WMI | World Manufacturer Identifier | | 4-9 | VDS | Vehicle Descriptor Section | | 9 | Check | Check digit (ISO 3779) | | 10 | Year | Model year code | | 11 | Plant | Assembly plant | | 12-17 | Seq | Sequential number |

Data Sources

Standards

| Standard | Description | | ----------------------------------------------------------------------------------- | ----------------------------- | | ISO 3779:2009 | VIN content and structure | | ISO 3780:2009 | WMI code assignment | | SAE J853 | VIN systems specification | | 49 CFR § 565 | U.S. federal VIN requirements |

Databases

| Source | Usage | | ------------------------------------------------- | --------------------------------- | | NHTSA vPIC | WMI validation, manufacturer data |

Notes

• WMI codes: Assigned by SAE International under ISO 3780
• Model patterns: Community-sourced from observed VINs (not official)
• Year codes: Defined by ISO 3779, cycle every 30 years

⚠️ Model inference is approximate. Always verify with official sources for critical applications.