isahaq-barcode 1.8.0 → 2.0.0

package/index.js

@@ -1,38 +1,65 @@
 /**
  * Isahaq Barcode Generator
- * A universal barcode generator package supporting multiple barcode types and output formats
+ * A universal barcode generator supporting 40+ symbologies and PNG/SVG/HTML/PDF output.
+ *
+ * Bundlers pick up ./browser.js through the "browser" field in package.json;
+ * the check below is a backstop for environments that load this file directly.
  */
 
-// Detect environment
 const isBrowser =
-  typeof window !== 'undefined' && typeof document !== 'undefined';
+  typeof window !== 'undefined' &&
+  typeof document !== 'undefined' &&
+  typeof process === 'undefined';
 
 if (isBrowser) {
-  // Browser environment - use browser-compatible version
   module.exports = require('./browser');
 } else {
-  // Node.js environment - use full-featured version
   const BarcodeService = require('./src/services/BarcodeService');
   const QrCodeBuilder = require('./src/builders/QrCodeBuilder');
   const { BarcodeTypes } = require('./src/types/BarcodeTypes');
   const { RenderFormats } = require('./src/renderers/RenderFormats');
+  const { BarcodeEncoder } = require('./src/encoders/BarcodeEncoder');
+  const { Validator } = require('./src/validators/Validator');
+
+  const WATERMARK_POSITIONS = [
+    'top-left',
+    'top-center',
+    'top-right',
+    'left-center',
+    'center',
+    'right-center',
+    'bottom-left',
+    'bottom-center',
+    'bottom-right',
+  ];
 
-  // Main service instance
   const barcodeService = new BarcodeService();
 
   /**
    * Main Barcode Generator Class
    */
   class BarcodeGenerator {
+    /**
+     * Generate a barcode in any supported format
+     * @param {string} data - The data to encode
+     * @param {string} type - The barcode type
+     * @param {string} format - The output format (png, svg, html, pdf)
+     * @param {Object} options - Generation options
+     * @returns {Promise<Buffer|string>} Generated barcode
+     */
+    static generate(data, type = 'code128', format = 'png', options = {}) {
+      return barcodeService.generate(data, type, format, options);
+    }
+
     /**
      * Generate a barcode in PNG format
      * @param {string} data - The data to encode
      * @param {string} type - The barcode type
      * @param {Object} options - Generation options
-     * @returns {Buffer} PNG buffer
+     * @returns {Promise<Buffer>} PNG buffer
      */
     static png(data, type = 'code128', options = {}) {
-      return barcodeService.generate(data, type, 'png', options);
+      return barcodeService.png(data, type, options);
     }
 
     /**
@@ -40,21 +67,43 @@ if (isBrowser) {
      * @param {string} data - The data to encode
      * @param {string} type - The barcode type
      * @param {Object} options - Generation options
-     * @returns {string} SVG string
+     * @returns {Promise<string>} SVG markup
      */
     static svg(data, type = 'code128', options = {}) {
-      return barcodeService.generate(data, type, 'svg', options);
+      return barcodeService.svg(data, type, options);
+    }
+
+    /**
+     * Generate a barcode in SVG format synchronously
+     * @param {string} data - The data to encode
+     * @param {string} type - The barcode type
+     * @param {Object} options - Generation options
+     * @returns {string} SVG markup
+     */
+    static svgSync(data, type = 'code128', options = {}) {
+      return barcodeService.svgSync(data, type, options);
     }
 
     /**
-     * Generate a barcode in HTML format
+     * Generate a barcode as an HTML fragment
      * @param {string} data - The data to encode
      * @param {string} type - The barcode type
      * @param {Object} options - Generation options
-     * @returns {string} HTML string
+     * @returns {Promise<string>} HTML markup
      */
     static html(data, type = 'code128', options = {}) {
-      return barcodeService.generate(data, type, 'html', options);
+      return barcodeService.html(data, type, options);
+    }
+
+    /**
+     * Generate a barcode as an HTML fragment synchronously
+     * @param {string} data - The data to encode
+     * @param {string} type - The barcode type
+     * @param {Object} options - Generation options
+     * @returns {string} HTML markup
+     */
+    static htmlSync(data, type = 'code128', options = {}) {
+      return barcodeService.htmlSync(data, type, options);
     }
 
     /**
@@ -64,12 +113,12 @@ if (isBrowser) {
      * @param {Object} options - Generation options
      * @returns {Promise<Buffer>} PDF buffer
      */
-    static async pdf(data, type = 'code128', options = {}) {
-      return barcodeService.generate(data, type, 'pdf', options);
+    static pdf(data, type = 'code128', options = {}) {
+      return barcodeService.pdf(data, type, options);
     }
 
     /**
-     * Generate a QR code
+     * Create a QR code builder for logo, label and watermark support
      * @param {string} data - The data to encode
      * @param {Object} options - Generation options
      * @returns {QrCodeBuilder} QR code builder instance
@@ -78,6 +127,15 @@ if (isBrowser) {
       return new QrCodeBuilder({ data, ...options });
     }
 
+    /**
+     * Create a QR code builder from an options object
+     * @param {Object} options - QR code options
+     * @returns {QrCodeBuilder} QR code builder instance
+     */
+    static modernQr(options = {}) {
+      return new QrCodeBuilder(options);
+    }
+
     /**
      * Validate barcode data
      * @param {string} data - The data to validate
@@ -90,51 +148,58 @@ if (isBrowser) {
 
     /**
      * Generate multiple barcodes in batch
-     * @param {Array} items - Array of barcode configurations
-     * @returns {Promise<Array>} Array of generated barcodes
+     * @param {Array<Object>} items - Array of barcode configurations
+     * @returns {Promise<Array<Object>>} Array of results
      */
-    static async batch(items) {
+    static batch(items) {
       return barcodeService.batch(items);
     }
 
     /**
      * Get supported barcode types
-     * @returns {Array} Array of supported types
+     * @returns {string[]} Array of supported types
      */
     static getBarcodeTypes() {
-      return BarcodeTypes.getTypes();
+      return BarcodeTypes.getAll();
+    }
+
+    /**
+     * Get supported barcode categories
+     * @returns {string[]} Array of category names
+     */
+    static getBarcodeCategories() {
+      return BarcodeTypes.getCategories();
+    }
+
+    /**
+     * Get supported barcode types in a category
+     * @param {string} category - The category name
+     * @returns {string[]} Array of types
+     */
+    static getBarcodeTypesByCategory(category) {
+      return BarcodeTypes.getByCategory(category);
     }
 
     /**
      * Get supported render formats
-     * @returns {Array} Array of supported formats
+     * @returns {string[]} Array of supported formats
      */
     static getRenderFormats() {
-      return RenderFormats.getFormats();
+      return RenderFormats.getAll();
     }
 
     /**
-     * Get watermark positions
-     * @returns {Array} Array of watermark positions
+     * Get watermark positions supported by the QR code builder
+     * @returns {string[]} Array of watermark positions
      */
     static getWatermarkPositions() {
-      return [
-        'top-left',
-        'top-center',
-        'top-right',
-        'left-center',
-        'center',
-        'right-center',
-        'bottom-left',
-        'bottom-center',
-        'bottom-right',
-      ];
+      return [...WATERMARK_POSITIONS];
     }
 
     /**
      * Get barcode type information
      * @param {string} type - The barcode type
-     * @returns {Object} Type information
+     * @returns {Object|null} Type information
      */
     static getBarcodeTypeInfo(type) {
       return BarcodeTypes.getTypeInfo(type);
@@ -143,12 +208,27 @@ if (isBrowser) {
     /**
      * Get render format information
      * @param {string} format - The render format
-     * @returns {Object} Format information
+     * @returns {Object|null} Format information
      */
     static getRenderFormatInfo(format) {
       return RenderFormats.getFormatInfo(format);
     }
+
+    /**
+     * Get the default render options
+     * @returns {Object} Default options
+     */
+    static getDefaultOptions() {
+      return BarcodeEncoder.getDefaultOptions();
+    }
   }
 
+  BarcodeGenerator.QrCodeBuilder = QrCodeBuilder;
+  BarcodeGenerator.BarcodeTypes = BarcodeTypes;
+  BarcodeGenerator.RenderFormats = RenderFormats;
+  BarcodeGenerator.BarcodeEncoder = BarcodeEncoder;
+  BarcodeGenerator.BarcodeService = BarcodeService;
+  BarcodeGenerator.Validator = Validator;
+
   module.exports = BarcodeGenerator;
 }

package/package.json

@@ -1,88 +1,122 @@
 {
   "name": "isahaq-barcode",
-  "version": "1.8.0",
-  "description": "A universal barcode generator package supporting multiple barcode types and output formats, with extra features like batch generation, watermarking, validation, CLI, and Express.js integration",
+  "version": "2.0.0",
+  "description": "Universal barcode and QR code generator for Node.js and the browser: 40+ symbologies, PNG/SVG/HTML/PDF output, batch generation, logo and watermark support, validation, CLI and Express.js integration",
   "main": "index.js",
-  "browser": {
-    "fs": false,
-    "path": false,
-    "os": false,
-    "canvas": false
+  "types": "index.d.ts",
+  "browser": "./browser.js",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "browser": "./browser.js",
+      "require": "./index.js",
+      "default": "./index.js"
+    },
+    "./package.json": "./package.json"
   },
   "bin": {
     "barcode-generate": "./bin/generate.js"
   },
   "scripts": {
-    "test": "npx jest",
-    "test:watch": "npx jest --watch",
-    "test:coverage": "npx jest --coverage",
-    "lint": "npx eslint .",
-    "lint:fix": "npx eslint . --fix",
-    "format": "npx prettier --write .",
-    "format:check": "npx prettier --check .",
-    "build": "npm run lint && npm run format:check",
-    "prepare": "husky install",
-    "prepublishOnly": "npm run build",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "typecheck": "tsc --noEmit index.d.ts",
+    "verify:scan": "node scripts/verify-scannability.mjs",
+    "build": "npm run lint && npm run format:check && npm run typecheck && npm test",
+    "prepare": "husky",
+    "prepublishOnly": "npm run build && npm run verify:scan",
     "dev": "node examples/express-server.js",
     "start": "node examples/express-server.js"
   },
   "keywords": [
     "barcode",
+    "barcode-generator",
     "qrcode",
+    "qr-code",
     "generator",
     "code128",
     "code39",
+    "code93",
     "ean13",
+    "ean8",
     "upc",
+    "itf14",
     "datamatrix",
     "pdf417",
     "aztec",
+    "maxicode",
+    "postnet",
+    "codabar",
+    "pharmacode",
     "svg",
     "png",
     "pdf",
+    "html",
     "cli",
     "express",
-    "node"
+    "node",
+    "browser"
   ],
-  "author": "hmisahaq01@gmail.com",
+  "author": "Isahaq <hmisahaq01@gmail.com>",
   "license": "MIT",
   "dependencies": {
-    "canvas": "^3.2.0",
-    "chalk": "^5.6.2",
+    "bwip-js": "^4.11.2",
     "commander": "^14.0.1",
-    "jsbarcode": "^3.12.1",
-    "ora": "^9.0.0",
     "pdfkit": "^0.17.2",
     "qrcode": "^1.5.4"
   },
-  "peerDependencies": {
-    "jsbarcode": "^3.12.1",
-    "qrcode": "^1.5.4"
+  "optionalDependencies": {
+    "canvas": "^3.2.0"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",
     "eslint": "^9.38.0",
     "eslint-config-prettier": "^10.1.8",
-    "eslint-config-standard": "^17.1.0",
-    "eslint-plugin-import": "^2.32.0",
-    "eslint-plugin-node": "^11.1.0",
     "eslint-plugin-prettier": "^5.5.4",
-    "eslint-plugin-promise": "^7.2.1",
+    "express": "^5.2.1",
     "husky": "^9.1.7",
     "jest": "^30.2.0",
     "lint-staged": "^15.2.10",
     "prettier": "^3.4.0",
-    "typescript": "^5.7.0"
+    "typescript": "^5.7.0",
+    "zxing-wasm": "^2.2.4"
+  },
+  "lint-staged": {
+    "*.js": [
+      "eslint --fix",
+      "prettier --write"
+    ],
+    "*.{json,md,yml}": [
+      "prettier --write"
+    ]
   },
   "engines": {
     "node": ">=18.0.0"
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/isahaq1/barcode-generator-npm.git"
+    "url": "git+https://github.com/isahaq1/npm-barcodegenerator.git"
   },
   "bugs": {
-    "url": "https://github.com/isahaq1/barcode-generator-npm/issues"
+    "url": "https://github.com/isahaq1/npm-barcodegenerator/issues"
+  },
+  "homepage": "https://github.com/isahaq1/npm-barcodegenerator#readme",
+  "publishConfig": {
+    "access": "public"
   },
-  "homepage": "https://github.com/isahaq1/barcode-generator-npm#readme"
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "browser.js",
+    "bin/",
+    "src/",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ]
 }