redsys-easy 5.1.0 → 5.2.0

package/lib/formatters/types.d.ts

@@ -186,31 +186,31 @@ export interface BaseFormatterOutput<RawOutputParams extends BaseOutputParams> {
     /**
      * @see {@link RestTrataPeticionOutputParams.Ds_SecurePayment}
      */
-    securePayment?: boolean | undefined;
+    securePayment?: boolean;
     /**
      * @see {@link RestTrataPeticionOutputParams.Ds_Card_Country}
      */
-    cardCountry?: Country | undefined;
+    cardCountry?: Country;
     /**
      * @see {@link RestTrataPeticionOutputParams.Ds_Card_Brand}
      */
-    cardBrand?: CardBrand | undefined;
+    cardBrand?: CardBrand;
     /**
      * @see {@link RestTrataPeticionOutputParams.Ds_Card_PSD2}
      */
-    cardPSD2?: boolean | undefined;
+    cardPSD2?: boolean;
     /**
      * @see {@link RestTrataPeticionOutputParams.Ds_MerchantData}
      */
-    merchantData?: string | undefined;
+    merchantData?: string;
     /**
      * @see {@link RestTrataPeticionOutputParams.Ds_AuthorisationCode}
      */
-    authorisationCode?: string | undefined;
+    authorisationCode?: string;
     /**
      * @see {@link RestTrataPeticionOutputParams.Ds_Card_Type}
      */
-    cardType?: BaseOutputParams['Ds_Card_Type'] | undefined;
+    cardType?: BaseOutputParams['Ds_Card_Type'];
     raw: RawOutputParams;
 }
 export interface ResolvedTransactionTraitFormatterOutput {
@@ -254,39 +254,39 @@ export interface NotificationFormatterOutput<RawOutputParams extends Notificatio
     /**
      * @see {@link RestNotificationOutputParams.Ds_ConsumerLanguage}
      */
-    lang?: Language | undefined;
+    lang?: Language;
 }
 export interface RequestFormatterOutput<RawOutputParams extends RequestOutputParams> extends BaseFormatterOutput<RawOutputParams> {
     /**
      * @see {@link RestTrataPeticionOutputParams.Ds_Merchant_Identifier}
      */
-    identifier?: string | undefined;
+    identifier?: string;
     /**
      * @see {@link RestTrataPeticionOutputParams.Ds_Card_Number}
      */
-    cardNumber?: string | undefined;
+    cardNumber?: string;
     /**
      * @see {@link RestTrataPeticionOutputParams.Ds_UrlPago2Fases}
      */
-    payURL?: string | undefined;
+    payURL?: string;
     /**
      * Card expiry year, YY
      *
      * @remarks
      * @see {@link RestTrataPeticionOutputParams.Ds_ExpiryDate}
      */
-    expiryYear?: string | undefined;
+    expiryYear?: string;
     /**
      * Card expiry month, MM
      *
      * @remarks
      * @see {@link RestTrataPeticionOutputParams.Ds_ExpiryDate}
      */
-    expiryMonth?: string | undefined;
+    expiryMonth?: string;
     /**
      * @see {@link RestTrataPeticionOutputParams.Ds_Language}
      */
-    lang?: Language | undefined;
+    lang?: Language;
 }
 /**
  * Ouput parameters for the REST iniciaPeticion output formatter
@@ -297,7 +297,7 @@ export interface RestIniciaPeticionFormatterOutput<RawOutputParams extends RestI
     /**
      * @see {@link RestIniciaPeticionOutputParams.Ds_EMV3DS}
      */
-    emv3ds?: RestIniciaPeticionOutputParams['Ds_EMV3DS'] | undefined;
+    emv3ds?: RestIniciaPeticionOutputParams['Ds_EMV3DS'];
 }
 /**
  * Ouput parameters for the REST trataPeticion output formatter
@@ -308,9 +308,9 @@ export interface RestTrataPeticionFormatterOutput<RawOutputParams extends RestTr
     /**
      * @see {@link RestTrataPeticionOutputParams.Ds_Response}
      */
-    response?: number | undefined;
+    response?: number;
     /**
      * @see {@link RestTrataPeticionOutputParams.Ds_EMV3DS}
      */
-    emv3ds?: RestTrataPeticionOutputParams['Ds_EMV3DS'] | undefined;
+    emv3ds?: RestTrataPeticionOutputParams['Ds_EMV3DS'];
 }

package/lib/index.esm.js

@@ -2081,6 +2081,16 @@ const assertSuccessfulResponse = (responseParams) => {
     }
 };
 const isStringNotEmpty = (str) => str != null && str.length > 0;
