@meterapp/vehicle-db 2.2.0 → 2.4.0

package/dist/index.d.ts

@@ -2,6 +2,21 @@ export interface VehicleType {
     vehicleTypeId: number;
     vehicleTypeName: string;
 }
+export interface DataSource {
+    sourceId: string;
+    sourceName: string;
+    sourceUrl: string;
+    license: string;
+    licenseUrl?: string;
+    region: string;
+    description: string;
+    retrievedAt: string;
+    vehicleTypeIds: number[];
+    yearFrom: number;
+    yearTo: number;
+    makeCount: number;
+    modelCount: number;
+}
 export interface Make {
     makeId: number;
     makeName: string;
@@ -13,20 +28,27 @@ export interface Model {
     makeName: string;
     vehicleTypeId: number;
     vehicleTypeName: string;
+    sourceIds: string[];
 }
 export interface GetMakesOptions {
     year?: number;
     vehicleTypeId?: number;
+    sourceId?: string;
 }
 export interface GetModelsOptions {
     year?: number;
     vehicleTypeId?: number;
     makeId?: number;
+    sourceId?: string;
 }
 /**
  * Returns all vehicle types in the database.
  */
 export declare function getVehicleTypes(): VehicleType[];
+/**
+ * Returns provenance and coverage metadata for every bundled source.
+ */
+export declare function getDataSources(): DataSource[];
 /**
  * Returns makes, optionally filtered by year and/or vehicle type.
  */

package/dist/index.js

@@ -4,6 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getVehicleTypes = getVehicleTypes;
+exports.getDataSources = getDataSources;
 exports.getMakes = getMakes;
 exports.getModels = getModels;
 exports.getAvailableYears = getAvailableYears;
@@ -13,6 +14,7 @@ const data_1 = __importDefault(require("./data"));
 // ---------------------------------------------------------------------------
 let _makeMap = null;
 let _typeMap = null;
+let _sourceMaskMap = null;
 function getMakeMap() {
     if (!_makeMap) {
         _makeMap = new Map(data_1.default.makes.map((m) => [m.make_id, m.make_name]));
@@ -25,6 +27,20 @@ function getTypeMap() {
     }
     return _typeMap;
 }
+function getSourceMaskMap() {
+    if (!_sourceMaskMap) {
+        _sourceMaskMap = new Map(data_1.default.sources.map((source, index) => [source.source_id, 2 ** index]));
+    }
+    return _sourceMaskMap;
+}
+function getSourceIds(sourceMask) {
+    const sourceIds = [];
+    for (let index = 0; index < data_1.default.sources.length; index++) {
+        if ((sourceMask & 2 ** index) !== 0)
+            sourceIds.push(data_1.default.sources[index].source_id);
+    }
+    return sourceIds;
+}
 // ---------------------------------------------------------------------------
 // Public API
 // ---------------------------------------------------------------------------
@@ -37,26 +53,51 @@ function getVehicleTypes() {
         vehicleTypeName: t.vehicle_type_name,
     }));
 }
