@bisondesk/core-sdk 1.0.642 → 1.0.644

package/src/utils/vehicles.test.ts

@@ -3,8 +3,34 @@ import {
   convertLettersToNumber,
   convertNumberToLetters,
   getNextRelatedStockNumber,
+  isValidVin,
 } from './vehicles.js';
 
+describe('isValidVin', () => {
+  it('should accept valid VINs', () => {
+    expect(isValidVin('1M8GDM9AXKP042788')).toBe(true);
+    expect(isValidVin('5YJSA1DG9DFP14705')).toBe(true);
+    expect(isValidVin('WDB96340310876052')).toBe(true);
+    expect(isValidVin('XLRTE47MS0E756907')).toBe(true);
+  });
+
+  it('should reject strings that are not 17 characters', () => {
+    expect(isValidVin('1M8GDM9AXKP04278')).toBe(false);
+    expect(isValidVin('1M8GDM9AXKP0427889')).toBe(false);
+    expect(isValidVin('')).toBe(false);
+  });
+
+  it('should reject VINs with invalid characters (I, O, Q)', () => {
+    expect(isValidVin('1M8GDM9AXKPI42788')).toBe(false);
+    expect(isValidVin('1M8GDM9AXKPO42788')).toBe(false);
+    expect(isValidVin('1M8GDM9AXKPQ42788')).toBe(false);
+  });
+
+  it('should reject lowercase', () => {
+    expect(isValidVin('1m8gdm9axkp042788')).toBe(false);
+  });
+});
+
 describe('stock number utils', () => {
   describe('convertNumberToLetters', () => {
     it('should convert numbers to letters correctly', () => {

package/src/utils/vehicles.ts

@@ -190,6 +190,18 @@ export const getNextRelatedStockNumber = (stockNumber: string): string => {
   return `${baseStockNumber}${nextCounterLetters}`;
 };
 
+/**
+ * Canonical VIN shape: exactly 17 characters from the VIN alphabet — letters A–Z and
+ * digits 0–9, excluding I, O and Q. Unanchored so callers can wrap their own
+ * boundary/anchor policy when scanning free text (mirror of {@link buildStockNumberPattern}).
+ * Use {@link VIN_PATTERN} / {@link isValidVin} to validate a whole string.
+ */
+export const VIN_BODY_PATTERN = '[A-HJ-NPR-Z0-9]{17}';
+
+export const VIN_PATTERN = new RegExp(`^${VIN_BODY_PATTERN}$`);
+
+export const isValidVin = (vin: string): boolean => VIN_PATTERN.test(vin);
+
 export const getVehicleDescription = (
   external: VehicleExternalInfo,
   {