+/**
+ * Map over maybe monad
+ *
+ * If value is defined apply function and return output, otherwise return undefined.
+ */
+const mapMaybeMonad = (value, fn) => {
+    return value !== undefined
+        ? fn(value)
+        : undefined;
+};
 
 const sha256VerifyJSONResponse = (merchantKey, response, responseParams) => {
     if (response.Ds_SignatureVersion !== 'HMAC_SHA256_V1') {
@@ -3358,10 +3368,10 @@ const baseOutputFormatter = (raw) => {
             ? { securePayment: rawSecurePayment === '1' || rawSecurePayment === '2' }
             : undefined),
         ...(isStringNotEmpty(rawCardCountry)
-            ? { cardCountry: formatCountry(rawCardCountry) }
+            ? mapMaybeMonad(formatCountry(rawCardCountry), cardCountry => ({ cardCountry }))
             : undefined),
         ...(isStringNotEmpty(rawCardBrand)
-            ? { cardBrand: formatCardBrand(rawCardBrand) }
+            ? mapMaybeMonad(formatCardBrand(rawCardBrand), cardBrand => ({ cardBrand }))
             : undefined),
         ...(isStringNotEmpty(rawCardPSD2)
             ? { cardPSD2: rawCardPSD2 === 'Y' }
@@ -3399,7 +3409,7 @@ const notificationOutputFormatter = (raw) => {
         ...formatPrice(raw),
         response: formatResponse(rawResponse),
         ...(isStringNotEmpty(rawConsumerLanguage)
-            ? { lang: formatLang(rawConsumerLanguage) }
+            ? mapMaybeMonad(formatLang(rawConsumerLanguage), lang => ({ lang }))
             : undefined)
     };
 };
@@ -3451,7 +3461,9 @@ const requestOutputFormatter = (raw) => {
                 expiryMonth: rawExpiryDate.slice(2, 4)
             }
             : undefined),
-        ...(isStringNotEmpty(rawLang) ? { lang: formatLang(rawLang) } : undefined)
+        ...(isStringNotEmpty(rawLang)
+            ? mapMaybeMonad(formatLang(rawLang), lang => ({ lang }))
+            : undefined)
     };
 };
 /**

package/lib/index.js

@@ -2083,6 +2083,16 @@ const assertSuccessfulResponse = (responseParams) => {
     }
 };
 const isStringNotEmpty = (str) => str != null && str.length > 0;
+/**
+ * Map over maybe monad
+ *
+ * If value is defined apply function and return output, otherwise return undefined.
+ */
+const mapMaybeMonad = (value, fn) => {
+    return value !== undefined
+        ? fn(value)
+        : undefined;
+};
 
 const sha256VerifyJSONResponse = (merchantKey, response, responseParams) => {
     if (response.Ds_SignatureVersion !== 'HMAC_SHA256_V1') {
@@ -3360,10 +3370,10 @@ const baseOutputFormatter = (raw) => {
             ? { securePayment: rawSecurePayment === '1' || rawSecurePayment === '2' }
             : undefined),
         ...(isStringNotEmpty(rawCardCountry)
-            ? { cardCountry: formatCountry(rawCardCountry) }
+            ? mapMaybeMonad(formatCountry(rawCardCountry), cardCountry => ({ cardCountry }))
             : undefined),
         ...(isStringNotEmpty(rawCardBrand)
-            ? { cardBrand: formatCardBrand(rawCardBrand) }
+            ? mapMaybeMonad(formatCardBrand(rawCardBrand), cardBrand => ({ cardBrand }))
             : undefined),
         ...(isStringNotEmpty(rawCardPSD2)
             ? { cardPSD2: rawCardPSD2 === 'Y' }
@@ -3401,7 +3411,7 @@ const notificationOutputFormatter = (raw) => {
         ...formatPrice(raw),
         response: formatResponse(rawResponse),
         ...(isStringNotEmpty(rawConsumerLanguage)
-            ? { lang: formatLang(rawConsumerLanguage) }
+            ? mapMaybeMonad(formatLang(rawConsumerLanguage), lang => ({ lang }))
             : undefined)
     };
 };
@@ -3453,7 +3463,9 @@ const requestOutputFormatter = (raw) => {
                 expiryMonth: rawExpiryDate.slice(2, 4)
             }
             : undefined),
-        ...(isStringNotEmpty(rawLang) ? { lang: formatLang(rawLang) } : undefined)
+        ...(isStringNotEmpty(rawLang)
+            ? mapMaybeMonad(formatLang(rawLang), lang => ({ lang }))
+            : undefined)
     };
 };
 /**

package/lib/types/output-params.d.ts

@@ -17,41 +17,41 @@ export interface BaseOutputParams {
     /** Transaction type */
     Ds_TransactionType: TransactionType;
     /** Secure payment indicator */
-    Ds_SecurePayment?: '0' | '1' | '2' | undefined;
+    Ds_SecurePayment?: '0' | '1' | '2';
     /** Card country */
-    Ds_Card_Country?: CountryNum | undefined;
+    Ds_Card_Country?: CountryNum;
     /** Authorization transaction code, refunds */
-    Ds_AuthorisationCode?: string | undefined;
+    Ds_AuthorisationCode?: string;
     /** Card type */
-    Ds_Card_Type?: 'C' | 'D' | undefined;
+    Ds_Card_Type?: 'C' | 'D';
     /** Merchant data */
