@indodev/toolkit 0.5.0 → 0.7.0

package/dist/vin/index.js

@@ -69,6 +69,68 @@ function validateVIN(vin) {
   return actualCheckDigit === expectedCheckDigit;
 }
 
-export { EXCLUDED_VIN_CHARS, VIN_CHAR_VALUES, VIN_CHECK_DIGIT_INDEX, VIN_CHECK_DIGIT_X, VIN_LENGTH, VIN_MODULUS, VIN_VERSION, VIN_WEIGHTS, validateVIN };
+// src/vin/errors.ts
+var InvalidVINError = class extends Error {
+  constructor(message = "Invalid VIN provided") {
+    super(message);
+    this.code = "INVALID_VIN";
+    this.name = "InvalidVINError";
+  }
+};
+
+// src/vin/parse.ts
+function parseVIN(vin) {
+  if (!vin || typeof vin !== "string") {
+    return null;
+  }
+  const normalizedVIN = vin.toUpperCase();
+  if (normalizedVIN.length !== VIN_LENGTH) {
+    return null;
+  }
+  for (const char of EXCLUDED_VIN_CHARS) {
+    if (normalizedVIN.includes(char)) {
+      return null;
+    }
+  }
+  for (const char of normalizedVIN) {
+    if (VIN_CHAR_VALUES[char] === void 0) {
+      return null;
+    }
+  }
+  const isValid = validateCheckDigit(normalizedVIN);
+  const wmi = normalizedVIN.substring(0, 3);
+  const vds = normalizedVIN.substring(3, 9);
+  const checkDigit = normalizedVIN[VIN_CHECK_DIGIT_INDEX];
+  const modelYearCode = normalizedVIN[9];
+  const plantCode = normalizedVIN[10];
+  const serialNumber = normalizedVIN.substring(11, 17);
+  return {
+    wmi,
+    vds,
+    checkDigit,
+    modelYearCode,
+    plantCode,
+    serialNumber,
+    isValid
+  };
+}
+function validateCheckDigit(vin) {
+  let sum = 0;
+  for (let i = 0; i < VIN_LENGTH; i++) {
+    const char = vin[i];
+    const weight = VIN_WEIGHTS[i];
+    const val = VIN_CHAR_VALUES[char];
+    if (val === void 0) {
+      return false;
+    }
+    sum += val * weight;
+  }
+  const checkDigitValue = sum % VIN_MODULUS;
+  const expectedCheckDigit = checkDigitValue === 10 ? VIN_CHECK_DIGIT_X : checkDigitValue.toString();
+  const actualCheckDigit = vin[VIN_CHECK_DIGIT_INDEX];
+  return actualCheckDigit === expectedCheckDigit;
+}
+
+export { EXCLUDED_VIN_CHARS, InvalidVINError, VIN_CHAR_VALUES, VIN_CHECK_DIGIT_INDEX, VIN_CHECK_DIGIT_X, VIN_LENGTH, VIN_MODULUS, VIN_VERSION, VIN_WEIGHTS, parseVIN, validateVIN };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/vin/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/vin/constants.ts","../../src/vin/validate.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * The standard length of a VIN (ISO 3779).\n */\nexport const VIN_LENGTH = 17;\n\n/**\n * The 0-based index of the check digit in the VIN (Position 9).\n */\nexport const VIN_CHECK_DIGIT_INDEX = 8;\n\n/**\n * The modulus used in the VIN checksum calculation.\n */\nexport const VIN_MODULUS = 11;\n\n/**\n * The character representing a checksum value of 10.\n */\nexport const VIN_CHECK_DIGIT_X = 'X';\n\n/**\n * Weights used in the VIN checksum calculation.\n * Each position (1-17) is multiplied by its corresponding weight.\n * Position 9 is the check digit itself (weight 0).\n */\nexport const VIN_WEIGHTS = [8, 7, 6, 5, 4, 3, 2, 10, 0, 9, 8, 7, 6, 5, 4, 3, 2];\n\n/**\n * Values assigned to each valid character for VIN calculation.\n * Invalid characters: I, O, Q are not allowed in VIN.\n */\nexport const VIN_CHAR_VALUES: Record<string, number> = {\n  '0': 0, '1': 1, '2': 2, '3': 3, '4': 4, '5': 5, '6': 6, '7': 7, '8': 8, '9': 9,\n  'A': 1, 'B': 2, 'C': 3, 'D': 4, 'E': 5, 'F': 6, 'G': 7, 'H': 8,\n  'J': 1, 'K': 2, 'L': 3, 'M': 4, 'N': 5, 'P': 7, 'R': 9,\n  'S': 2, 'T': 3, 'U': 4, 'V': 5, 'W': 6, 'X': 7, 'Y': 8, 'Z': 9,\n};\n\n/**\n * Characters excluded from VIN (I, O, Q).\n */\nexport const EXCLUDED_VIN_CHARS = ['I', 'O', 'Q'];\n\n/**\n * Version of the VIN utility module.\n */\nexport const VIN_VERSION = '1.0.0';\n\n","import {\n  VIN_WEIGHTS,\n  VIN_CHAR_VALUES,\n  EXCLUDED_VIN_CHARS,\n  VIN_LENGTH,\n  VIN_CHECK_DIGIT_INDEX,\n  VIN_MODULUS,\n  VIN_CHECK_DIGIT_X,\n} from './constants';\n\n/**\n * Validates a Vehicle Identification Number (VIN) based on ISO 3779.\n *\n * Checks for:\n * - Exactly 17 characters length.\n * - Exclusion of characters I, O, and Q.\n * - Checksum validation using the check digit at position 9.\n *\n * @param vin - The VIN string to validate\n * @returns boolean indicating if the VIN is valid\n *\n * @example\n * ```typescript\n * import { validateVIN } from '@indodev/toolkit/vin';\n *\n * validateVIN('1HBHA82L7ZB000001'); // true\n * validateVIN('1HBHA82I7ZB000001'); // false (contains 'I')\n * ```\n */\nexport function validateVIN(vin: string): boolean {\n  if (!vin || vin.length !== VIN_LENGTH) {\n    return false;\n  }\n\n  const normalizedVIN = vin.toUpperCase();\n\n  // 1. Check for excluded characters (I, O, Q)\n  for (const char of EXCLUDED_VIN_CHARS) {\n    if (normalizedVIN.includes(char)) {\n      return false;\n    }\n  }\n\n  // 2. Checksum validation (Position 9)\n  let sum = 0;\n  for (let i = 0; i < VIN_LENGTH; i++) {\n    const char = normalizedVIN[i];\n    const weight = VIN_WEIGHTS[i];\n    const val = VIN_CHAR_VALUES[char];\n\n    if (val === undefined) {\n      return false; // Invalid character found\n    }\n\n    sum += val * weight;\n  }\n\n  const checkDigitValue = sum % VIN_MODULUS;\n  const expectedCheckDigit =\n    checkDigitValue === 10 ? VIN_CHECK_DIGIT_X : checkDigitValue.toString();\n  const actualCheckDigit = normalizedVIN[VIN_CHECK_DIGIT_INDEX];\n\n  return actualCheckDigit === expectedCheckDigit;\n}\n"]}
+{"version":3,"sources":["../../src/vin/constants.ts","../../src/vin/validate.ts","../../src/vin/errors.ts","../../src/vin/parse.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * The standard length of a VIN (ISO 3779).\n */\nexport const VIN_LENGTH = 17;\n\n/**\n * The 0-based index of the check digit in the VIN (Position 9).\n */\nexport const VIN_CHECK_DIGIT_INDEX = 8;\n\n/**\n * The modulus used in the VIN checksum calculation.\n */\nexport const VIN_MODULUS = 11;\n\n/**\n * The character representing a checksum value of 10.\n */\nexport const VIN_CHECK_DIGIT_X = 'X';\n\n/**\n * Weights used in the VIN checksum calculation.\n * Each position (1-17) is multiplied by its corresponding weight.\n * Position 9 is the check digit itself (weight 0).\n */\nexport const VIN_WEIGHTS = [8, 7, 6, 5, 4, 3, 2, 10, 0, 9, 8, 7, 6, 5, 4, 3, 2];\n\n/**\n * Values assigned to each valid character for VIN calculation.\n * Invalid characters: I, O, Q are not allowed in VIN.\n */\nexport const VIN_CHAR_VALUES: Record<string, number> = {\n  '0': 0, '1': 1, '2': 2, '3': 3, '4': 4, '5': 5, '6': 6, '7': 7, '8': 8, '9': 9,\n  'A': 1, 'B': 2, 'C': 3, 'D': 4, 'E': 5, 'F': 6, 'G': 7, 'H': 8,\n  'J': 1, 'K': 2, 'L': 3, 'M': 4, 'N': 5, 'P': 7, 'R': 9,\n  'S': 2, 'T': 3, 'U': 4, 'V': 5, 'W': 6, 'X': 7, 'Y': 8, 'Z': 9,\n};\n\n/**\n * Characters excluded from VIN (I, O, Q).\n */\nexport const EXCLUDED_VIN_CHARS = ['I', 'O', 'Q'];\n\n/**\n * Version of the VIN utility module.\n */\nexport const VIN_VERSION = '1.0.0';\n\n","import {\n  VIN_WEIGHTS,\n  VIN_CHAR_VALUES,\n  EXCLUDED_VIN_CHARS,\n  VIN_LENGTH,\n  VIN_CHECK_DIGIT_INDEX,\n  VIN_MODULUS,\n  VIN_CHECK_DIGIT_X,\n} from './constants';\n\n/**\n * Validates a Vehicle Identification Number (VIN) based on ISO 3779.\n *\n * Checks for:\n * - Exactly 17 characters length.\n * - Exclusion of characters I, O, and Q.\n * - Checksum validation using the check digit at position 9.\n *\n * @param vin - The VIN string to validate\n * @returns boolean indicating if the VIN is valid\n *\n * @example\n * ```typescript\n * import { validateVIN } from '@indodev/toolkit/vin';\n *\n * validateVIN('1HBHA82L7ZB000001'); // true\n * validateVIN('1HBHA82I7ZB000001'); // false (contains 'I')\n * ```\n */\nexport function validateVIN(vin: string): boolean {\n  if (!vin || vin.length !== VIN_LENGTH) {\n    return false;\n  }\n\n  const normalizedVIN = vin.toUpperCase();\n\n  // 1. Check for excluded characters (I, O, Q)\n  for (const char of EXCLUDED_VIN_CHARS) {\n    if (normalizedVIN.includes(char)) {\n      return false;\n    }\n  }\n\n  // 2. Checksum validation (Position 9)\n  let sum = 0;\n  for (let i = 0; i < VIN_LENGTH; i++) {\n    const char = normalizedVIN[i];\n    const weight = VIN_WEIGHTS[i];\n    const val = VIN_CHAR_VALUES[char];\n\n    if (val === undefined) {\n      return false; // Invalid character found\n    }\n\n    sum += val * weight;\n  }\n\n  const checkDigitValue = sum % VIN_MODULUS;\n  const expectedCheckDigit =\n    checkDigitValue === 10 ? VIN_CHECK_DIGIT_X : checkDigitValue.toString();\n  const actualCheckDigit = normalizedVIN[VIN_CHECK_DIGIT_INDEX];\n\n  return actualCheckDigit === expectedCheckDigit;\n}\n","/**\n * Error thrown when an invalid VIN is provided to a function.\n * Extends native Error with a `code` property for programmatic error handling.\n *\n * @example\n * ```typescript\n * try {\n *   requireVIN('invalid');\n * } catch (error) {\n *   if (error instanceof InvalidVINError) {\n *     console.log(error.code); // 'INVALID_VIN'\n *   }\n * }\n * ```\n *\n * @public\n */\nexport class InvalidVINError extends Error {\n  readonly code = 'INVALID_VIN' as const;\n\n  constructor(message: string = 'Invalid VIN provided') {\n    super(message);\n    this.name = 'InvalidVINError';\n  }\n}\n","import {\n  VIN_LENGTH,\n  VIN_CHAR_VALUES,\n  EXCLUDED_VIN_CHARS,\n  VIN_WEIGHTS,\n  VIN_CHECK_DIGIT_INDEX,\n  VIN_MODULUS,\n  VIN_CHECK_DIGIT_X,\n} from './constants';\nimport type { VINInfo } from './types';\n\n/**\n * Parses a Vehicle Identification Number (VIN) into its component parts.\n *\n * Extracts the WMI (World Manufacturer Identifier), VDS (Vehicle Descriptor Section),\n * check digit, model year code, plant code, and serial number from a VIN.\n *\n * @param vin - The VIN string to parse\n * @returns VINInfo object with extracted components, or null if invalid\n *\n * @example\n * Valid VIN:\n * ```typescript\n * parseVIN('1HBHA82L7ZB000001');\n * // {\n * //   wmi: '1HB',\n * //   vds: 'HA82L7',\n * //   checkDigit: '7',\n * //   modelYearCode: 'Z',\n * //   plantCode: 'B',\n * //   serialNumber: '0000001',\n * //   isValid: true\n * // }\n * ```\n *\n * @example\n * Invalid VIN returns null:\n * ```typescript\n * parseVIN('invalid');\n * // null\n * ```\n *\n * @public\n */\nexport function parseVIN(vin: string): VINInfo | null {\n  if (!vin || typeof vin !== 'string') {\n    return null;\n  }\n\n  const normalizedVIN = vin.toUpperCase();\n\n  if (normalizedVIN.length !== VIN_LENGTH) {\n    return null;\n  }\n\n  for (const char of EXCLUDED_VIN_CHARS) {\n    if (normalizedVIN.includes(char)) {\n      return null;\n    }\n  }\n\n  for (const char of normalizedVIN) {\n    if (VIN_CHAR_VALUES[char] === undefined) {\n      return null;\n    }\n  }\n\n  const isValid = validateCheckDigit(normalizedVIN);\n\n  const wmi = normalizedVIN.substring(0, 3);\n  const vds = normalizedVIN.substring(3, 9);\n  const checkDigit = normalizedVIN[VIN_CHECK_DIGIT_INDEX];\n  const modelYearCode = normalizedVIN[9];\n  const plantCode = normalizedVIN[10];\n  const serialNumber = normalizedVIN.substring(11, 17);\n\n  return {\n    wmi,\n    vds,\n    checkDigit,\n    modelYearCode,\n    plantCode,\n    serialNumber,\n    isValid,\n  };\n}\n\n/**\n * Validates the check digit of a VIN.\n *\n * @internal\n */\nfunction validateCheckDigit(vin: string): boolean {\n  let sum = 0;\n  for (let i = 0; i < VIN_LENGTH; i++) {\n    const char = vin[i];\n    const weight = VIN_WEIGHTS[i];\n    const val = VIN_CHAR_VALUES[char];\n\n    if (val === undefined) {\n      return false;\n    }\n\n    sum += val * weight;\n  }\n\n  const checkDigitValue = sum % VIN_MODULUS;\n  const expectedCheckDigit =\n    checkDigitValue === 10 ? VIN_CHECK_DIGIT_X : checkDigitValue.toString();\n  const actualCheckDigit = vin[VIN_CHECK_DIGIT_INDEX];\n\n  return actualCheckDigit === expectedCheckDigit;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indodev/toolkit",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "Indonesian developer utilities for validation, formatting, and more",
   "type": "module",
   "main": "./dist/index.cjs",

package/dist/types-i5e6R0AS.d.cts

@@ -1,39 +0,0 @@
-/**
- * Validates a Vehicle Identification Number (VIN) based on ISO 3779.
- *
- * Checks for:
- * - Exactly 17 characters length.
- * - Exclusion of characters I, O, and Q.
- * - Checksum validation using the check digit at position 9.
- *
- * @param vin - The VIN string to validate
- * @returns boolean indicating if the VIN is valid
- *
- * @example
- * ```typescript
- * import { validateVIN } from '@indodev/toolkit/vin';
- *
- * validateVIN('1HBHA82L7ZB000001'); // true
- * validateVIN('1HBHA82I7ZB000001'); // false (contains 'I')
- * ```
- */
-declare function validateVIN(vin: string): boolean;
-
-/**
- * VIN Validation options.
- */
-interface VINOptions {
-    /**
-     * Whether to include error messages in the validation result.
-     */
-    includeDetails?: boolean;
-}
-/**
- * Detailed validation result.
- */
-interface VINValidationResult {
-    isValid: boolean;
-    error?: string;
-}
-
-export { type VINOptions as V, type VINValidationResult as a, validateVIN as v };

package/dist/types-i5e6R0AS.d.ts

@@ -1,39 +0,0 @@
-/**
- * Validates a Vehicle Identification Number (VIN) based on ISO 3779.
- *
- * Checks for:
- * - Exactly 17 characters length.
- * - Exclusion of characters I, O, and Q.
- * - Checksum validation using the check digit at position 9.
- *
- * @param vin - The VIN string to validate
- * @returns boolean indicating if the VIN is valid
- *
- * @example
- * ```typescript
- * import { validateVIN } from '@indodev/toolkit/vin';
- *
- * validateVIN('1HBHA82L7ZB000001'); // true
- * validateVIN('1HBHA82I7ZB000001'); // false (contains 'I')
- * ```
- */
-declare function validateVIN(vin: string): boolean;
-
-/**
- * VIN Validation options.
- */
-interface VINOptions {
-    /**
-     * Whether to include error messages in the validation result.
-     */
-    includeDetails?: boolean;
-}
-/**
- * Detailed validation result.
- */
-interface VINValidationResult {
-    isValid: boolean;
-    error?: string;
-}
-
-export { type VINOptions as V, type VINValidationResult as a, validateVIN as v };

package/dist/utils-DDVlOusI.d.cts

@@ -1,30 +0,0 @@
-/**
- * Validates an Indonesian license plate number format.
- * Format: [1-2 letters] [1-4 digits] [1-3 letters]
- *
- * @param plate - The plate number string to validate
- * @returns `true` if valid, `false` otherwise
- *
- * @example
- * ```typescript
- * validatePlate('B 1234 ABC'); // true
- * validatePlate('AB 1 CD'); // true
- * ```
- */
-declare function validatePlate(plate: string): boolean;
-/**
- * Gets the region name from a license plate number.
- *
- * @param plate - The plate number
- * @returns Region name or null if not found
- */
-declare function getRegionFromPlate(plate: string): string | null;
-/**
- * Formats a license plate number with spaces (e.g., B 1234 ABC).
- *
- * @param plate - The plate number
- * @returns Formatted plate string
- */
-declare function formatPlate(plate: string): string;
-
-export { formatPlate as f, getRegionFromPlate as g, validatePlate as v };

package/dist/utils-DDVlOusI.d.ts

@@ -1,30 +0,0 @@
-/**
- * Validates an Indonesian license plate number format.
- * Format: [1-2 letters] [1-4 digits] [1-3 letters]
- *
- * @param plate - The plate number string to validate
- * @returns `true` if valid, `false` otherwise
- *
- * @example
- * ```typescript
- * validatePlate('B 1234 ABC'); // true
- * validatePlate('AB 1 CD'); // true
- * ```
- */
-declare function validatePlate(plate: string): boolean;
-/**
- * Gets the region name from a license plate number.
- *
- * @param plate - The plate number
- * @returns Region name or null if not found
- */
-declare function getRegionFromPlate(plate: string): string | null;
-/**
- * Formats a license plate number with spaces (e.g., B 1234 ABC).
- *
- * @param plate - The plate number
- * @returns Formatted plate string
- */
-declare function formatPlate(plate: string): string;
-
-export { formatPlate as f, getRegionFromPlate as g, validatePlate as v };