+/**
+ * Returns provenance and coverage metadata for every bundled source.
+ */
+function getDataSources() {
+    return data_1.default.sources.map((source) => ({
+        sourceId: source.source_id,
+        sourceName: source.source_name,
+        sourceUrl: source.source_url,
+        license: source.license,
+        ...(source.license_url ? { licenseUrl: source.license_url } : {}),
+        region: source.region,
+        description: source.description,
+        retrievedAt: source.retrieved_at,
+        vehicleTypeIds: [...source.vehicle_type_ids],
+        yearFrom: source.year_from,
+        yearTo: source.year_to,
+        makeCount: source.make_count,
+        modelCount: source.model_count,
+    }));
+}
 /**
  * Returns makes, optionally filtered by year and/or vehicle type.
  */
 function getMakes(options = {}) {
-    const { year, vehicleTypeId } = options;
-    if (year == null && vehicleTypeId == null) {
+    const { year, vehicleTypeId, sourceId } = options;
+    if (year == null && vehicleTypeId == null && sourceId == null) {
         return data_1.default.makes.map((m) => ({ makeId: m.make_id, makeName: m.make_name }));
     }
+    const sourceMask = sourceId == null ? undefined : getSourceMaskMap().get(sourceId);
+    if (sourceId != null && sourceMask == null)
+        return [];
     const makeIds = new Set();
     for (const m of data_1.default.models) {
         if (year != null && m[0] !== year)
             continue;
         if (vehicleTypeId != null && m[4] !== vehicleTypeId)
             continue;
+        if (sourceMask != null && (m[5] & sourceMask) === 0)
+            continue;
         makeIds.add(m[1]);
     }
     const makeMap = getMakeMap();
     return [...makeIds]
         .map((id) => ({ makeId: id, makeName: makeMap.get(id) }))
-        .sort((a, b) => (a.makeName >= b.makeName ? 1 : -1));
+        .sort((a, b) => (a.makeName < b.makeName ? -1 : a.makeName > b.makeName ? 1 : 0));
 }
 /**
  * Returns models, optionally filtered by year, vehicle type, and/or make.
@@ -64,7 +105,10 @@ function getMakes(options = {}) {
 function getModels(options = {}) {
     const makeMap = getMakeMap();
     const typeMap = getTypeMap();
-    const { year, vehicleTypeId, makeId } = options;
+    const { year, vehicleTypeId, makeId, sourceId } = options;
+    const sourceMask = sourceId == null ? undefined : getSourceMaskMap().get(sourceId);
+    if (sourceId != null && sourceMask == null)
+        return [];
     const results = [];
     for (const m of data_1.default.models) {
         if (year != null && m[0] !== year)
@@ -73,6 +117,8 @@ function getModels(options = {}) {
             continue;
         if (vehicleTypeId != null && m[4] !== vehicleTypeId)
             continue;
+        if (sourceMask != null && (m[5] & sourceMask) === 0)
+            continue;
         results.push({
             modelId: m[2],
             modelName: data_1.default.modelNames[m[3]],
@@ -80,9 +126,11 @@ function getModels(options = {}) {
             makeName: makeMap.get(m[1]),
             vehicleTypeId: m[4],
             vehicleTypeName: typeMap.get(m[4]),
+            sourceIds: getSourceIds(m[5]),
         });
     }
-    return results.sort((a, b) => (a.modelName >= b.modelName ? 1 : -1));
+    return results.sort((a, b) => (a.modelName < b.modelName ? -1 : a.modelName > b.modelName ? 1 : 0) ||
+        a.vehicleTypeId - b.vehicleTypeId);
 }
 /**
  * Get all available years in the database.

package/package.json

@@ -1,35 +1,48 @@
 {
   "name": "@meterapp/vehicle-db",
-  "version": "2.2.0",
-  "description": "Offline NHTSA vehicle makes/models database — zero dependencies",
+  "version": "2.4.0",
+  "description": "Offline international vehicle makes/models database — zero dependencies",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MeterApp/vehicle-db.git"
+  },
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [
     "dist"
   ],
   "scripts": {
-    "build:db": "tsx scripts/build-db.ts",
+    "build:db": "npm run build:data",
+    "build:data": "tsx scripts/build-db.ts",
+    "refresh:nhtsa": "tsx scripts/import-nhtsa.ts",
+    "refresh:uk-dft": "tsx scripts/import-uk-dft.ts",
     "build:ts": "tsc",
     "build": "npm run build:ts",
+    "typecheck": "tsc --noEmit && tsc -p tsconfig.scripts.json",
     "prepublishOnly": "npm run build",
     "test": "vitest run"
   },
   "keywords": [
     "nhtsa",
+    "dvla",
     "vehicles",
     "makes",
     "models",
+    "motorcycles",
+    "buses",
+    "international",
     "offline"
   ],
   "author": "",
   "license": "ISC",
   "type": "commonjs",
+  "engines": {
+    "node": ">=18"
+  },
   "devDependencies": {
-    "@types/better-sqlite3": "^7.6.13",
-    "@types/node": "^25.4.0",
-    "better-sqlite3": "^12.6.2",
-    "tsx": "^4.21.0",
+    "@types/node": "^25.9.5",
+    "tsx": "^4.23.12",
     "typescript": "^5.9.3",
-    "vitest": "^4.0.18"
+    "vitest": "^4.1.11"
   }
 }