-    Ds_MerchantData?: string | undefined;
+    Ds_MerchantData?: string;
     /** Card brand */
-    Ds_Card_Brand?: CardBrandNum | undefined;
+    Ds_Card_Brand?: CardBrandNum;
     /** Card is under PSD2 */
-    Ds_Card_PSD2?: 'Y' | 'N' | undefined;
+    Ds_Card_PSD2?: 'Y' | 'N';
     /**
      * PDS2 exemptions
      *
      * @example
      * `'LWV;TRA[30.0];COR;MIT;ATD;WHL'`
      */
-    Ds_Excep_SCA?: string | undefined;
+    Ds_Excep_SCA?: string;
     /** Payment method number */
-    Ds_ProcessedPayMethod?: string | undefined;
+    Ds_ProcessedPayMethod?: string;
     /** Credential On File transaction identifier */
-    Ds_Merchant_Cof_Txnid?: string | undefined;
+    Ds_Merchant_Cof_Txnid?: string;
     /**
      * Card number with some digits replaced with asterisks
      * @deprecated
      */
-    Ds_CardNumber?: string | undefined;
+    Ds_CardNumber?: string;
     /** Card number with some digits replaced with asterisks */
-    Ds_Card_Number?: string | undefined;
+    Ds_Card_Number?: string;
     /** Card expiry date, YYmm */
-    Ds_ExpiryDate?: string | undefined;
+    Ds_ExpiryDate?: string;
     /** Stored payment method reference number */
-    Ds_Merchant_Identifier?: string | undefined;
+    Ds_Merchant_Identifier?: string;
 }
 /**
  * Common output parameters of resolved requests or notifications
@@ -74,9 +74,9 @@ export interface ResolvedTransactionTrait {
  */
 export interface RequestOutputParams extends BaseOutputParams {
     /** Payment link, paygold */
-    Ds_UrlPago2Fases?: string | undefined;
+    Ds_UrlPago2Fases?: string;
     /** Language */
-    Ds_Language?: LanguageNum | undefined;
+    Ds_Language?: LanguageNum;
 }
 /**
  * Output parameters of a IniciaPeticion HTTP request
@@ -85,7 +85,7 @@ export interface RequestOutputParams extends BaseOutputParams {
  */
 export interface RestIniciaPeticionOutputParams extends RequestOutputParams {
     /** EMV3DS data in json format */
-    Ds_EMV3DS?: ThreeDSv1PreAuthOutputParams | ThreeDSv2PreAuthOutputParams | undefined;
+    Ds_EMV3DS?: ThreeDSv1PreAuthOutputParams | ThreeDSv2PreAuthOutputParams;
     /** Dynamic Currency Conversion data, json */
     Ds_DCC?: {
         InfoMonedaTarjeta: {
@@ -112,7 +112,7 @@ export interface RestIniciaPeticionOutputParams extends RequestOutputParams {
             /** Amount, decimal number */
             importeCome: string;
         };
-    } | undefined;
+    };
 }
 /**
  * Output parameters of a TrataPeticion HTTP request
@@ -121,18 +121,18 @@ export interface RestIniciaPeticionOutputParams extends RequestOutputParams {
  */
 export interface RestTrataPeticionOutputParams extends RequestOutputParams, Omit<ResolvedTransactionTrait, 'Ds_Response'> {
     /** Response code */
-    Ds_Response?: ResolvedTransactionTrait['Ds_Response'] | undefined;
+    Ds_Response?: ResolvedTransactionTrait['Ds_Response'];
     /** EMV3DS data in json format */
-    Ds_EMV3DS?: ThreeDSv1ChallengeOutputParams | ThreeDSv2ChallengeOutputParams | undefined;
+    Ds_EMV3DS?: ThreeDSv1ChallengeOutputParams | ThreeDSv2ChallengeOutputParams;
 }
 /**
  * Common parameters for notifications
  */
 export interface NotificationOutputParams extends BaseOutputParams, ResolvedTransactionTrait {
     /** Language */
-    Ds_ConsumerLanguage?: LanguageNum | undefined;
+    Ds_ConsumerLanguage?: LanguageNum;
     /** Error code */
-    Ds_ErrorCode?: string | undefined;
+    Ds_ErrorCode?: string;
 }
 /**
  * Parameters of a redsys REST notification

package/lib/utils/misc.d.ts

@@ -28,3 +28,9 @@ export declare const assertSuccessfulResponse: (responseParams: {
     Ds_Response?: string | undefined;
 }) => void;
 export declare const isStringNotEmpty: <T extends string>(str: T | undefined) => str is T;
+/**
+ * Map over maybe monad
+ *
+ * If value is defined apply function and return output, otherwise return undefined.
+ */
+export declare const mapMaybeMonad: <V, Out>(value: V | undefined, fn: (value: V) => Out) => Out | undefined;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "redsys-easy",
   "description": "Node JS interface for Redsys payment gateway",
-  "version": "5.1.0",
+  "version": "5.2.0",
   "author": "Javier Garcia <javiertury@gmail.com>",
   "license": "MIT",
   "keywords": [