feat: add ProductType identifier for HSM C1 (#48)

Author: andrei-cristea

CHANGELOG.md

@@ -5,6 +5,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
+### Added
+- `CalypsoSam.ProductType.HSM_C1` identifier for HSM products.
 
 ## [1.2.0] - 2022-05-30
 ### Added

gradle.properties

@@ -1,7 +1,7 @@
 group = org.calypsonet.terminal
 title = Calypsonet Terminal Calypso API
 description = API defining the needed interfaces to manage Calypso cards
-version = 1.2.0
+version = 1.3.0
 
 javaSourceLevel = 1.6
 javaTargetLevel = 1.6

src/main/java/org/calypsonet/terminal/calypso/CalypsoApiProperties.java

@@ -23,7 +23,7 @@ public class CalypsoApiProperties {
    *
    * @since 1.0.0
    */
-  public static final String VERSION = "1.2";
+  public static final String VERSION = "1.3";
 
   /** Private constructor */
   private CalypsoApiProperties() {}

src/main/java/org/calypsonet/terminal/calypso/sam/CalypsoSam.java

@@ -106,6 +106,13 @@ enum ProductType {
      */
     SAM_C1,
 
+    /**
+     * SAM C1 HSM
+     *
+     * @since 1.3.0
+     */
+    HSM_C1,
+
     /**
      * SAM S1E1
      *

src/main/uml/api_class_diagram.puml

@@ -1,6 +1,6 @@
 @startuml
 title
-    Calypsonet - calypsonet-terminal-calypso-java-api - 1.2.+ (2022-05-05)
+    Calypsonet - calypsonet-terminal-calypso-java-api - 1.3.+ (2022-10-04)
 end title
 
 ' == THEME ==
@@ -264,6 +264,7 @@ package "org.calypsonet.terminal.calypso" as api {
         }
         +enum "ProductType" as SamProductType {
             SAM_C1
+            HSM_C1
             SAM_S1E1
             SAM_S1Dx
             CSAM_F
@@ -418,6 +419,21 @@ package "org.calypsonet.terminal.calypso" as api {
         }
         +interface SamSecuritySetting extends CommonSecuritySetting {
         }
+        ' Exceptions
+        +class "<<RuntimeException>>" as RuntimeException {
+            +**SessionBufferOverflowException**: Session buffer would overflow for atomic session.
+            +**UnauthorizedKeyException**
+            +**CardRevokedException**
+            +**SamRevokedException**
+            +**InconsistentDataException**: Number of R-APDUs != number of C-APDUs **or** data read in session != data read outside session.
+            +**InvalidSignatureException**: R-APDU of PSO Verify Signature = 6988.
+            +**InvalidCardSignatureException**: R-APDU of DigestAuthenticate = 6988 **or** R-APDU of SvCheck = 6988.
+            +**CardSignatureNotVerifiableException**: R-APDU of CloseSecureSession = 9000 but SAM is no more available.
+            +**UnexpectedCommandStatusException**
+            +**ReaderIOException**: Card reader and/or SAM reader communication is broken.
+            +**CardIOException**
+            +**SamIOException**
+        }
     }
 }