fix(javadoc): phase 2 — reduce warnings (in progress)

Add missing Javadoc comments across ~65 files to reduce warning count:
- BaseChannel: field/method comments for constructors, filter chain, header accessors,
  socket helpers, metrics counters (40+ warnings addressed)
- BASE1Header, Base1Packager, Base1_BITMAP126, BASE24Packager: public method/constructor docs
- ISOFieldPackager, ISOBasePackager: method descriptions, @param/@return gaps
- ISOHeader, ISOPackager, ISOChannel, ISOSource, ServerChannel: interface method docs
- Interpreter, Prefixer, BinaryInterpreter: missing @param and descriptions
- AsciiPrefixer, AsciiHexInterpreter, AsciiInterpreter: private singleton constructors
- LogRenderer, AuditLogEvent, AuditLogEventJsonLogRenderer, LogSource: class/method docs
- AmexChannel, FilteredChannel, BaseHeader, ClientChannel, FactoryChannel: descriptions
- TLV packagers (IFTA_*, IFTB_*, BERTLVFormatMapper, etc.): missing one-liner descriptions
- core/: Card, CardHolder, Track1, Track2, Sequencer, VolatileSequencer, Configurable, etc.
- emv/: EMVConstructedTag, EMVTagType, UnknownTagNumberException

Still at 100 warnings (javadoc caps at 100/run); further iterations in progress.

Author: ar-agt

jpos/src/main/java/org/jpos/bsh/BSHUI.java

@@ -25,9 +25,11 @@
 import javax.swing.*;
 
 /**
- * @author Alejandro Revilla
  *
  * UI with BSH script support
+ *
+ * @author Alejandro Revilla
+ *
  */
 public class BSHUI extends UI {
     protected JComponent doScript (JComponent component, Element e) {

jpos/src/main/java/org/jpos/core/Card.java

@@ -27,11 +27,13 @@
 import java.util.Objects;
 
 /**
- * @author apr@jpos.org
- * @since jPOS 2.0.5
  *
  * This class is based on the old 'CardHolder' class and adds support for multiple
  * PAN and Expiration dates taken from manual entry, track1, track2. It also corrects the name.
+ *
+ * @author apr@jpos.org
+ * @since jPOS 2.0.5
+ *
  */
 public class Card {
     private String pan;

jpos/src/main/java/org/jpos/core/CardHolder.java

@@ -29,11 +29,13 @@
 import java.util.StringTokenizer;
 
 /**
- * @author apr@cs.com.uy
- * @since jPOS 1.1
  *
  * This class is called 'CardHolder', but a better name could have been 'Card'
  * At some point we'll deprecate this one and create a new 'Card' class.
+ *
+ * @author apr@cs.com.uy
+ * @since jPOS 1.1
+ *
  */
 public class CardHolder implements Cloneable, Serializable, Loggeable {
     private static final long serialVersionUID = 7449770625551878435L;

jpos/src/main/java/org/jpos/core/Configurable.java

@@ -27,8 +27,9 @@
  */
 public interface Configurable {
    /**
+    * Configures this object with the supplied {@link Configuration}.
     * @param cfg Configuration object
-    * @throws ConfigurationException
+    * @throws ConfigurationException if the configuration is invalid
     */
    void setConfiguration(Configuration cfg)
         throws ConfigurationException;

jpos/src/main/java/org/jpos/core/Configuration.java

@@ -22,12 +22,14 @@
 import java.util.Set;
 
 /**
+ *
+ * CardAgents relies on a Configuration object to provide
+ * runtime configuration parameters such as merchant number, etc.
+ *
  * @author apr@cs.com.uy
  * @version $Id$
  * @since jPOS 1.1
  *
- * CardAgents relies on a Configuration object to provide
- * runtime configuration parameters such as merchant number, etc.
  */
 public interface Configuration {
     String get(String propertyName);

jpos/src/main/java/org/jpos/core/ConfigurationException.java

@@ -21,6 +21,7 @@
 import org.jpos.iso.ISOException;
 
 /**
+ * Thrown when a configurable component cannot be initialised due to invalid or missing configuration.
  * @author <a href="mailto:apr@cs.com.uy">Alejandro P. Revilla</a>
  * @version $Revision$ $Date$
  * @see Configurable

jpos/src/main/java/org/jpos/core/InvalidCardException.java

@@ -19,6 +19,7 @@
 package org.jpos.core;
 
 /**
+ * Thrown when card data (PAN, expiry, etc.) is invalid or cannot be parsed.
  * @author apr@cs.com.uy
  * @version $Id$
  * @since jPOS 1.1

jpos/src/main/java/org/jpos/core/Sequencer.java

@@ -20,13 +20,15 @@
 
 
 /**
- * @author apr@cs.com.uy
- * @version $Id$
- * @since jPOS 1.1
  *
  * Multipurpose sequencer.<br>
  * CardAgents requires persistent sequence number<br>
  * Sequencer interface isolate from particular DB implementations
+ *
+ * @author apr@cs.com.uy
+ * @version $Id$
+ * @since jPOS 1.1
+ *
  */
 public interface Sequencer {
     int get(String counterName);

jpos/src/main/java/org/jpos/core/SimpleConfiguration.java

@@ -26,6 +26,7 @@
 import java.util.stream.IntStream;
 
 /**
+ * A {@link Configuration} implementation backed by a {@link java.util.Properties} object.
  * @author apr@cs.com.uy
  * @version $Id$
  * @since jPOS 1.1

jpos/src/main/java/org/jpos/core/Track1.java

@@ -25,11 +25,13 @@
 import java.util.regex.Pattern;
 
 /**
- * @author apr@jpos.org
- * @since jPOS 2.0.5
  *
  * This class is based on the old 'CardHolder' class and adds support for multiple
  * PAN and Expiration dates taken from manual entry, track1, track1. It also corrects the name.
+ *
+ * @author apr@jpos.org
+ * @since jPOS 2.0.5
+ *
  */
 
 @SuppressWarnings("unused")