aspose.barcode 26.3.1 → 26.5.0

package/lib/Joint.js

@@ -195,6 +195,11 @@ class BaseJavaClass
 
 /**
  * Provides methods to license the component.
+ *
+ *  @deprecated Legacy node-java bridge API.
+ *
+ *  This API is deprecated and scheduled for removal in version 26.7.
+ *  A java-bridge based replacement is planned, but is not available yet.
  */
 class License extends BaseJavaClass
 {
@@ -268,6 +273,11 @@ class License extends BaseJavaClass
 /**
  * @class
  * @extends {Error}
+ *
+ *  @deprecated Legacy node-java bridge API.
+ *
+ *  This API is deprecated and scheduled for removal in version 26.7.
+ *  A java-bridge based replacement is planned, but is not available yet.
  */
 class BarcodeException extends Error {
     /**
@@ -314,7 +324,12 @@ class BarcodeException extends Error {
     }
 }
 
-
+/**
+ *  @deprecated Legacy node-java bridge API.
+ *
+ *  This API is deprecated and scheduled for removal in version 26.7.
+ *  A java-bridge based replacement is planned, but is not available yet.
+ */
 class Rectangle extends BaseJavaClass
 {
 
@@ -476,6 +491,11 @@ class Rectangle extends BaseJavaClass
 
 /**
  * Represents Point class
+ *
+ *  @deprecated Legacy node-java bridge API.
+ *
+ *  This API is deprecated and scheduled for removal in version 26.7.
+ *  A java-bridge based replacement is planned, but is not available yet.
  */
 class Point extends BaseJavaClass
 {
@@ -558,6 +578,12 @@ class Point extends BaseJavaClass
     }
 }
 
+/**
+ *  @deprecated Legacy node-java bridge API.
+ *
+ *  This API is deprecated and scheduled for removal in version 26.7.
+ *  A java-bridge based replacement is planned, but is not available yet.
+ */
 class BuildVersionInfo
 {
     static get javaClassName()

package/lib/Recognition.js

@@ -16,6 +16,11 @@ const {Buffer} = require("buffer");
  *    console.log("BarCode Type: " + result.getCodeTypeName());
  *    console.log("BarCode CodeText: " + result.getCodeText());
  * }
+ *
+ *  @deprecated Legacy node-java bridge API.
+ *
+ *  This API is deprecated and scheduled for removal in version 26.7.
+ *  A java-bridge based replacement is planned, but is not available yet.
  */
 class BarCodeReader extends joint.BaseJavaClass
 {
@@ -445,6 +450,11 @@ class BarCodeReader extends joint.BaseJavaClass
 
 /**
  * Stores a set of four Points that represent a Quadrangle region.
+ *
+ *  @deprecated Legacy node-java bridge API.
+ *
+ *  This API is deprecated and scheduled for removal in version 26.7.
+ *  A java-bridge based replacement is planned, but is not available yet.
  */
 class Quadrangle extends joint.BaseJavaClass
 {
@@ -677,6 +687,11 @@ class Quadrangle extends joint.BaseJavaClass
  *    console.log("QR Structured Append Index: " + result.getExtended().getQR().getQRStructuredAppendModeBarCodeIndex());
  *    console.log("QR Structured Append ParityData: " + result.getExtended().getQR().getQRStructuredAppendModeParityData());
  * }
+ *
+ *  @deprecated Legacy node-java bridge API.
+ *
+ *  This API is deprecated and scheduled for removal in version 26.7.
+ *  A java-bridge based replacement is planned, but is not available yet.
  */
 class QRExtendedParameters extends joint.BaseJavaClass
 {
@@ -860,6 +875,11 @@ class QRExtendedParameters extends joint.BaseJavaClass
  *     console.log("Macro Pdf417 Segments: " + result.getExtended().getPdf417().getMacroPdf417SegmentsCount());
  *     console.log("Macro Pdf417 SegmentID: " + result.getExtended().getPdf417().getMacroPdf417SegmentID());
  * }
+ *
+ *  @deprecated Legacy node-java bridge API.
+ *
+ *  This API is deprecated and scheduled for removal in version 26.7.
+ *  A java-bridge based replacement is planned, but is not available yet.
  */
 class Pdf417ExtendedParameters extends joint.BaseJavaClass
 {
@@ -939,7 +959,11 @@ class Pdf417ExtendedParameters extends joint.BaseJavaClass
      */
     getMacroPdf417TimeStamp()
     {
-        return new Date(this.getJavaClass().getMacroPdf417TimeStampSync() * 1000);
+        const value = this.getJavaClass().getMacroPdf417TimeStampSync();
+
+        if (!value) return null;
+
+        return new Date(value);
     }
 
     /**
@@ -1036,6 +1060,11 @@ class Pdf417ExtendedParameters extends joint.BaseJavaClass
  *    console.log("BarCode Value: " + result.getExtended().getOneD().getValue());
  *    console.log("BarCode Checksum: " + result.getExtended().getOneD().getCheckSum());
  * }
+ *
+ *  @deprecated Legacy node-java bridge API.
+ *
+ *  This API is deprecated and scheduled for removal in version 26.7.
+ *  A java-bridge based replacement is planned, but is not available yet.
  */
 class OneDExtendedParameters extends joint.BaseJavaClass
 {
@@ -1122,6 +1151,11 @@ class OneDExtendedParameters extends joint.BaseJavaClass
  *    console.log("BarCode CodeText: " + result.getCodeText());
  *    console.log("Code128 Data Portions: " + result.getExtended().getCode128());
  * }
+ *
+ *  @deprecated Legacy node-java bridge API.
+ *
+ *  This API is deprecated and scheduled for removal in version 26.7.
+ *  A java-bridge based replacement is planned, but is not available yet.
  */
 class Code128ExtendedParameters extends joint.BaseJavaClass
 {
@@ -1212,6 +1246,11 @@ class Code128ExtendedParameters extends joint.BaseJavaClass
  *     console.log("BarCode ReadingQuality: " + result.getReadingQuality());
  *     console.log("BarCode Angle: " + result.getRegion().getAngle());
  * }
+ *
+ *  @deprecated Legacy node-java bridge API.
+ *
+ *  This API is deprecated and scheduled for removal in version 26.7.
+ *  A java-bridge based replacement is planned, but is not available yet.
  */
 class BarCodeResult extends joint.BaseJavaClass
 {
@@ -1374,6 +1413,11 @@ class BarCodeResult extends joint.BaseJavaClass
  *    console.log("BarCode Angle: " + result.getRegion().getAngle());
  *    console.log("BarCode Quadrangle: " + result.getRegion().getQuadrangle());
  * }
+ *
+ *  @deprecated Legacy node-java bridge API.
+ *
+ *  This API is deprecated and scheduled for removal in version 26.7.
+ *  A java-bridge based replacement is planned, but is not available yet.
  */
 class BarCodeRegionParameters extends joint.BaseJavaClass
 {
@@ -1471,6 +1515,11 @@ class BarCodeRegionParameters extends joint.BaseJavaClass
 
 /**
  * Stores extended parameters of recognized barcode
+ *
+ *  @deprecated Legacy node-java bridge API.
+ *
+ *  This API is deprecated and scheduled for removal in version 26.7.
+ *  A java-bridge based replacement is planned, but is not available yet.
  */
 class BarCodeExtendedParameters extends joint.BaseJavaClass
 {
@@ -1701,6 +1750,11 @@ class BarCodeExtendedParameters extends joint.BaseJavaClass
  *   let result = results[i];
  *   console.log("BarCode CodeText: " + result.getCodeText());
  * }
+ *
+ *  @deprecated Legacy node-java bridge API.
+ *
+ *  This API is deprecated and scheduled for removal in version 26.7.
+ *  A java-bridge based replacement is planned, but is not available yet.
  */
 class QualitySettings extends joint.BaseJavaClass
 {
@@ -1917,6 +1971,11 @@ class QualitySettings extends joint.BaseJavaClass
 
 /**
  * Contains the data of subtype for Code128 type barcode
+ *
+ *  @deprecated Legacy node-java bridge API.
+ *
+ *  This API is deprecated and scheduled for removal in version 26.7.
+ *  A java-bridge based replacement is planned, but is not available yet.
  */
 class Code128DataPortion extends joint.BaseJavaClass
 {
@@ -1966,7 +2025,7 @@ class Code128DataPortion extends joint.BaseJavaClass
 /**
  * Stores a DataBar additional information of recognized barcode
  *@example
- *  let reader = new BarCodeReader("c:\\test.png", DecodeType.DATABAR_OMNI_DIRECTIONAL);
+ *  let reader = new BarCodeReader("test.png", DecodeType.DATABAR_OMNI_DIRECTIONAL);
  * let results = reader.readBarCodes();
  * for(let i = 0; i < results.length; i++)
  * {
@@ -1975,6 +2034,11 @@ class Code128DataPortion extends joint.BaseJavaClass
  *    console.log("BarCode CodeText: " + result.getCodeText());
  *    console.log("QR Structured Append Quantity: " + result.getExtended().getQR().getQRStructuredAppendModeBarCodesQuantity());
  * }
+ *
+ *  @deprecated Legacy node-java bridge API.
+ *
+ *  This API is deprecated and scheduled for removal in version 26.7.
+ *  A java-bridge based replacement is planned, but is not available yet.
  */
 class DataBarExtendedParameters extends joint.BaseJavaClass
 {
@@ -2023,6 +2087,11 @@ class DataBarExtendedParameters extends joint.BaseJavaClass
 
 /**
  * AustraliaPost decoding parameters. Contains parameters which make influence on recognized data of AustraliaPost symbology.
+ *
+ *  @deprecated Legacy node-java bridge API.
+ *
+ *  This API is deprecated and scheduled for removal in version 26.7.
+ *  A java-bridge based replacement is planned, but is not available yet.
  */
 class AustraliaPostSettings extends joint.BaseJavaClass
 {
@@ -2115,6 +2184,11 @@ class AustraliaPostSettings extends joint.BaseJavaClass
 
 /**
  * The main BarCode decoding parameters. Contains parameters which make influence on recognized data.
+ *
+ *  @deprecated Legacy node-java bridge API.
+ *
+ *  This API is deprecated and scheduled for removal in version 26.7.
+ *  A java-bridge based replacement is planned, but is not available yet.
  */
 class BarcodeSettings extends joint.BaseJavaClass
 {
@@ -2293,6 +2367,88 @@ class BarcodeSettings extends joint.BaseJavaClass
         this.getJavaClass().setStripFNCSync(value);
     }
 
+
+
+    /**
+     * Returns only barcode types explicitly specified for recognition.
+     * When enabled, recognized barcodes of other compatible or equivalent types are filtered out.
+     * Default value is false.
+     *
+     * <p>Example:</p>
+     * <pre>
+     * // generate EAN13 barcode
+     * let generator = new BarcodeGenerator(EncodeTypes.EAN_13, "2383823482894");
+     * generator.save("test.png");
+     *
+     * // recognize only UPCA barcodes (no results, because source is EAN13)
+     * const reader = new BarCodeReader("test.png", null, DecodeType.UPCA);
+     * reader.getBarcodeSettings().setOnlyRequestedTypes(true);
+     *
+     * let results = reader.readBarCodes();
+     * for (let i = 0; i < results.length; i++)
+     * {
+     *     console.log("BarCode CodeText: " + results[i].getCodeText());
+     * }
+     *
+     * // recognize compatible types: EAN13, UPCA, ISSN, ISMN, ISBN
+     * // (EAN13 will be returned as UPCA-equivalent)
+     * let reader2 = new BarCodeReader("test.png", null, DecodeType.UPCA);
+     * reader2.getBarcodeSettings().setOnlyRequestedTypes(false);
+     *
+     * let results2 = reader2.readBarCodes();
+     * for (let i = 0; i < results2.length; i++)
+     * {
+     *     console.log("BarCode CodeText: " + results2[i].getCodeText());
+     * }
+     * </pre>
+     *
+     * @return true if only explicitly requested barcode types are returned; otherwise false
+     */
+    isOnlyRequestedTypes()
+    {
+        return this.getJavaClass().isOnlyRequestedTypesSync();
+    }
+
+    /**
+     * Returns only barcode types explicitly specified for recognition.
+     * When enabled, recognized barcodes of other compatible or equivalent types are filtered out.
+     * Default value is false.
+     *
+     * <p>Example:</p>
+     * <pre>
+     * // generate EAN13 barcode
+     * let generator = new BarcodeGenerator(EncodeTypes.EAN_13, "2383823482894");
+     * generator.save("test.png");
+     *
+     * // recognize only UPCA barcodes (no results, because source is EAN13)
+     * const reader = new BarCodeReader("test.png", null, DecodeType.UPCA);
+     * reader.getBarcodeSettings().setOnlyRequestedTypes(true);
+     *
+     * let results = reader.readBarCodes();
+     * for (let i = 0; i < results.length; i++)
+     * {
+     *     console.log("BarCode CodeText: " + results[i].getCodeText());
+     * }
+     *
+     * // recognize compatible types: EAN13, UPCA, ISSN, ISMN, ISBN
+     * // (EAN13 will be returned as UPCA-equivalent)
+     * let reader2 = new BarCodeReader("test.png", null, DecodeType.UPCA);
+     * reader2.getBarcodeSettings().setOnlyRequestedTypes(false);
+     *
+     * let results2 = reader2.readBarCodes();
+     * for (let i = 0; i < results2.length; i++)
+     * {
+     *     console.log("BarCode CodeText: " + results2[i].getCodeText());
+     * }
+     * </pre>
+     *
+     * @return true if only explicitly requested barcode types are returned; otherwise false
+     */
+    setOnlyRequestedTypes(value)
+    {
+        this.getJavaClass().setOnlyRequestedTypesSync(value);
+    }
+
     /**
      * The flag which force engine to detect codetext encoding for Unicode codesets. Default value is true.
      *
@@ -2377,6 +2533,11 @@ class BarcodeSettings extends joint.BaseJavaClass
 
 /**
  * Represents recognition abort exception which is thrown in timeout exceeding during recognition with BarCodeReader.
+ *
+ *  @deprecated Legacy node-java bridge API.
+ *
+ *  This API is deprecated and scheduled for removal in version 26.7.
+ *  A java-bridge based replacement is planned, but is not available yet.
  */
 class RecognitionAbortedException extends Error
 {
@@ -2443,6 +2604,11 @@ class RecognitionAbortedException extends Error
 
 /**
  * Stores a MaxiCode additional information of recognized barcode
+ *
+ *  @deprecated Legacy node-java bridge API.
+ *
+ *  This API is deprecated and scheduled for removal in version 26.7.
+ *  A java-bridge based replacement is planned, but is not available yet.
  */
 class MaxiCodeExtendedParameters extends joint.BaseJavaClass
 {
@@ -2559,9 +2725,9 @@ class MaxiCodeExtendedParameters extends joint.BaseJavaClass
  *
  * @example
  * let generator = new BarcodeGenerator(EncodeTypes.DOT_CODE, "12345");
- * generator.save("c:\\test.png", BarCodeImageFormat.PNG);
+ * generator.save("test.png", BarCodeImageFormat.PNG);
  *
- * let reader = new BarCodeReader("c:\\test.png", null, DecodeType.DOT_CODE);
+ * let reader = new BarCodeReader("test.png", null, DecodeType.DOT_CODE);
  * let results = reader.readBarCodes();
  * for(let i = 0; i < results.length; i++)
  * {
@@ -2571,6 +2737,11 @@ class MaxiCodeExtendedParameters extends joint.BaseJavaClass
  *     print("DotCode barcode ID: " + result.getExtended().getDotCode().getDotCodeStructuredAppendModeBarcodeId());
  *     print("DotCode barcodes count: " + result.getExtended().getDotCode().getDotCodeStructuredAppendModeBarcodesCount());
  * }
+ *
+ *  @deprecated Legacy node-java bridge API.
+ *
+ *  This API is deprecated and scheduled for removal in version 26.7.
+ *  A java-bridge based replacement is planned, but is not available yet.
  */
 class DotCodeExtendedParameters extends joint.BaseJavaClass
 {
@@ -2682,9 +2853,9 @@ class DotCodeExtendedParameters extends joint.BaseJavaClass
  * This sample shows how to get DataMatrix raw values
  * <pre>
  * let generator = new BarcodeGenerator(EncodeTypes.DATA_MATRIX, "12345"))
- * generator.save("c:\\test.png", BarcodeImageFormat.PNG);
+ * generator.save("test.png", BarcodeImageFormat.PNG);
  *
- * let reader = new BarCodeReader("c:\\test.png", null, DecodeType.DATA_MATRIX))
+ * let reader = new BarCodeReader("test.png", null, DecodeType.DATA_MATRIX))
  * let results = reader.readBarCodes();
  * for(let i = 0; i < results.length; i++)
  * {
@@ -2698,6 +2869,11 @@ class DotCodeExtendedParameters extends joint.BaseJavaClass
  * }
  * </pre>
  * </pre></blockquote></hr></p>
+ *
+ *  @deprecated Legacy node-java bridge API.
+ *
+ *  This API is deprecated and scheduled for removal in version 26.7.
+ *  A java-bridge based replacement is planned, but is not available yet.
  */
 class DataMatrixExtendedParameters extends joint.BaseJavaClass
 {
@@ -2784,6 +2960,11 @@ class DataMatrixExtendedParameters extends joint.BaseJavaClass
  * <p>
  * Stores special data of {@code <b>GS1 Composite Bar</b>} recognized barcode
  * </p>
+ *
+ *  @deprecated Legacy node-java bridge API.
+ *
+ *  This API is deprecated and scheduled for removal in version 26.7.
+ *  A java-bridge based replacement is planned, but is not available yet.
  */
 class GS1CompositeBarExtendedParameters extends joint.BaseJavaClass
 {
@@ -2887,6 +3068,11 @@ class GS1CompositeBarExtendedParameters extends joint.BaseJavaClass
  * }
  * </pre>
  * </pre></blockquote></hr></p>
+ *
+ *  @deprecated Legacy node-java bridge API.
+ *
+ *  This API is deprecated and scheduled for removal in version 26.7.
+ *  A java-bridge based replacement is planned, but is not available yet.
  */
 class AztecExtendedParameters extends joint.BaseJavaClass
 {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aspose.barcode",
-  "version": "26.3.1",
+  "version": "26.5.0",
   "description": "barcode generation and recognition component",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"
@@ -16,9 +16,6 @@
     "lib": "lib"
   },
   "dependencies": {
-    "java": "0.18.0"
-  },
-  "engines": {
-    "node": "<=18"
+    "java": "^0.12.1"
   }
 }