Tony Moon tonym
  • Joined on 2025-09-14

@otm/vin-decoder (0.1.0)

Published 2026-07-05 01:48:27 +00:00 by tonym

Installation

@otm:registry=
npm install @otm/vin-decoder@0.1.0
"@otm/vin-decoder": "0.1.0"

About this package

@otm/vin-decoder

The canonical shared VIN decoder for the OTM stack. Fuses seven free US-government APIs (NHTSA vPIC + Safety Ratings + Recalls + Complaints, EPA/DOE FuelEconomy.gov) into one EnrichedVin spec sheet. Zero runtime dependencies, zero API keys.

Published to the Gitea npm registry (@otm:registry in each consumer's .npmrc). Raw-TypeScript package (no build step) — consumers transpile it via Next's transpilePackages, exactly like @otm/account-panel.

Consumers (single source of truth — do NOT fork the logic back)

  • dmssrc/lib/integrations/vin.ts re-exports this package.
  • vin.poweredbyotm.comsrc/lib/vin.ts re-exports this package.

To change the decoder: edit here, bump the version, npm publish, then bump the dependency in both consumers.

API

import { decodeVinEnriched, type EnrichedVin } from "@otm/vin-decoder";

const decoded = await decodeVinEnriched("1HGCM82633A004352");
// null when vPIC can't resolve make/model; otherwise a fully-enriched record
// where every non-spine field degrades to null on its source's failure.

Publish

cd packages/vin-decoder
npm publish   # registry + auth resolved from publishConfig + .npmrc

Dependencies

Development Dependencies

ID Version
typescript 5.5.3
Details
npm
2026-07-05 01:48:27 +00:00
20
latest
5.1 KiB
Assets (1)
Versions (1) View all
0.1.0 2026-07-05