isahaq-barcode 1.8.0 → 2.0.0

package/src/validators/Validator.js

@@ -1,5 +1,10 @@
 /**
  * Validator - Data validation for different barcode types
+ *
+ * Validation is intentionally a superset check: it catches the mistakes that
+ * produce confusing encoder errors (wrong length, wrong charset, bad check
+ * digit). Symbology specific rules that only the encoder knows are surfaced by
+ * the encoder itself.
  */
 
 const { BarcodeTypes } = require('../types/BarcodeTypes');
@@ -7,24 +12,21 @@ const { BarcodeTypes } = require('../types/BarcodeTypes');
 class Validator {
   constructor() {
     this.patterns = {
-      // Numeric patterns
       numeric: /^[0-9]+$/,
-      // Alphanumeric patterns
       alphanumeric: /^[A-Za-z0-9]+$/,
-      // Code 39 pattern
-      code39: /^[A-Z0-9\s\-\.\$\/\+\%]+$/,
-      // Code 39 extended pattern
+      code39: /^[A-Z0-9\s\-.$/+%]+$/,
       code39extended: /^[\x00-\x7F]+$/,
-      // EAN/UPC patterns
+      codabar: /^[A-Da-d][0-9\-$:/.+]*[A-Da-d]$/,
+      code11: /^[0-9-]+$/,
       ean13: /^[0-9]{12,13}$/,
       ean8: /^[0-9]{7,8}$/,
+      ean2: /^[0-9]{2}$/,
+      ean5: /^[0-9]{5}$/,
       upca: /^[0-9]{11,12}$/,
-      upce: /^[0-9]{6,8}$/,
-      // QR Code pattern (supports Unicode)
+      upce: /^[0-9]{7,8}$/,
+      itf14: /^[0-9]{13,14}$/,
       qrcode: /^[\s\S]+$/,
-      // Data Matrix pattern
       datamatrix: /^[\s\S]+$/,
-      // PDF417 pattern
       pdf417: /^[\s\S]+$/,
     };
   }
@@ -50,10 +52,8 @@ class Validator {
       };
     }
 
-    // Get configuration for the barcode type
     const config = BarcodeTypes.getConfig(type);
 
-    // Check length constraints
     if (data.length < config.minLength) {
       return {
         valid: false,
@@ -68,7 +68,6 @@ class Validator {
       };
     }
 
-    // Type-specific validation
     const validationResult = this.validateByType(data, type);
     if (!validationResult.valid) {
       return validationResult;
@@ -94,42 +93,91 @@ class Validator {
       case 'code128':
       case 'code128a':
       case 'code128b':
-      case 'code128c':
       case 'code128auto':
-        return this.validateCode128(data, type);
+        return this.validateCode128(data);
+
+      case 'code128c':
+        return this.requireNumeric(data, 'Code 128 Subset C');
 
       case 'code39':
-      case 'code39extended':
       case 'code39checksum':
       case 'code39auto':
         return this.validateCode39(data, type);
 
+      case 'code39extended':
+        return this.validateCode39(data, type);
+
       case 'code93':
         return this.validateCode93(data);
 
+      case 'code25':
+      case 'code25auto':
+      case 'standard25':
+      case 'standard25checksum':
+      case 'interleaved25':
+      case 'interleaved25checksum':
+      case 'interleaved25auto':
+      case 'msi':
+      case 'msichecksum':
+      case 'msiauto':
+      case 'code32':
+      case 'postnet':
+      case 'planet':
+      case 'imb':
+      case 'pharmacode':
+      case 'pharmacodetwotracks':
+        return this.requireNumeric(data, BarcodeTypes.getTypeInfo(type).name);
+
       case 'ean13':
-        return this.validateEAN13(data);
+        return this.validateEAN(data, 13, 'EAN-13');
 
       case 'ean8':
-        return this.validateEAN8(data);
+        return this.validateEAN(data, 8, 'EAN-8');
+
+      case 'ean2':
+        return this.validatePattern(data, 'ean2', 'EAN-2 must be 2 digits');
+
+      case 'ean5':
+        return this.validatePattern(data, 'ean5', 'EAN-5 must be 5 digits');
 
       case 'upca':
-        return this.validateUPCA(data);
+        return this.validateEAN(data, 12, 'UPC-A');
 
       case 'upce':
-        return this.validateUPCE(data);
+        return this.validatePattern(
+          data,
+          'upce',
+          'UPC-E must be 7 or 8 digits'
+        );
+
+      case 'itf14':
+        return this.validateEAN(data, 14, 'ITF-14');
+
+      case 'codabar':
+        return this.validatePattern(
+          data,
+          'codabar',
+          'Codabar must start and end with A, B, C or D and contain 0-9 -$:/.+'
+        );
+
+      case 'code11':
+        return this.validatePattern(
+          data,
+          'code11',
+          'Code 11 supports digits and the - character only'
+        );
 
       case 'qrcode':
-        return this.validateQRCode(data);
-
       case 'datamatrix':
-        return this.validateDataMatrix(data);
-
+      case 'aztec':
       case 'pdf417':
-        return this.validatePDF417(data);
+      case 'microqr':
+      case 'maxicode':
+      case 'code16k':
+      case 'code49':
+        return { valid: true };
 
       default:
-        // For other types, just check if data is not empty
         return {
           valid: data.length > 0,
           error: data.length === 0 ? 'Data cannot be empty' : null,
@@ -140,11 +188,9 @@ class Validator {
   /**
    * Validate Code 128 data
    * @param {string} data - The data to validate
-   * @param {string} type - The Code 128 variant
    * @returns {Object} Validation result
    */
   validateCode128(data) {
-    // Code 128 supports ASCII characters
     if (!/^[\x00-\x7F]+$/.test(data)) {
       return {
         valid: false,
@@ -163,21 +209,21 @@ class Validator {
    */
   validateCode39(data, type) {
     if (type === 'code39extended') {
-      // Extended Code 39 supports full ASCII
-      if (!/^[\x00-\x7F]+$/.test(data)) {
+      if (!this.patterns.code39extended.test(data)) {
         return {
           valid: false,
           error: 'Extended Code 39 supports ASCII characters only',
         };
       }
-    } else {
-      // Standard Code 39 supports limited character set
-      if (!this.patterns.code39.test(data)) {
-        return {
-          valid: false,
-          error: 'Code 39 supports characters: A-Z, 0-9, space, -.$/+%',
-        };
-      }
+
+      return { valid: true };
+    }
+
+    if (!this.patterns.code39.test(data)) {
+      return {
+        valid: false,
+        error: 'Code 39 supports characters: A-Z, 0-9, space, -.$/+%',
+      };
     }
 
     return { valid: true };
@@ -189,10 +235,10 @@ class Validator {
    * @returns {Object} Validation result
    */
   validateCode93(data) {
-    if (!this.patterns.alphanumeric.test(data)) {
+    if (!/^[A-Z0-9\s\-.$/+%]+$/.test(data)) {
       return {
         valid: false,
-        error: 'Code 93 supports alphanumeric characters only',
+        error: 'Code 93 supports characters: A-Z, 0-9, space, -.$/+%',
       };
     }
 
@@ -200,52 +246,33 @@ class Validator {
   }
 
   /**
-   * Validate EAN-13 data
+   * Validate an EAN/UPC style code, including its check digit when supplied
    * @param {string} data - The data to validate
+   * @param {number} fullLength - Length of the code including the check digit
+   * @param {string} label - Human readable symbology name
    * @returns {Object} Validation result
    */
-  validateEAN13(data) {
-    if (!this.patterns.ean13.test(data)) {
+  validateEAN(data, fullLength, label) {
+    if (!this.patterns.numeric.test(data)) {
       return {
         valid: false,
-        error: 'EAN-13 must be 12 or 13 digits',
+        error: `${label} supports digits only`,
       };
     }
 
-    // Validate check digit if 13 digits provided
-    if (data.length === 13) {
-      const checkDigit = this.calculateEANCheckDigit(data.substring(0, 12));
-      if (parseInt(data[12]) !== checkDigit) {
-        return {
-          valid: false,
-          error: 'Invalid EAN-13 check digit',
-        };
-      }
-    }
-
-    return { valid: true };
-  }
-
-  /**
-   * Validate EAN-8 data
-   * @param {string} data - The data to validate
-   * @returns {Object} Validation result
-   */
-  validateEAN8(data) {
-    if (!this.patterns.ean8.test(data)) {
+    if (data.length !== fullLength && data.length !== fullLength - 1) {
       return {
         valid: false,
-        error: 'EAN-8 must be 7 or 8 digits',
+        error: `${label} must be ${fullLength - 1} or ${fullLength} digits`,
       };
     }
 
-    // Validate check digit if 8 digits provided
-    if (data.length === 8) {
-      const checkDigit = this.calculateEANCheckDigit(data.substring(0, 7));
-      if (parseInt(data[7]) !== checkDigit) {
+    if (data.length === fullLength) {
+      const expected = this.calculateEANCheckDigit(data.slice(0, -1));
+      if (Number(data[data.length - 1]) !== expected) {
         return {
           valid: false,
-          error: 'Invalid EAN-8 check digit',
+          error: `Invalid ${label} check digit (expected ${expected})`,
         };
       }
     }
@@ -254,31 +281,31 @@ class Validator {
   }
 
   /**
-   * Validate UPC-A data
+   * Validate data against one of the configured patterns
    * @param {string} data - The data to validate
+   * @param {string} pattern - Pattern name
+   * @param {string} error - Error message used when the pattern does not match
    * @returns {Object} Validation result
    */
-  validateUPCA(data) {
-    if (!this.patterns.upca.test(data)) {
-      return {
-        valid: false,
-        error: 'UPC-A must be 11 or 12 digits',
-      };
+  validatePattern(data, pattern, error) {
+    if (!this.patterns[pattern].test(data)) {
+      return { valid: false, error };
     }
 
     return { valid: true };
   }
 
   /**
-   * Validate UPC-E data
+   * Require numeric data
    * @param {string} data - The data to validate
+   * @param {string} label - Human readable symbology name
    * @returns {Object} Validation result
    */
-  validateUPCE(data) {
-    if (!this.patterns.upce.test(data)) {
+  requireNumeric(data, label) {
+    if (!this.patterns.numeric.test(data)) {
       return {
         valid: false,
-        error: 'UPC-E must be 6 to 8 digits',
+        error: `${label} supports digits only`,
       };
     }
 
@@ -286,66 +313,57 @@ class Validator {
   }
 
   /**
-   * Validate QR Code data
-   * @param {string} data - The data to validate
-   * @returns {Object} Validation result
+   * Calculate the mod-10 check digit used by EAN, UPC and ITF codes.
+   * Weights alternate 3 and 1 starting from the rightmost payload digit.
+   * @param {string} data - The payload without its check digit
+   * @returns {number} Check digit
    */
-  validateQRCode(data) {
-    // QR Code supports Unicode, so we just check if it's not empty
-    if (data.length === 0) {
-      return {
-        valid: false,
-        error: 'QR Code data cannot be empty',
-      };
+  calculateEANCheckDigit(data) {
+    let sum = 0;
+
+    for (let i = 0; i < data.length; i++) {
+      const digit = parseInt(data[i], 10);
+      const weight = (data.length - 1 - i) % 2 === 0 ? 3 : 1;
+      sum += digit * weight;
     }
 
-    return { valid: true };
+    return (10 - (sum % 10)) % 10;
   }
 
   /**
-   * Validate Data Matrix data
+   * Validate EAN-13 data
    * @param {string} data - The data to validate
    * @returns {Object} Validation result
    */
-  validateDataMatrix(data) {
-    if (data.length === 0) {
-      return {
-        valid: false,
-        error: 'Data Matrix data cannot be empty',
-      };
-    }
-
-    return { valid: true };
+  validateEAN13(data) {
+    return this.validateEAN(data, 13, 'EAN-13');
   }
 
   /**
-   * Validate PDF417 data
+   * Validate EAN-8 data
    * @param {string} data - The data to validate
    * @returns {Object} Validation result
    */
-  validatePDF417(data) {
-    if (data.length === 0) {
-      return {
-        valid: false,
-        error: 'PDF417 data cannot be empty',
-      };
-    }
+  validateEAN8(data) {
+    return this.validateEAN(data, 8, 'EAN-8');
+  }
 
-    return { valid: true };
+  /**
+   * Validate UPC-A data
+   * @param {string} data - The data to validate
+   * @returns {Object} Validation result
+   */
+  validateUPCA(data) {
+    return this.validateEAN(data, 12, 'UPC-A');
   }
 
   /**
-   * Calculate EAN check digit
-   * @param {string} data - The data without check digit
-   * @returns {number} Check digit
+   * Validate UPC-E data
+   * @param {string} data - The data to validate
+   * @returns {Object} Validation result
    */
-  calculateEANCheckDigit(data) {
-    let sum = 0;
-    for (let i = 0; i < data.length; i++) {
-      const digit = parseInt(data[i]);
-      sum += i % 2 === 0 ? digit : digit * 3;
-    }
-    return (10 - (sum % 10)) % 10;
+  validateUPCE(data) {
+    return this.validatePattern(data, 'upce', 'UPC-E must be 7 or 8 digits');
   }
 }
 

package/.eslintrc.js

@@ -1,29 +0,0 @@
-module.exports = {
-  env: {
-    node: true,
-    es2021: true,
-    jest: true,
-  },
-  extends: ['standard'],
-  parserOptions: {
-    ecmaVersion: 12,
-    sourceType: 'module',
-  },
-  rules: {
-    'no-console': 'warn',
-    'no-unused-vars': 'error',
-    'prefer-const': 'error',
-    'no-var': 'error',
-    'object-shorthand': 'error',
-    'prefer-template': 'error',
-  },
-  globals: {
-    Buffer: 'readonly',
-    process: 'readonly',
-    __dirname: 'readonly',
-    __filename: 'readonly',
-    module: 'readonly',
-    require: 'readonly',
-    exports: 'readonly',
-  },
-};

package/.prettierignore

@@ -1,11 +0,0 @@
-node_modules/
-dist/
-build/
-coverage/
-*.log
-.DS_Store
-.env
-.env.local
-.env.development.local
-.env.test.local
-.env.production.local

package/.prettierrc

@@ -1,11 +0,0 @@
-{
-  "semi": true,
-  "trailingComma": "es5",
-  "singleQuote": true,
-  "printWidth": 80,
-  "tabWidth": 2,
-  "useTabs": false,
-  "bracketSpacing": true,
-  "arrowParens": "avoid",
-  "endOfLine": "lf"
-}

package/eslint.config.js

@@ -1,67 +0,0 @@
-module.exports = [
-  {
-    files: ['**/*.js'],
-    languageOptions: {
-      ecmaVersion: 2022,
-      sourceType: 'module',
-      globals: {
-        console: 'readonly',
-        process: 'readonly',
-        Buffer: 'readonly',
-        __dirname: 'readonly',
-        __filename: 'readonly',
-        global: 'readonly',
-        module: 'readonly',
-        require: 'readonly',
-        exports: 'readonly',
-        document: 'readonly',
-        FileReader: 'readonly',
-      },
-    },
-    plugins: {
-      prettier: require('eslint-plugin-prettier'),
-    },
-    rules: {
-      'prettier/prettier': 'error',
-      'no-unused-vars': 'warn',
-      'no-console': 'off',
-      'no-undef': 'error',
-    },
-  },
-  {
-    files: ['tests/**/*.js', '**/*.test.js'],
-    languageOptions: {
-      ecmaVersion: 2022,
-      sourceType: 'module',
-      globals: {
-        console: 'readonly',
-        process: 'readonly',
-        Buffer: 'readonly',
-        __dirname: 'readonly',
-        __filename: 'readonly',
-        global: 'readonly',
-        module: 'readonly',
-        require: 'readonly',
-        exports: 'readonly',
-        describe: 'readonly',
-        test: 'readonly',
-        it: 'readonly',
-        expect: 'readonly',
-        beforeEach: 'readonly',
-        afterEach: 'readonly',
-        beforeAll: 'readonly',
-        afterAll: 'readonly',
-        jest: 'readonly',
-      },
-    },
-    plugins: {
-      prettier: require('eslint-plugin-prettier'),
-    },
-    rules: {
-      'prettier/prettier': 'error',
-      'no-unused-vars': 'warn',
-      'no-console': 'off',
-      'no-undef': 'error',
-    },
-  },
-];

package/examples/basic-usage.js

@@ -1,58 +0,0 @@
-/**
- * Basic usage examples for Isahaq Barcode Generator
- */
-
-const BarcodeGenerator = require('../index');
-
-async function basicExamples() {
-  console.log('🚀 Basic Barcode Generation Examples\n');
-
-  // 1. Generate PNG barcode
-  console.log('1. Generating PNG barcode...');
-  const pngBuffer = BarcodeGenerator.png('1234567890', 'code128');
-  console.log(`   PNG buffer size: ${pngBuffer.length} bytes`);
-
-  // 2. Generate SVG barcode
-  console.log('2. Generating SVG barcode...');
-  const svgString = BarcodeGenerator.svg('1234567890', 'ean13');
-  console.log(`   SVG length: ${svgString.length} characters`);
-
-  // 3. Generate HTML barcode
-  console.log('3. Generating HTML barcode...');
-  const htmlString = BarcodeGenerator.html('1234567890', 'code39');
-  console.log(`   HTML length: ${htmlString.length} characters`);
-
-  // 4. Generate PDF barcode
-  console.log('4. Generating PDF barcode...');
-  const pdfBuffer = await BarcodeGenerator.pdf('1234567890', 'code128');
-  console.log(`   PDF buffer size: ${pdfBuffer.length} bytes`);
-
-  // 5. Generate QR code
-  console.log('5. Generating QR code...');
-  const qrCode = BarcodeGenerator.modernQr({
-    data: 'https://example.com',
-    size: 300,
-    margin: 10,
-  });
-  const qrBuffer = await qrCode.generate();
-  console.log(`   QR code buffer size: ${qrBuffer.length} bytes`);
-
-  // 6. Generate QR code with logo
-  console.log('6. Generating QR code with logo...');
-  const qrWithLogo = BarcodeGenerator.modernQr({
-    data: 'https://example.com',
-    size: 300,
-    logoPath: 'path/to/logo.png',
-    logoSize: 60,
-    label: 'Scan me!',
-  });
-  const qrWithLogoBuffer = await qrWithLogo.generate();
-  console.log(
-    `   QR code with logo buffer size: ${qrWithLogoBuffer.length} bytes`
-  );
-
-  console.log('\n✅ All examples completed successfully!');
-}
-
-// Run examples
-basicExamples().catch(console.error);

package/examples/batch-example.json

@@ -1,56 +0,0 @@
-[
-  {
-    "data": "1234567890",
-    "type": "code128",
-    "format": "png",
-    "options": {
-      "width": 3,
-      "height": 150,
-      "displayValue": true
-    }
-  },
-  {
-    "data": "9876543210",
-    "type": "code39",
-    "format": "svg",
-    "options": {
-      "width": 2,
-      "height": 100,
-      "displayValue": false
-    }
-  },
-  {
-    "data": "1234567890123",
-    "type": "ean13",
-    "format": "png",
-    "options": {
-      "width": 2,
-      "height": 120,
-      "displayValue": true
-    }
-  },
-  {
-    "data": "https://example.com",
-    "type": "qrcode",
-    "format": "png",
-    "options": {
-      "size": 300,
-      "margin": 10,
-      "logoPath": "path/to/logo.png",
-      "logoSize": 60,
-      "label": "Scan me!"
-    }
-  },
-  {
-    "data": "https://github.com",
-    "type": "qrcode",
-    "format": "png",
-    "options": {
-      "size": 400,
-      "margin": 15,
-      "watermark": "GitHub",
-      "watermarkPosition": "center",
-      "errorCorrectionLevel": "H"
-    }
-  }
-]